The Three-Layer Economy Stack

A Minecraft economy is built from three distinct plugin layers that each handle a separate responsibility. Understanding which layer does what prevents the common mistake of trying to make one plugin do everything.

  • Vault: the API bridge. Vault is not an economy plugin itself. It provides a standard interface that other plugins use to talk to the economy without caring which specific plugin is storing the data. Every shop plugin, jobs plugin, and claim plugin on the market talks to Vault rather than to a specific economy provider.
  • Economy provider: stores balances. EssentialsX is the most common choice because most servers already have it installed. CMI and PlayerPoints are alternatives. The economy provider registers itself with Vault on startup.
  • Shop plugin: lets players spend and earn money. ChestShop, ShopGUI+, and QuickShop are the main options. These talk to Vault to deduct and add balances when transactions happen.

Install all three layers and make sure Vault can find the economy provider before opening shops to players.

Installing Vault

Download Vault from SpigotMC. Upload the JAR to plugins/ and restart the server. Vault itself has no configuration. After it loads, check the console to confirm it says something like Vault loaded successfully. Vault will detect any registered economy provider automatically.

If Vault cannot find an economy provider after you install both plugins, the most common cause is that EssentialsX is not loaded or is showing an error. Fix any EssentialsX startup errors first, then verify Vault detects it with:

vault-info

This console command prints the current economy provider that Vault has registered. If it says "No economy plugin found", restart the server after ensuring both plugins are in the plugins/ folder.

EssentialsX Economy: Simple and Built In

If you already have EssentialsX installed, you already have an economy provider. EssentialsX's economy stores each player's balance in its data files. Configure the starting balance and currency name in plugins/Essentials/config.yml:

# Starting balance for new players
starting-balance: 500

# Currency symbol shown in balance messages
currency-symbol: '$'

# Full name of the currency (singular and plural)
currency-symbol-suffix: false
# Example: /balance shows "$500.00"

EssentialsX also provides /baltop which shows a leaderboard of the richest players. This can be a useful engagement feature for competitive servers. The balance data is stored in plugins/Essentials/userdata/ with one file per player UUID.

Player Shops with ChestShop or ShopGUI+

Player shops are where the economy comes alive. ChestShop is the simpler option: players place a chest, put a sign on it with a specific format, and anyone who right-clicks the sign can buy or sell items. The sign format is:

Line 1: PlayerName (auto-filled)
Line 2: Amount (e.g. 10)
Line 3: B [price] : S [price] (e.g. B 50 : S 25)
Line 4: Item name or ID (e.g. DIAMOND)

ShopGUI+ uses a menu-based GUI instead of physical chests. Admins configure a YAML file listing all available items, their buy and sell prices, and the shop categories. Players open the shop with a command and click items to trade. ShopGUI+ is easier for new players to use but requires more admin setup up front. For admin-run server shops (where the server itself is buying and selling rather than players), ShopGUI+ is the cleaner choice.

Admin Commands for Managing Balances

EssentialsX provides a full set of economy admin commands. These require op or the relevant permission node:

/balance [player]           - Check a player's balance
/baltop                     - Show top balances
/eco give PlayerName 1000   - Give a player money
/eco take PlayerName 500    - Remove money from a player
/eco set PlayerName 0       - Set a player's balance to an exact amount
/eco reset PlayerName       - Reset to starting balance
/pay PlayerName 100         - Transfer money to another player

The /eco give and /eco take commands are useful for rewarding players for events, resolving disputes, or correcting shop errors. All transactions are logged in the EssentialsX data files, though for a proper audit log on a larger server you may want a logging plugin like CoreProtect or a dedicated economy log plugin.

Economy Balancing Tips

A broken economy is worse than no economy. Too much money inflates prices until nothing is worth buying; too little starves players and kills the market. Here are the key levers to tune:

Set a modest starting balance. Five hundred to one thousand currency units is enough to make first purchases without handing players so much they never need to earn more. Configure the sell prices for common resources (cobblestone, wood, crops) to be low so players cannot get rich instantly by mining. Buy prices should be higher than sell prices to prevent exploiting a price gap.

Add money sinks: things players regularly spend money on that remove currency from the economy permanently. Common examples are kit cooldown bypasses, teleportation fees (set teleport-cooldown to charge a small fee), land claim costs, and cosmetic shops. Without sinks, inflation is inevitable as more currency enters the economy from farming and admin events than leaves it through player-to-player transfers alone.

Monitor /baltop periodically. If the top player has a hundred times more money than the median player, the economy is diverging. Use /eco take judiciously or introduce a tax mechanic via a plugin like Towny to redistribute wealth automatically.