How to Set Up ChestShop, Player-to-Player Shops Guide

What Is ChestShop?

ChestShop is the most widely used sign-based shop plugin in the Minecraft server ecosystem. It lets players create their own physical shops by placing a sign on or near a chest. Buyers and sellers interact by clicking the sign, and the transaction is handled automatically: items move between inventories and money is transferred through your Vault-compatible economy plugin. There is no GUI, no menu, and no admin involvement after initial setup. That is the entire appeal.

The plugin has been around since the Bukkit days and remains actively maintained for Paper, Spigot, and Purpur. It works on every modern server version from 1.13 through 1.21+. Because shops are physical objects tied to signs and chests, they give your server world a lived-in marketplace feel that GUI-based shop plugins cannot replicate.

If you are running a survival economy server and want players to set their own prices and compete with each other, ChestShop is the standard choice. For admin-controlled NPC shops, look at ShopGUI+ instead.

Requirements Before You Start

• A Spigot, Paper, or Purpur server (1.13+)
• An economy plugin registered through Vault (EssentialsX Economy, CMI Economy, or similar)
• Vault itself installed as a plugin
• A permissions plugin such as LuckPerms

Installing ChestShop

Download the latest ChestShop jar from the SpigotMC resource page or from dev.bukkit.org. Drop the jar file into your server's plugins/ folder and restart the server. Do not use /reload, ChestShop registers Vault hooks during startup and a reload can leave those hooks in a broken state.

After the first boot, ChestShop generates its configuration in plugins/ChestShop/config.yml. The defaults are reasonable for most servers, but there are a few settings worth adjusting before you open the doors to players.

Key Configuration Options

Setting	Default	Recommended	What It Does
TURN_OFF_DEFAULT_PROTECTION	false	false	When false, ChestShop automatically protects shop chests from being broken or opened by other players. Leave this on unless you use a separate protection plugin like WorldGuard.
ALLOW_MULTIPLE_SHOPS_AT_CHEST	false	false	Whether multiple signs can link to one chest. Keeping this off prevents confusion.
TAX_AMOUNT	0	2-5	Percentage tax on each sale. A mild tax acts as a money sink that fights inflation.
SERVER_TAX_AMOUNT	0	2-5	Tax on admin shop transactions specifically.
SHOP_CREATION_PRICE	0	50-200	Cost to create a shop sign. Prevents sign spam in public areas.

Creating a Player Shop

Once ChestShop is installed and Vault is connected, any player with the chestshop.shop.create permission can make a shop. The process is simple:

1. Place a chest (single or double) and stock it with the items you want to sell.
2. Place a sign on the chest or on a block directly adjacent to it (including one block above).
3. Write the sign in this exact format:

Line 1: [leave blank, your name fills in automatically]
Line 2: 64
Line 3: B 10:S 8
Line 4: Diamond

Line 2 is the quantity per transaction. Line 3 sets prices: B 10 means buyers pay 10 currency, S 8 means sellers receive 8 currency. Line 4 is the item name. You can use either the Minecraft material name or a custom alias if you configure one.

Buy-Only and Sell-Only Shops

You do not have to offer both buying and selling on the same sign. If you only want to sell items to players, leave out the S portion:

Line 3: B 10

If you want to buy items from players (for example, purchasing raw materials), leave out the B portion:

Line 3: S 8

This is useful for setting up dedicated buying stations where players dump farmed resources.

Admin Shops

An admin shop has infinite stock and pulls money from nowhere. The server itself is the vendor. To create an admin shop, write Admin Shop on the first line of the sign instead of leaving it blank. Only players with the chestshop.admin permission can do this.

Admin shops still need a chest behind the sign, but the chest acts only as a reference for the item type. It will never empty out or fill up. Use admin shops sparingly, too many admin shops with generous sell prices create infinite money faucets that wreck your economy. Read the economy balancing guide before setting prices.

Protecting Shops From Theft

ChestShop includes built-in chest protection that prevents players from breaking shop chests or signs. However, this protection is basic. For a production server you should layer additional protection:

• WorldGuard regions: Define a marketplace region with chest-access deny and block-break deny flags so that only region members can modify the area. See the WorldGuard guide for setup.
• LWC or Bolt: Lock individual chests to their owners. ChestShop supports LWC integration natively, if LWC is installed, ChestShop auto-locks the chest when a shop sign is placed.
• GriefPrevention claims: If your server uses claim-based protection, shops inside a player's claim inherit the claim's access rules.

The biggest risk is not theft from chests but hopper theft, a player placing a hopper beneath a shop chest to drain items. ChestShop's built-in protection blocks this by default, but confirm that TURN_OFF_HOPPER_PROTECTION is set to false in your config.

Common Issues and Fixes

Sign Does Not Create a Shop

This is almost always a permissions problem. Check that the player has chestshop.shop.create granted through LuckPerms. Also verify that Vault is loaded and has detected your economy plugin, run /vault-info or check the startup log for a line like [Vault] EssentialsX Economy hooked.

Item Name Not Recognized

ChestShop uses Minecraft material names by default. If a player types "Diamond Sword" but the material is DIAMOND_SWORD, the sign will fail. You can add custom aliases in plugins/ChestShop/itemAliases.yml to map friendly names to material IDs.

Money Not Transferring

If the sign creates but transactions do nothing, Vault is not connected to your economy correctly. Run /balance on both the buyer and seller to confirm the economy plugin is working. If you recently switched economy plugins, restart the server fully.

ChestShop vs ShopGUI+

These two plugins solve different problems. ChestShop is player-to-player: each player builds their own shop, sets their own prices, and stocks their own inventory. ShopGUI+ is admin-to-player: you define a centralized GUI shop with fixed or dynamic pricing. Most economy servers benefit from running both, ShopGUI+ as the baseline admin shop for common items, and ChestShop for player competition on everything else. The Auction House plugin is a third option that adds a global marketplace without physical shop locations.

Need a server for this? Astroworld Hosting runs NVMe SSD, Pterodactyl panel, and DDoS protection on every plan. See features , plans from €6.39/mo.