EzEconomy

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.

EzEconomy Icon

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 <player>: View another player's balance (ezeconomy.balance.others)
/eco <give|take|set> <player> <amount>: Admin control (ezeconomy.eco)
/eco gui: Show balance GUI
/baltop [amount]: Show top balances
/bank <create|delete|balance|deposit|withdraw|addmember|removemember|info> ...: Bank management (ezeconomy.bank.*)
/pay <player> <amount>: 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_<currency>% – Your balance in a specific currency (e.g., %ezeconomy_balance_euro%)
  - %ezeconomy_bank_<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.

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

Compatibility

Minecraft: Java Edition

Platforms

Links

Tags

Creators

Details

★ Our key economy features

⚡ Commands

🛡️ Permissions

⚙️ Configuration Example

`config.yml` (Only global settings):

`config-yml.yml` (YML storage settings):

`config-mysql.yml` (MySQL storage settings):

`config-sqlite.yml` (SQLite storage settings):

`config-mongodb.yml` (MongoDB storage settings):

⬇️ Installation

🔗 Integration

🛠️ Developer: Custom Storage Providers

Performance benchmark

Economy Benchmark Summary

Bank Operation Benchmarks

❓ Support

🔗 Related Plugins

EzEconomy

Compatibility

Minecraft: Java Edition

Platforms

Links

Tags

Creators

Details

★ Our key economy features

⚡ Commands

🛡️ Permissions

⚙️ Configuration Example

config.yml (Only global settings):

config-yml.yml (YML storage settings):

config-mysql.yml (MySQL storage settings):

config-sqlite.yml (SQLite storage settings):

config-mongodb.yml (MongoDB storage settings):

⬇️ Installation

🔗 Integration

🛠️ Developer: Custom Storage Providers

Performance benchmark

Economy Benchmark Summary

Bank Operation Benchmarks

❓ Support

🔗 Related Plugins

`config.yml` (Only global settings):

`config-yml.yml` (YML storage settings):

`config-mysql.yml` (MySQL storage settings):

`config-sqlite.yml` (SQLite storage settings):

`config-mongodb.yml` (MongoDB storage settings):