Minecraft Vault Economy Guide
Set up Vault on your Minecraft server, hook in an economy provider, and connect plugins like ShopGUIPlus and Jobs Reborn.
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 SteveIf 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.