🪙 ChestTrade
ChestTrade is a lightweight, player-driven shop plugin for Paper servers. Players can set up chest-based trade shops where they offer one item in exchange for another — no economy plugin or in-game currency required. Just pure item-for-item trading.
Operators and admins can open and break any shop, giving full control over the marketplace without needing extra setup.
✨ Features
- 📦 Simple chest-based player shops — place a chest, run a command or write a sign, done
- 🔄 Item-for-item trading — no economy plugin needed
- 🔐 Shops are protected; only the owner (or OP) can break or open them
- 🛠️ Lightweight and focused — no bloat, just trading
- 🔑 LuckPerms support for fine-grained permission control
📋 Requirements
| Requirement | Version | Notes |
|---|---|---|
| Paper / Spigot | 1.21.1 | Required |
| Java | 21+ | Required |
| LuckPerms | Latest | Required for chesttrade.create permission |
Note: Spigot may work but is untested. Paper is recommended.
📥 Installation
- Download the latest
.jarfrom the Releases page - Drop it into your server's
/plugins/folder - Make sure LuckPerms is installed
- Restart your server
- Assign the
chesttrade.createpermission to players who should be able to create shops
🛒 How to Use
Creating a Shop
- Place a chest where you want your shop
- Look at the chest and run:
Example: offer 32 wheat in exchange for 1 diamond:/ctshop create <cost-item> <cost-amount> <product-item> <product-amount>/ctshop create diamond 1 wheat 32 - The chest is now a trade shop — other players can interact with it to complete the trade
Using a Shop
- Right-click the shop chest to initiate a trade
- If you have the requested items in your inventory, the trade completes automatically
Removing Your Shop
Shift + Axe
Look at your shop chest and run this command to remove it.
📜 Commands
| Command | Description | Permission |
|---|---|---|
/ctshop create <cost-item> <cost-amount> <product-item> <product-amount> |
Create a new trade shop | chesttrade.create |
shift + axe |
Remove your shop | chesttrade.create |
/ctshop info |
View info about a shop | chesttrade.create |
🔑 Permissions
| Permission | Description | Default |
|---|---|---|
chesttrade.create |
Allows a player to create and manage their own shops | false |
ctshop.* |
All ChestTrade permissions | OP only |
Permissions are managed via LuckPerms.
OPs can open and break any shop regardless of permissions.
Example LuckPerms setup
Give all players in the default group the ability to create shops:
/lp group default permission set chesttrade.create true
⚙️ Compatibility
| Software | Supported |
|---|---|
| Paper 1.21.1 | ✅ |
| Spigot 1.21.1 | ⚠️ Untested |
| Folia | ⚠️ Untested |
| Bukkit | ⚠️ Untested |
🐛 Issues & Suggestions
Found a bug or have a feature request? Please open an Issue on GitHub and include:
- Your server software and version
- Steps to reproduce the problem
- Any relevant console errors
🛠️🚧 Under development
- This project is still in early development
- Be aware of frequent changes and updates
📄 License
This project is licensed under the MIT License.
