# EzEconomy<\/p>\n
<\/p>\n
**EzEconomy** \u2013 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.<\/p>\n
<\/p>\n
**Available languages**: English, Espa\u00f1ol, Nederlands, \u4e2d\u56fd\u4eba, Fran\u00e7ais<\/p>\n
\n<\/p>\n
—<\/p>\n
## \u2605 Our key economy features<\/p>\n
EzEconomy is built for performance, flexibility, and ease of use. Highlights include:<\/p>\n
– **Vault API compatible**: Works with any Vault-based plugin
\n– **YML, MySQL, SQLite, MongoDB, or custom storage**: Flexible, production-ready storage options
\n– **Thread-safe**: Robust error handling and concurrency
\n– **Multi-currency support**: Optional, per-player, fully configurable
\n– **Async caching**: Optimized for large servers
\n– **Comprehensive commands**: `\/balance`, `\/eco`, `\/baltop`, `\/bank`, `\/pay`, `\/currency`
\n– **Granular permissions**: Per-command and per-bank action<\/p>\n
—<\/p>\n
## \u26a1 Commands<\/p>\n
– **\/balance**: View your balance —<\/p>\n ## \ud83d\udee1\ufe0f Permissions<\/p>\n – `ezeconomy.balance.others`: View other players’ balances – **Bank Permissions**: —<\/p>\n ## \u2699\ufe0f Configuration Example<\/p>\n ### `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): —<\/p>\n ## \u2b07\ufe0f Installation<\/p>\n 1. Place `EzEconomy.jar` in your plugins folder —<\/p>\n ## \ud83d\udd17 Integration<\/p>\n – EzEconomy automatically registers as a Vault provider —<\/p>\n ## \ud83d\udee0\ufe0f Developer: Custom Storage Providers<\/p>\n EzEconomy supports custom storage backends (YML, MySQL, SQLite, MongoDB, or your own)! You can implement your own provider for any database or storage system.<\/p>\n **How to add a custom provider:**<\/p>\n 1. Implement the `StorageProvider` interface in your plugin or module. This allows you to use SQLite, MongoDB, Redis, or any other system for player balances and banks!<\/p>\n —<\/p>\n ## \u2753 Support<\/p>\n – For help, join our community Discord<\/p>\n —<\/p>\n ## \ud83d\udd17 Related Plugins<\/p>\n – \u2b50 EzAuction: Buy Orders, Advanced GUI, Show Shop Price <\/p>\n","protected":false},"excerpt":{"rendered":" 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.<\/p>\n","protected":false},"featured_media":67580,"template":"","meta":{"_minecraft_slug":"ezeconomy","_minecraft_project_id":"rQtkf57Y","_minecraft_author":"Shadow48402","_minecraft_license":"MIT","_minecraft_downloads":2551,"_minecraft_follows":7,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"ezeconomy.zip","_minecraft_size_bytes":102794219,"_minecraft_version_count":58,"_minecraft_updated_at":"2026-05-16T05:44:17.442145Z","_minecraft_date_created":"2026-01-13T21:06:07.220442Z","_minecraft_date_modified":"2026-05-16T06:28:41.807109Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/ezeconomy","_minecraft_icon_attachment_id":67580,"_minecraft_imported_at":"2026-06-03T20:42:14+00:00","_minecraft_import_hash":"cd9d3fb71eb3ff839bb32592beb2a89b","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,844,125,89,873,127,128,129,123],"mod_loader":[130,131,132,133,134],"minecraft_version":[339,340,341,357,359,360,379,382,385,438,446,449,110,111,112,113,114,115,116,117,118,119,120,46,47,48,49,50,51,52,53,54,55,56,57,58,59,36,60,93,94,101,102,62,37,40,41,73,74,38,78,79,80,81,82,21,13,14,15,16,17,18,19,20,22,23,24,25,26,27,28,29,30,31,860,861,862,863,864,83,167,163],"class_list":["post-67579","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-bukkit","mod_category-economy","mod_category-folia","mod_category-game-mechanics","mod_category-library","mod_category-paper","mod_category-purpur","mod_category-spigot","mod_category-technology","mod_loader-bukkit","mod_loader-folia","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","minecraft_version-1-10","minecraft_version-1-10-1","minecraft_version-1-10-2","minecraft_version-1-11","minecraft_version-1-11-1","minecraft_version-1-11-2","minecraft_version-1-12","minecraft_version-1-12-1","minecraft_version-1-12-2","minecraft_version-1-13","minecraft_version-1-13-1","minecraft_version-1-13-2","minecraft_version-1-14","minecraft_version-1-14-1","minecraft_version-1-14-2","minecraft_version-1-14-3","minecraft_version-1-14-4","minecraft_version-1-15","minecraft_version-1-15-1","minecraft_version-1-15-2","minecraft_version-1-16","minecraft_version-1-16-1","minecraft_version-1-16-2","minecraft_version-1-16-3","minecraft_version-1-16-4","minecraft_version-1-16-5","minecraft_version-1-17","minecraft_version-1-17-1","minecraft_version-1-18","minecraft_version-1-18-1","minecraft_version-1-18-2","minecraft_version-1-19","minecraft_version-1-19-1","minecraft_version-1-19-2","minecraft_version-1-19-3","minecraft_version-1-19-4","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9","minecraft_version-1-7-10","minecraft_version-1-7-2","minecraft_version-1-7-3","minecraft_version-1-7-4","minecraft_version-1-7-5","minecraft_version-1-7-6","minecraft_version-1-7-7","minecraft_version-1-7-8","minecraft_version-1-7-9","minecraft_version-1-8","minecraft_version-1-8-1","minecraft_version-1-8-2","minecraft_version-1-8-3","minecraft_version-1-8-4","minecraft_version-1-8-5","minecraft_version-1-8-6","minecraft_version-1-8-7","minecraft_version-1-8-8","minecraft_version-1-8-9","minecraft_version-1-9","minecraft_version-1-9-1","minecraft_version-1-9-2","minecraft_version-1-9-3","minecraft_version-1-9-4","minecraft_version-26-1","minecraft_version-26-1-1","minecraft_version-26-1-2"],"yoast_head":"\n
\n– **\/balance
\n– **\/eco
\n– **\/eco gui**: Show balance GUI
\n– **\/baltop [amount]**: Show top balances
\n– **\/bank
\n– **\/pay
\n– **\/currency [currency]**: Set or view your preferred currency (`ezeconomy.currency`)
\n– **\/ezeconomy cleanup**: Remove orphaned player data (`ezeconomy.admin`)
\n– **\/ezeconomy daily reset**: Reset all daily rewards (`ezeconomy.admin`)
\n– **\/ezeconomy reload**: Reload plugin configuration (`ezeconomy.admin`)
\n– **\/ezeconomy reload messages**: Reload only the message file (`ezeconomy.admin`)
\n– **\/ezeconomy database info**: Show database connection info (`ezeconomy.admin`)
\n– **\/ezeconomy database test**: Test the database connection (`ezeconomy.admin`)
\n– **\/ezeconomy database reset**: Reset all database tables (DANGEROUS) (`ezeconomy.admin`)
\n– **\/tax**: Removed \u2014 tax functionality moved to EzTax (https:\/\/modrinth.com\/plugin\/eztax)<\/p>\n
\n– `ezeconomy.eco`: Use \/eco admin command
\n– `ezeconomy.pay`: Use \/pay command
\n– `ezeconomy.currency`: Use \/currency command
\n– `ezeconomy.admin`: Use \/ezeconomy admin commands (cleanup, reload, database, daily reset)<\/p>\n
\n – `ezeconomy.bank.create`: Create a new bank
\n – `ezeconomy.bank.delete`: Delete a bank
\n – `ezeconomy.bank.balance`: View bank balance
\n – `ezeconomy.bank.deposit`: Deposit to a bank
\n – `ezeconomy.bank.withdraw`: Withdraw from a bank
\n – `ezeconomy.bank.addmember`: Add a member to a bank
\n – `ezeconomy.bank.removemember`: Remove a member from a bank
\n – `ezeconomy.bank.info`: View bank info
\n – `ezeconomy.bank.admin`: All bank admin actions<\/p>\n
\n“`yaml
\nstorage: yml
\nmulti-currency:
\n enabled: false
\n default: “dollar”
\n currencies:
\n dollar:
\n display: “Dollar”
\n symbol: “$”
\n decimals: 2
\n euro:
\n display: “Euro”
\n symbol: “\u20ac”
\n decimals: 2
\n # Tax configuration has been removed from EzEconomy and moved to EzTax.
\n # EzTax on Modrinth: https:\/\/modrinth.com\/plugin\/eztax
\n conversion:
\n dollar:
\n euro: 0.95
\n gem: 0.01
\n euro:
\n dollar: 1.05
\n gem: 0.012
\n gem:
\n dollar: 100
\n euro: 80
\n“`<\/p>\n
\n“`yaml
\nyml:
\n file: balances.yml
\n per-player-file-naming: uuid
\n data-folder: data
\n“`<\/p>\n
\n“`yaml
\nmysql:
\n host: localhost
\n port: 3306
\n database: ezeconomy
\n username: root
\n password: password
\n table: balances
\n“`<\/p>\n
\n“`yaml
\nsqlite:
\n file: ezeconomy.db
\n table: balances
\n banksTable: banks
\n“`<\/p>\n
\n“`yaml
\nmongodb:
\n uri: mongodb:\/\/localhost:27017
\n database: ezeconomy
\n collection: balances
\n banksCollection: banks
\n“`<\/p>\n
\n2. Configure `config.yml` and the appropriate `config-*.yml` file for your storage type
\n3. Restart your server<\/p>\n
\n– No extra setup required for Vault-compatible plugins
\n– **PlaceholderAPI support**:
\n – Use placeholders in chat, scoreboard, and other plugins:
\n – `%ezeconomy_balance%` \u2013 Your balance
\n – `%ezeconomy_balance_
\n – `%ezeconomy_bank_
\n – `%ezeconomy_top_1%` \u2013 Top 1 player balance (replace 1 with rank)
\n – `%ezeconomy_currency%` \u2013 Your preferred currency
\n – Works with all PlaceholderAPI-compatible plugins<\/p>\n
\n2. Register your provider before EzEconomy loads:
\n “`java
\n EzEconomy.registerStorageProvider(new YourProvider(…));
\n “`
\n3. Only one provider can be registered. If set, EzEconomy will use it instead of YML\/MySQL.
\n4. See the [full StorageProvider reference](..\/api\/storage-provider.md) for required methods and implementation details.<\/p>\n
\n– \u26a0\ufe0f EzShops: Dynamic Shops GUI, Player Shops, Sell Hand\/Inv<\/p>\n