How to Set Up an Economy on Your Minecraft Server (Vault + Shops)
Guide

How to Set Up an Economy on Your Minecraft Server (Vault + Shops)

Give your server a working economy with currency, player balances, and shops. A complete guide to Vault, EssentialsX Economy, and ChestShop for Paper and Purpur servers.

Swelis TeamApril 18, 20269 min read

Your players finished the dragon, built their mega-bases, and now they log in, look around, and ask: "What do we do now?" This is the moment most SMPs start bleeding players. One proven fix: give them something to spend.

A server economy creates goals. Ranks cost money. Rare items have prices. Players trade instead of just hoarding. Suddenly that stack of diamonds means something beyond personal bragging rights — it buys a plot at spawn, a cosmetic title, or passage through someone else's nether hub.

This guide walks through the standard economy stack for Paper and Purpur servers: Vault as the API bridge, EssentialsX Economy for balances and commands, and ChestShop for player-to-player trade. By the end, your players will have wallets, your spawn will have shops, and your ranks can actually cost something.


The Plugin Stack: What Each Piece Does

Before installing anything, understand how these three plugins fit together. Each has a distinct job:

PluginRoleWhy You Need It
VaultAPI bridgeLets other plugins (ranks, shops, jobs) talk to whatever economy plugin you use. Without Vault, plugins can't read or modify player balances.
EssentialsX EconomyBalance storage + commandsStores how much money each player has. Provides /balance, /pay, /eco commands.
ChestShopPlayer shopsLets players create physical shops using signs and chests. Handles transactions automatically.

Vault is not an economy plugin itself — it's the translator. If you later decide to swap EssentialsX Economy for something else (like CMI or PlayerPoints), plugins using Vault won't break. They just talk to the new backend.

EssentialsX Economy comes bundled with EssentialsX. If you already run EssentialsX for /home, /warp, and /spawn, you already have the economy module — it just needs enabling.

ChestShop is one of several shop plugins. Alternatives include QuickShop-Hikari (more modern, virtual item display) and ShopGUI+ (GUI-based admin shops). This guide uses ChestShop because it's stable, widely understood, and works with physical sign+chest combos that fit SMP aesthetics.


Installing Vault and EssentialsX Economy

Both plugins install the same way: download the JAR, drop it in your /plugins folder, restart the server.

Step 1: Download the plugins

Grab these from their official sources:

If you're on Swelis Hosting, both plugins appear in the one-click plugin installer. Search "Vault" and "EssentialsX" in the Plugins tab and click Install.

Step 2: Upload and restart

Place both JARs in your server's plugins/ folder. Restart the server (not /reload — economy plugins need a clean start).

Step 3: Verify Vault detects the economy

After restart, run this command in console or as op:

/vault-info

You should see output like:

[Vault] Economy: EssentialsX Economy [EssentialsX]

If it says "No economy plugin found," EssentialsX didn't load correctly. Check for errors in your server log — usually a missing dependency or a corrupted JAR.

Step 4: Configure EssentialsX Economy

Open plugins/Essentials/config.yml. The economy settings live under the economy section. Key options:

# Currency formatting
currency-symbol: '$'
currency-symbol-suffix: false

# Starting balance for new players
starting-balance: 100

# Minimum balance (set negative to allow debt)
min-money: 0

# Maximum balance (0 = unlimited)
max-money: 10000000000000

The starting-balance is what new players get when they first join. 100 is reasonable for most servers — enough to buy a few items, not enough to skip the grind.

After editing, run /essentials reload or restart the server.

Step 5: Test basic commands

As a player, verify these work:

CommandWhat It Does
/balance or /balShows your current balance
/pay <player> <amount>Sends money to another player
/balancetop or /baltopLeaderboard of richest players

As an op or from console:

CommandWhat It Does
/eco give <player> <amount>Add money to a player
/eco take <player> <amount>Remove money from a player
/eco set <player> <amount>Set exact balance

If these work, your economy backend is live. Now players need ways to earn and spend.


Setting Up Shops: Admin Shops vs Player Shops

ChestShop supports two shop types:

  • Admin shops: Infinite stock, server-controlled prices. Good for baseline items (food, basic tools) or sinks (selling cobblestone).
  • Player shops: Limited to what the player stocks in the chest. The real economy driver.

Installing ChestShop

Download from Hangar or SpigotMC. Drop the JAR in /plugins, restart.

ChestShop will auto-detect Vault and connect to EssentialsX Economy. No additional config needed for basic functionality.

Creating a Player Shop

Player shops use a sign placed on or near a chest. The sign format:

[Line 1]: Leave blank (auto-fills with your username)
[Line 2]: Quantity per transaction
[Line 3]: Price format (B = buy from shop, S = sell to shop)
[Line 4]: Item name or ? for auto-detect

Example — selling 16 diamonds for $500 each:

[blank]
16
B 500
Diamond

When a player right-clicks this sign, they pay $500 and receive 16 diamonds from the chest.

Example — buying cobblestone from players at $1 per stack:

[blank]
64
S 1
Cobblestone

Left-clicking this sign sells 64 cobblestone from the player's inventory to the shop chest.

You can combine buy and sell on one sign:

[blank]
1
B 50:10 S
Iron Ingot

This shop sells iron ingots at $50 each (players buy) and buys them at $10 each (players sell). The spread is your profit margin.

Pro tip: Put ? on line 4 and hold the item you want to sell when placing the sign. ChestShop auto-fills the item name, avoiding typos.

Creating an Admin Shop

Admin shops have infinite stock and are typically placed at spawn to provide baseline pricing. To create one:

  1. Place a chest (optional — admin shops don't actually need a chest, but it looks better)
  2. Place a sign with Admin Shop on the first line:
Admin Shop
64
B 10:5 S
Cobblestone

This admin shop sells cobblestone at $10/stack and buys it at $5/stack indefinitely. Players can always offload cobblestone here, preventing "worthless item" frustration.

Admin shops require the chestshop.admin permission. Set this in LuckPerms for your admin rank:

/lp group admin permission set chestshop.admin true

Common Shop Configurations

Here's a starter set of admin shops for a typical SMP spawn:

ItemBuy PriceSell PriceNotes
Cobblestone (64)$10$5Basic sink, always available
Oak Log (16)$20$8Prevents wood scarcity early-game
Bread (16)$15-Food baseline, no buyback
Iron Ingot (1)$50$25Mid-tier currency anchor
Diamond (1)$500$250High-tier anchor
Ender Pearl (4)$100$40Utility item sink

Don't overprice admin shops. They set the floor — player shops should undercut them for competitive trade.


Connecting Economy to Ranks and Rewards

An economy without things to buy is just a number. Connect it to progression systems.

Buyable Ranks with LuckPerms

If you followed our LuckPerms permissions guide, you already have rank groups. To make ranks purchasable, add a shop plugin that supports rank transactions, or use EssentialsX's built-in kit costs.

The simplest approach: use signs with command execution. Several plugins (like ChestCommands or DeluxeMenus) let you create GUI shops where clicking an item runs a command. For ranks, the command would be:

/lp user %player% parent set vip

Triggered only if the player has sufficient balance (handled by the GUI plugin's economy check).

Alternatively, dedicated plugins like RankGrant+ or BuyRanks handle this with proper confirmation dialogs and logging.

Playtime Rewards

Reward active players automatically. Plugins like PlaytimeRewards or VotingPlugin can grant money on milestones:

  • 1 hour played: $100 bonus
  • 10 hours played: $500 bonus
  • First vote: $50

These inject currency into the economy, balancing against shop sinks.

Job Plugins

For servers that want structured income beyond trading, Jobs Reborn or JobsLite let players pick professions (Miner, Farmer, Hunter) and earn money for profession-specific actions.

Example: a Miner earns $0.50 per diamond ore broken, $0.10 per iron ore. This creates income without requiring player-to-player trade.

Jobs plugins integrate with Vault automatically — no extra configuration to connect them to EssentialsX Economy.


Troubleshooting Common Issues

Vault says "No economy plugin found"

Causes:

  • EssentialsX failed to load (check console for errors)
  • You installed Essentials instead of EssentialsX (different plugins — use EssentialsX)
  • Plugin load order issue (rare on Paper/Purpur)

Fix: ensure EssentialsX-<version>.jar is in /plugins, restart fully, check that plugins/Essentials/config.yml exists after restart.

ChestShop signs don't work

Causes:

  • Vault not installed or not detecting economy
  • Player lacks chestshop.shop.create permission
  • Sign not placed on or adjacent to chest

Fix: verify /vault-info shows an economy. Check permissions with /lp user <name> permission check chestshop.shop.create. Ensure the sign is within one block of a chest (including diagonally or on top).

Balance desync between plugins

If one plugin shows a different balance than another, they're not both using Vault, or one is caching stale data.

Fix: ensure all economy-interacting plugins depend on Vault. Avoid plugins that store their own currency separately. After changes, restart the server fully — /reload causes desync issues with economy plugins.

Players can't afford items but have money

Usually a permission issue with the shop plugin, or the player's balance is stored under a different UUID (common if they changed usernames and your server runs in offline mode).

Fix: check if the player's balance exists with /eco set <player> <amount> and verify it reflects in /balance.


Quick Reference

TaskCommand/Action
Check your balance/balance or /bal
Send money to a player/pay <player> <amount>
See richest players/baltop
Give money (admin)/eco give <player> <amount>
Take money (admin)/eco take <player> <amount>
Create player shopSign on chest: blank, quantity, B <price> or S <price>, item name
Create admin shopSign line 1: Admin Shop, then same format
Check Vault economy/vault-info
Grant shop permission/lp group <group> permission set chestshop.shop.create true

Ready to Start Your Adventure?

Join lots of users already enjoying lag-free hosting.

Launch Your Server
Swelis Hosting

Premium Minecraft server hosting starting at €1.50/GB RAM. Experience lightning-fast performance, 24/7 support, and 99.9% uptime guarantee.

© 2026 Swelis International e.U. All rights reserved.