Skip to content

Vault Integration

Create: Hydraulics edited this page Jul 13, 2026 · 1 revision

Vault Integration

Vault is a soft dependency. Exchequer runs fully without it. With Vault present, two things happen: Exchequer registers itself as the server's Economy provider, and MONEY becomes a tradeable currency inside the exchange system.

The Economy API Bridge

Exchequer implements net.milkbowl.vault.economy.Economy and registers itself through Vault's Services Manager. This exposes a single balance, backed by your designated reference currency (gold by default), to every other Vault dependent plugin on your server: shops, jobs plugins, casino plugins, and so on. Those plugins read and write this balance exactly as they would with any other economy plugin, they do not need any special configuration to work with Exchequer specifically.

MONEY as a Tradeable Currency

Rather than treating Vault money as a static number that simply mirrors your ledger, Exchequer treats MONEY as its own currency with a real liquidity pool against every tracked material, using the same AMM mechanics as any material to material trade.

This matters for one specific reason: without this, any other plugin minting Vault money (a jobs plugin paying out on task completion, for example) would inject value into the economy for free, bypassing the tax and burn mechanics that control the rest of the system. By routing MONEY through the same exchange pipeline, converting minted money into materials still passes through the same dynamic tax and burn sink as everything else, protecting the scarcity model the rest of the plugin is built around.

Where MONEY Appears

MONEY shows up as a selectable option in the Exchange GUI's material grid, shown with a distinct icon and clearly labeled, not disguised as a real material. Its balance side reads and writes directly to the Vault Economy API rather than Exchequer's internal ledger, since that balance is shared with every other plugin on the server. /market price and /market history both support MONEY as a trackable entry, snapshotted into OHLC history the same as any other material.

If Vault Is Not Installed

None of the above exists. There is no Economy provider registered, no MONEY option anywhere in the GUI or commands, and no other plugin can read or write Exchequer balances through Vault. This has no effect on any of Exchequer's other systems, which operate entirely independently of Vault's presence.

Clone this wiki locally