Vault, Multiple Economy Plugins Compatibility

How Vault Handles Economy Providers

Vault is an API bridge, not an economy plugin itself. It detects economy plugins at startup and registers them as providers. When another plugin (like ChestShop or ShopGUI+) asks Vault for a balance check or money transfer, Vault forwards that request to whichever economy provider is currently active. The problem with vault multiple economy plugins arises when two or more providers register simultaneously and Vault must pick one.

This is not a rare scenario. Many servers run EssentialsX Economy as their primary money system but also install a plugin like TokenManager for a secondary currency, or use CMI which includes its own economy module. If both register with Vault, one wins and the other gets silently ignored, which breaks any plugin that expected the losing provider.

Checking Your Current Provider

Run /vault-info economy in-game or check your server startup log for lines like:

[Vault] [Economy] EssentialsX Economy found: Loaded
[Vault] [Economy] CMI Economy found: Loaded
[Vault] [Economy] Selecting economy provider: EssentialsX Economy

If you see multiple "found" lines, Vault detected more than one provider. The "Selecting" line tells you which one won. If this is not the provider you want, you need to configure priorities or disable the unwanted one.

Resolving Provider Conflicts

The cleanest approach to vault multiple economy plugins conflicts is to disable the economy module in whichever plugin you do not want as the primary provider:

Disabling CMI Economy

# plugins/CMI/config.yml
Economy:
  Enabled: false

Disabling EssentialsX Economy

If you prefer CMI as your economy, remove or rename the Essentials jar that provides economy, or disable the economy feature in EssentialsX config:

# plugins/Essentials/config.yml
disabled-commands:
  - economy

However, EssentialsX does not have a clean toggle for its economy module separate from the rest of the plugin. The reliable method is to ensure CMI loads before Essentials by adjusting plugin load order, or to remove EssentialsX and use CMI for both utility commands and economy.

Running Dual Currencies Intentionally

Some servers genuinely need vault multiple economy plugins running in parallel: one for coins and one for tokens or gems. In this case, you are not trying to fix a conflict but rather to route different plugins to different providers.

Vault itself only supports one active economy provider at a time. To run dual currencies, you need a plugin designed for it:

• TokenManager: Provides a separate token currency that does not go through Vault. Plugins reference TokenManager's API directly.
• PlayerPoints: Similar to TokenManager, runs a points currency independent of Vault.
• Multi-Currency plugins: Some economy plugins like GemsEconomy support multiple currencies natively, all routed through a single Vault hook.

The key insight is that your secondary currency should not register with Vault. Only your primary money system (coins, dollars, whatever you call it) should be the Vault provider. Secondary currencies live in their own plugin APIs and are referenced directly by the plugins that use them, such as CrazyCrates for token-based keys or a custom ShopGUI+ page for gem purchases.

Troubleshooting Common Issues

Balance Shows 0 After Provider Switch

Each economy plugin stores balances in its own database. If you switch from EssentialsX to CMI, your players' EssentialsX balances do not transfer automatically. You need to export from one and import to the other. CMI includes a migration command: /cmi importfrom essentials.

Shops Not Working After Plugin Update

If ChestShop or ShopGUI+ stops processing transactions, check /vault-info economy. A plugin update may have changed load order, causing a different provider to take priority. Restart the server (not reload) and verify the correct provider is selected.

Vault Not Detecting Any Economy

This usually means your economy plugin failed to load before Vault. Check for errors in the startup log from EssentialsX or CMI. A missing dependency (like a database driver) can silently prevent the economy module from registering. Ensure vault multiple economy plugins are all compatible with your server version and have their dependencies met.

For a complete walkthrough of Vault setup from scratch, see our Vault economy guide. For configuring the anti-cheat layer that protects your economy from exploits, check the anti-cheat setup guide.

See these configs live: Astroworld MC, IP play.astroworldmc.com, Java + Bedrock.