Skip to main content
← All Guides
Server Setup

Set Up a Server Economy

An economy gives your server real stakes, players earn, spend, and trade currency. The standard stack is Vault (the bridge) plus an economy provider like EssentialsX. Drop both in, set a starting balance, and /balance and /pay just work.

survival.yourserver.net, console
[Vault] Hooked into economy: EssentialsX Economy
[EssentialsX] Enabled, 2 accounts loaded
Steve> /pay Alex 250
✓ You sent $250.00 to Alex.
✉ Alex received $250.00 from Steve.
live ledger
Steve
$1,180.00
Alex
$510.00
Alex> /balance → Balance: $510.00
One provider, one ledger
  1. 1
    Install Vault
    Drop Vault.jar into /plugins. It is the bridge every economy plugin and shop plugin talks to. It does nothing alone.
  2. 2
    Add an economy provider
    Drop EssentialsX (with EssentialsXChat optional) into /plugins. It registers itself with Vault as the currency handler.
  3. 3
    Restart and confirm the hook
    Restart, not reload. Console should print [Vault] Hooked into economy: Essentials Economy. No hook means no balances.
  4. 4
    Set the starting balance
    In Essentials config.yml set starting-balance: 1000 and currency-symbol: $. Save and run /ess reload.
  5. 5
    Test /balance and /pay
    Run /balance to see your money, then /pay <player> 250 to send some. The receiver's balance jumps instantly.

What you need

Vault (API bridge)
EssentialsX Economy
config.yml
Permissions plugin

Quick answers

?
Do I need Vault if I have EssentialsX?
Yes. EssentialsX provides the money, but Vault is what shops, jobs, and other plugins read it through. Without Vault, third-party plugins can't see balances.
?
How do I change the starting balance?
Edit starting-balance in Essentials config.yml, then run /ess reload. It only affects players who join after the change, not existing accounts.
?
Can players go into debt?
By default no, /pay is blocked if you can't afford it. You can allow negative balances with min-account-balance in config.yml, but most servers leave it off.
?
How do I give a player money as admin?
Use /eco give <player> <amount>/eco take, or /eco set. These bypass the /pay affordability check and are great for rewards or fixing mistakes.
?
Why does /balance say 'no economy installed'?
Vault didn't hook a provider. Confirm EssentialsX is loaded, do a full restart (not /reload), and check console for the [Vault] Hooked line.
?
Can I use a different currency name?
Yes. Set currency-symbol and the singular/plural names in Essentials config.yml. Some servers rename it to coins, credits, or anything fitting the theme.
Hosting →
Skip the setup
Get a managed server with one click instead of configuring it all yourself.
Database →
Browse item values
Look up items and blocks to price your shops and economy fairly.