?
Host a serverModrinth App
Sign in
ModsResource PacksData PacksShadersModpacksPluginsServers
Settings
Chest Trade

Chest Trade

Player-driven item-for-item chest shops for Paper. Set up trades without currency—just exchange items directly.

131downloads
1follower
131downloads
1follower

Compatibility

Minecraft: Java Edition

26.3
1.21.x

Platforms

Links

View source

Tags

Creators

Details

Licensed MIT
Published 3 months ago
Updated 3 weeks ago

🪙 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

Requirement Version Notes
Paper 26.3 Required (api-version: 26.3)
Java 25+ Required

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 Text
1 [TRADE]
2 DIAMOND:1
3 DIRT:16

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

Command Description Permission
/ctshop create <cost-item> <cost-amount> <product-item> <product-amount> Create a trade shop on the container you target chesttrade.create
/ctshop info or /ctshop help Show in-game help none
/ctshop info chest Show owner, location, trade and stock of the shop you're looking at none

/help ctshop shows the same help text.

🔑 Permissions

Permission Description Default
chesttrade.create Create shops (command and [TRADE] signs) false

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

Software Status
Paper ✅ Supported (26.3)
Purpur ⚠️ Untested (Paper fork, should work)
Spigot ⚠️ Untested (Should work)
Bukkit ⚠️ Untested (Should work)
Folia ❌ Not supported

🔨 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.