ZCraft StudiosZCraft Studios

Linking Vault to an Economy Plugin: The Full Setup

ZCraft Studios

Vault itself does nothing — it's the bridge that lets every other plugin share one economy instead of each keeping its own separate balance.

Linking Vault to an Economy Plugin: The Full Setup

Vault is invisible when it's working. Every plugin just shares one balance instead of six plugins keeping six separate ones.

Vault is an API bridge, not an economy itself — it lets shop plugins, kit plugins, and anything else that charges or pays players talk to whichever economy plugin is actually installed, without each one needing its own integration.

Install Vault First

Drop Vault.jar into plugins/ and restart. On its own it does nothing visible — it's waiting for an economy provider to register with it.

Install an Economy Provider

EssentialsX ships its own built-in economy and registers with Vault automatically once both are installed — for most servers, this is the entire setup:

plugins/
  Vault.jar
  EssentialsX.jar

No extra configuration needed — Essentials detects Vault on startup and hooks in.

Confirming the Hook Worked

/vault-info

reports which economy, permission, and chat plugins Vault is currently hooked into. If it shows "None" under Economy, the economy plugin either isn't installed correctly or loaded in the wrong order — check the server's startup log for a Vault-related error.

Using a Dedicated Economy Plugin Instead

Some servers use a dedicated economy plugin (like EssentialsX Economy standalone, or a custom one) instead of Essentials' built-in version, usually for more configuration options — multiple currencies, bank accounts, or interest. These also register with Vault the same way; only the installed jar changes, not anything downstream that depends on Vault.

Why This Matters for Shop Plugins

Shop plugins (chest shops, GUI shops, auction houses) almost universally depend on Vault rather than any specific economy plugin directly. That's the entire point — swapping the economy plugin later doesn't require reconfiguring every shop plugin that charges players, as long as both still talk through Vault.

Troubleshooting a Broken Hook

  • Load order matters. Vault needs to load before the economy plugin registers — this is usually handled automatically by each plugin's dependency declarations, but a manually forced load order in plugins/ naming can occasionally interfere.
  • Multiple economy plugins installed at once will cause Vault to hook into whichever loaded first, silently ignoring the other — only one economy plugin should be active at a time.
  • Permissions plugin conflicts — Vault also bridges permission plugins (like LuckPerms) the same way it bridges economy. /vault-info reports both, so a broken permission hook shows up in the same command.
Share: