EzEconomy Plugin za Minecraft 1.20.1, 1.21.1

EzEconomy is a modern, fast, and flexible Vault economy provider for Minecraft servers. Supports YML, MySQL, SQLite, MongoDB, and custom storage. Multi-currency, async caching, and robust permissions for any server size. Proven to be to 50x faster then other populair economy plugins.

Available languages: English, Español, Nederlands, 中国人, Français

★ Our key economy features

EzEconomy is built for performance, flexibility, and ease of use. Highlights include:

• Vault API compatible: Works with any Vault-based plugin
• YML, MySQL, SQLite, MongoDB, or custom storage: Flexible, production-ready storage options
• Thread-safe: Robust error handling and concurrency
• Multi-currency support: Optional, per-player, fully configurable
• Async caching: Optimized for large servers
• Comprehensive commands: /balance, /eco, /baltop, /bank, /pay, /currency
• Granular permissions: Per-command and per-bank action

⚡ Commands

• /balance: View your balance
• /balance : View another player's balance (ezeconomy.balance.others)
• /eco : Admin control (ezeconomy.eco)
• /eco gui: Show balance GUI
• /baltop [amount]: Show top balances
• /bank ...: Bank management (ezeconomy.bank.*)
• /pay : Pay another player (ezeconomy.pay)
• /currency [currency]: Set or view your preferred currency (ezeconomy.currency)
• /ezeconomy cleanup: Remove orphaned player data (ezeconomy.admin)
• /ezeconomy daily reset: Reset all daily rewards (ezeconomy.admin)
• /ezeconomy reload: Reload plugin configuration (ezeconomy.admin)
• /ezeconomy reload messages: Reload only the message file (ezeconomy.admin)
• /ezeconomy database info: Show database connection info (ezeconomy.admin)
• /ezeconomy database test: Test the database connection (ezeconomy.admin)
• /ezeconomy database reset: Reset all database tables (DANGEROUS) (ezeconomy.admin)
• /tax: Removed — tax functionality moved to EzTax (https://modrinth.com/plugin/eztax)

🛡️ Permissions

• ezeconomy.balance.others: View other players' balances
• ezeconomy.eco: Use /eco admin command
• ezeconomy.pay: Use /pay command
• ezeconomy.currency: Use /currency command
• ezeconomy.admin: Use /ezeconomy admin commands (cleanup, reload, database, daily reset)

• Bank Permissions:
• ezeconomy.bank.create: Create a new bank
• ezeconomy.bank.delete: Delete a bank
• ezeconomy.bank.balance: View bank balance
• ezeconomy.bank.deposit: Deposit to a bank
• ezeconomy.bank.withdraw: Withdraw from a bank
• ezeconomy.bank.addmember: Add a member to a bank
• ezeconomy.bank.removemember: Remove a member from a bank
• ezeconomy.bank.info: View bank info
• ezeconomy.bank.admin: All bank admin actions

⚙️ Configuration Example

config.yml (Only global settings):

storage: yml multi-currency: enabled: false default: "dollar" currencies: dollar: display: "Dollar" symbol: "$" decimals: 2 euro: display: "Euro" symbol: "€" decimals: 2

Tax configuration has been removed from EzEconomy and moved to EzTax.

EzTax on Modrinth: https://modrinth.com/plugin/eztax

conversion: dollar: euro: 0.95 gem: 0.01 euro: dollar: 1.05 gem: 0.012 gem: dollar: 100 euro: 80

config-yml.yml (YML storage settings):

yml: file: balances.yml per-player-file-naming: uuid data-folder: data

config-mysql.yml (MySQL storage settings):

mysql: host: localhost port: 3306 database: ezeconomy username: root password: password table: balances

config-sqlite.yml (SQLite storage settings):

sqlite: file: ezeconomy.db table: balances banksTable: banks

config-mongodb.yml (MongoDB storage settings):

mongodb: uri: mongodb://localhost:27017 database: ezeconomy collection: balances banksCollection: banks

⬇️ Installation

• Place EzEconomy.jar in your plugins folder
• Configure config.yml and the appropriate config-*.yml file for your storage type
• Restart your server

🔗 Integration

• EzEconomy automatically registers as a Vault provider
• No extra setup required for Vault-compatible plugins
• PlaceholderAPI support:
• Use placeholders in chat, scoreboard, and other plugins:
• %ezeconomy_balance% – Your balance
• %ezeconomy_balance_% – Your balance in a specific currency (e.g., %ezeconomy_balance_euro%)
• %ezeconomy_bank_% – Balance of a specific bank
• %ezeconomy_top_1% – Top 1 player balance (replace 1 with rank)
• %ezeconomy_currency% – Your preferred currency
• Works with all PlaceholderAPI-compatible plugins

🛠️ Developer: Custom Storage Providers

EzEconomy supports custom storage backends (YML, MySQL, SQLite, MongoDB, or your own)! You can implement your own provider for any database or storage system.

How to add a custom provider:

• Implement the StorageProvider interface in your plugin or module.
• Register your provider before EzEconomy loads:

EzEconomy.registerStorageProvider(new YourProvider(...));

• Only one provider can be registered. If set, EzEconomy will use it instead of YML/MySQL.
• See the full StorageProvider reference for required methods and implementation details.

This allows you to use SQLite, MongoDB, Redis, or any other system for player balances and banks!

Performance benchmark

Economy Benchmark Summary

Plugin - Version - Storage - Redis - Status - Run time (s) - Deposit avg (ms) - Withdraw avg (ms) - Balance/Has avg (ms) - RAM avg (MiB) - RAM peak (MiB) - ? vs EzEconomy baseline

essentialsx - 2.21.1 - file - off - ok - 1.021 - 0.483072 - 0.276326 - 0.005248 - 465.76 - 466.50 - N/A ezeconomy - 3.1.2 - mysql - off - ok - 0.090 - 0.008794 - 0.007697 - 0.004436 - 415.20 - 415.50 - 1.00x deposit ezeconomy - 3.1.2 - mysql - on - ok - 0.098 - 0.012991 - 0.008751 - 0.004505 - 405.67 - 406.02 - 1.48x deposit ezeconomy - 3.1.2 - sqlite - off - ok - 0.034 - 0.008090 - 0.003718 - 0.003299 - 420.58 - 420.78 - 1.00x deposit ezeconomy - 3.1.2 - sqlite - on - ok - 0.036 - 0.007114 - 0.004541 - 0.003127 - 447.34 - 447.37 - 0.88x deposit xconomy - 2.26.3 - mysql - off - ok - 0.547 - 0.164429 - 0.129993 - 0.191681 - 465.28 - 467.52 - 18.70x deposit xconomy - 2.26.3 - sqlite - off - ok - 0.290 - 0.109194 - 0.061594 - 0.080283 - 428.20 - 430.39 - 13.50x deposit

Bank Operation Benchmarks

Plugin - Version - Storage - Redis - Status - Run time (s) - BankDeposit avg (ms) - BankWithdraw avg (ms) - BankBalance/Has avg (ms) - RAM avg (MiB) - RAM peak (MiB)

essentialsx - 2.21.1 - file - off - skipped (Vault bank API not supported by this economy provider) - N/A - N/A - N/A - N/A - N/A - N/A ezeconomy - 3.1.2 - mysql - off - ok - 3.330 - 1.225967 - 1.153788 - 0.567417 - 449.95 - 458.75 ezeconomy - 3.1.2 - mysql - on - ok - 3.090 - 1.122824 - 1.078041 - 0.516253 - 440.06 - 448.27 ezeconomy - 3.1.2 - sqlite - off - ok - 2.126 - 0.960253 - 0.838308 - 0.061351 - 463.86 - 469.28 ezeconomy - 3.1.2 - sqlite - on - ok - 1.864 - 0.827309 - 0.747836 - 0.064934 - 490.66 - 496.37 xconomy - 2.26.3 - mysql - off - skipped (Vault bank API not supported by this economy provider) - N/A - N/A - N/A - N/A - N/A - N/A xconomy - 2.26.3 - sqlite - off - skipped (Vault bank API not supported by this economy provider) - N/A - N/A - N/A - N/A - N/A - N/A

❓ Support

• For help, join our community Discord

🔗 Related Plugins

• ⭐ EzAuction: Buy Orders, Advanced GUI, Show Shop Price
• ⚠️ EzShops: Dynamic Shops GUI, Player Shops, Sell Hand/Inv