Introduction

Obfeco is a multi-currency economy plugin for Paper, Purpur and Folia servers. Create as many currencies as you need (coins, gems, tokens, souls), manage them from an in-game GUI, hand one of them to Vault for every shop and job plugin on the server, and show balances and leaderboards anywhere through PlaceholderAPI.

What's in this guide

  • Getting Started — install the plugin and create your first currency in a few minutes.
  • Core Reference — every command, permission node, and the Currency Manager GUI.
  • Features & Modules — currencies, categories, leaderboards and transaction logging.
  • Configuration — config.yml, messages.yml and database setup.
  • Integrations — Vault, PlaceholderAPI and the developer API.
  • Advanced Optimization — caching and saving, Folia specifics, migrating from CoinsEngine, and troubleshooting.
  • Support — FAQ, common issues, and how to get help.

Key features

  • Unlimited currencies, each in its own YAML file with its own name, symbol, format, starting balance and decimal setting.
  • Currency Manager GUI to create, edit and delete currencies in-game, no file editing needed.
  • Categories and subcategories to keep a long currency list tidy, mirrored as folders on disk.
  • Large number formatting (1.50k, 2.00M, 3B) with suffixes you can rename.
  • SQLite, MySQL or YAML storage, with balances cached in memory and saved in batches.
  • Vault economy provider for one primary currency, plus a full PlaceholderAPI expansion for all of them.
  • CoinsEngine migration that brings over currencies and player balances in two commands.
  • Native Folia support through Paper's region schedulers.

Quick links

Ready to go? Start with the Quick Start guide.