Minecraft Vault Economy Guide

Vault is the abstraction layer almost every Minecraft economy plugin reads from. It doesn't store money itself , it lets every plugin agree on a common API. This guide covers what Vault does, what it doesn't, and how to wire it up.

1. What Vault is (and isn't)

Vault is a bridge:

• Plugin A (e.g. EssentialsX) provides an economy.
• Plugin B (e.g. ShopGUIPlus) consumes the economy via Vault.
• Vault routes the calls.

You install Vault. You also install one economy provider (EssentialsX, CMI, TheNewEconomy, MiConomy). Two providers = chaos.

2. Install

Download Vault from SpigotMC. Drop into plugins/. Restart. Check /vault-info , it should show your provider.

3. Choose a provider

Provider	Notes
EssentialsX Economy	Free, simplest, file-backed. Good default.
CMI	Paid, MySQL, multiple currencies.
TheNewEconomy	Free, supports multi-currency natively.

4. Verify the bridge

/eco give Steve 100
/balance Steve

If both work, Vault is wired correctly. /vault-info should print:

Economy: Essentials Economy [Hooked]
Permissions: LuckPerms [Hooked]

5. Hooking other plugins

You don't usually configure anything , ShopGUIPlus, AuctionHouse, Jobs Reborn, ChestShop and dozens more auto-detect Vault and the active provider. Check each plugin's startup log for "Hooked into Vault". See the economy plugin overview for the standard stack.

6. Multi-currency

Vault is single-currency only by default. For coins + gems + tokens:

• Use TheNewEconomy as your provider (multi-currency built in).
• Or run a secondary plugin like TokenManager for the second currency , doesn't go through Vault.

7. Common pitfalls

• Two economy plugins both registering with Vault , one wins and the other silently breaks.
• Updating Vault to a 1.7-only build on a 1.21 server , always grab the latest.
• Plugin hook fails because Vault loaded after the consumer , restart, don't /reload.

Want to see all this in action? Astroworld MC runs a custom-built economy survival server with custom bosses, eternal enchants, crates and an auction house. Join at astroworldmc.com , IP play.astroworldmc.com, Java + Bedrock crossplay.