🪙 ChestTrade

ChestTrade is a lightweight, player-driven shop plugin for Paper servers. Players turn a chest or barrel into a trade shop where other players can swap one item for another. No economy plugin or in-game currency needed, just item-for-item trading.

OPs can open and break any shop, so admins stay in control of the marketplace without extra setup.

🚧 Under development. Expect frequent changes and updates.

✨ Features

• 📦 Chest and barrel shops, created with a command or a sign
• 🔄 Item-for-item trading, no economy plugin needed
• 🔐 Protected shops: only the owner (or OP) can open or break them
• 🧱 Trade chests are always kept as single chests (no double-chest exploits)
• 🚫 Hoppers can't move items in or out, and explosions can't destroy shops
• 🔔 Sound feedback on successful and failed trades
• 🔑 Works with any permissions plugin (e.g. LuckPerms)

📋 Requirements

No other plugins are required. A permissions plugin is only needed if you want to give chesttrade.create to non-OP players.

📥 Installation

1. Download the latest .jar from the Releases page
2. Drop it into your server's plugins/ folder
3. Restart the server
4. Give chesttrade.create to the players who should be able to create shops (see Permissions)

🛒 How to Use

Creating a shop

You need the chesttrade.create permission. There are two ways:

Method 1: Command

Look at a chest or barrel (within 5 blocks) and run:

/ctshop create <cost-item> <cost-amount> <product-item> <product-amount>

• cost is what the customer pays
• product is what the customer gets

Example: customers pay 1 diamond and get 32 wheat:

/ctshop create diamond 1 wheat 32

Item names are case-insensitive. Wrap multi-word names in quotes:

/ctshop create "spruce planks" 1 "oak planks" 16

Method 2: Sign

Place a sign directly on top of a chest or barrel and write:

Line 2 is the cost, line 3 is the product. The sign is rewritten automatically to show the trade.

Stocking the shop

The owner (and OPs) can right-click the shop to open it like a normal container. Put the product items inside. Customer payments are stored in the same container, so collect them there.

Trading

Right-click the shop chest (or its sign). If the shop has enough product, you have enough of the cost item, and both inventories have room, the trade completes instantly.

Removing a shop

The owner (or an OP) breaks the chest or sign while sneaking. Breaking it without sneaking is blocked.

Chest placement

Trade chests can't become double chests. To put another chest next to one, shift+right-click the block below the trade chest, or use a barrel for extra storage.

📜 Commands

/help ctshop shows the same help text.

🔑 Permissions

OPs can open and break any shop regardless of permissions.

Example LuckPerms setup

Let everyone in the default group create shops:

/lp group default permission set chesttrade.create true

⚙️ Compatibility

🔨 Building from source

Requires Java 25 and Maven.

git clone https://github.com/wineredbbqsauce/Chest-Trade-plugin.git
cd Chest-Trade-plugin
mvn package

The jar ends up in target/.

🐛 Issues & Suggestions

Found a bug or have a feature request? Open an Issue and include:

• Your server software and version
• Steps to reproduce the problem
• Any relevant console errors

📄 License

This project is licensed under the MIT License.