Obfeco

Obfeco is a powerful, modern, multi-currency economy solution for Minecraft servers. Create unlimited currencies, manage them through an intuitive GUI, and enjoy seamless integration with your favorite plugins.

✨ Key Features

• Unlimited Currencies: Create as many currencies as you need (Gems, Coins, Souls, etc.).
• Intuitive GUI: Manage all your currencies and view leaderboards through an easy-to-use interface.
• Large Number Formatting: Automatically formats balances (e.g., 1k, 5M, 2B, 10T) to keep values readable.
• Robust Storage: Choose between SQLite, or MySQL for high-performance data handling.
• PlaceholderAPI Support: Display balances, total economy values, and leaderboards anywhere.
• Vault Integration: Fully compatible with plugins that use Vault (requires a primary currency to be set).
• Admin Tools: Comprehensive tools for giving, taking, setting, and resetting balances.
• Easy Migration: Built-in tools to migrate from other economy plugins like CoinsEngine.

🚀 Getting Started

1. Download the latest Obfeco.jar.
2. Drop the jar file into your server's plugins folder.
3. (Highly Recommended) Install Vault and PlaceholderAPI.
4. Restart your server.
5. Configure your primary currency in config.yml (especially for Vault support).

🛠 Commands & Permissions

The main command is /obfeco, with aliases /eco and /economy. All commands require the basic obfeco.use permission.

User Commands

Command	Description	Permission
/obfeco balance [currency]	Check your balance (primary if not specified)	obfeco.balance
/obfeco balance <player> <currency>	Check another player's balance	obfeco.balance.others
/obfeco pay <player> <currency> <amount>	Pay another player	obfeco.pay
/obfeco top <currency> [page]	View the leaderboard (GUI/Chat)	obfeco.top / obfeco.top.gui

Admin Commands

The obfeco.admin permission grants access to all admin commands below.

Command	Description	Permission
/obfeco gui	Open the Currency Manager GUI (alias /obfeco manage)	obfeco.gui
/obfeco create <id> <name> [start] [decimals]	Create a new currency	obfeco.create
/obfeco delete <currency>	Permanently delete a currency	obfeco.delete
/obfeco give <player> <currency> <amount> [-s]	Give currency to a player	obfeco.give
/obfeco take <player> <currency> <amount> [-s]	Take currency from a player	obfeco.take
/obfeco set <player> <currency> <amount> [-s]	Set a player's balance	obfeco.set
/obfeco reset <currency> [confirm]	Reset ALL player data for a currency	obfeco.reset
/obfeco scan <plugin> [debug]	Scan for currencies to migrate (e.g., coinsengine)	obfeco.admin
/obfeco convert <plugin> [debug]	Migrate data (e.g., coinsengine)	obfeco.convert
/obfeco reload	Reload the plugin configuration	obfeco.reload

Note: Use -s (requires obfeco.silent) in admin commands to perform the action silently (no notification to the target).

📊 Placeholders

Obfeco provides a simple and powerful placeholder system. Replace <currency> with your currency ID (e.g., coins).

👤 Player Balances

Placeholder	Description
%obfeco_<currency>_balance%	Player's formatted balance (e.g., 1,500.50)
%obfeco_<currency>_raw%	Player's raw numeric balance (e.g., 1500.5)
%obfeco_<currency>_symbol%	The currency's symbol (e.g., $)
%obfeco_<currency>_name%	The currency's display name

Tip: You can also use %obfeco_balance_<currency>% or %obfeco_amount_<currency>%.

🏆 Leaderboards (Top Balances)

Placeholder	Description
%obfeco_<currency>_top_name_<pos>%	Name of the player at position (1, 2, 3...)
%obfeco_<currency>_top_balance_<pos>%	Formatted balance at position
%obfeco_top_<pos>_<currency>%	Quickest way to get formatted balance
%obfeco_<currency>_top_raw_<pos>%	Raw balance at position

Examples:

• %obfeco_coins_top_name_1% → Name of the richest player.
• %obfeco_top_1_coins% → Formatted balance of the richest player.
• %obfeco_coins_top_raw_1% → Raw balance of the richest player.

🌍 Global Economy Info

Placeholder	Description
%obfeco_<currency>_total_balance%	Total amount of this currency in the economy (formatted)
%obfeco_<currency>_total_raw%	Total amount of this currency (raw)

---

Note: The system is very flexible and supports many aliases (like amount for balance) and different orders, but the ones above are recommended for consistency.

📦 Storage Options

Obfeco supports multiple storage types, configurable in config.yml:

• SQLite (Default): Efficient local database, recommended for most servers.
• MySQL: High-performance remote database, ideal for networks and large servers.

🔄 Migration

Switching from CoinsEngine? It's easy:

1. Run /obfeco scan coinsengine to see what can be migrated.
2. Run /obfeco convert coinsengine to migrate all currencies and player balances.

⚙️ Configuration

Obfeco allows fine-tuning through config.yml. Key options include:

• Storage: Switch between SQLITE and MYSQL.
• Logging: Control console output and file logging. Use console: false to silence the console.
• Formatting: Customize how large numbers are displayed (e.g., using k, M, B suffixes).
• Vault: Define the primary-currency that Vault-based plugins will use.
• Caching: Adjust cache intervals and auto-save settings for optimal performance.

🆘 Support

Need help? Join our community:

• Discord: BusyBee Support