TradeSign
Sign-based chest trading system for Paper servers.
Overview
TradeSign lets players create physical shop signs attached to chests. Any player can walk up to a trade sign, see what's being offered, and execute the trade instantly — no GUIs, no menus, just signs and chests.
The linked chest is locked — only the sign owner (and admins) can open it directly. Everyone else can only interact with it through the sign.
Requirements
Creating a Trade Sign
1. Place a chest and attach a sign to it (or place the sign adjacent to the chest).
2. On the sign, write the following lines:
Example:
This creates a sign where the buyer pays 1 Diamond and receives 192 Spruce Logs from your chest.
Using a Trade Sign
Right-Click — View trade details (owner, what you pay, what you get).
Shift + Right-Click — Execute the trade instantly.
The trade will fail with a clear message if:
Chest Protection
Once a chest is linked to a trade sign, it is automatically locked. Only the sign owner and players with
Removing a Trade Sign
Break the sign. You can only break your own trade signs. Once the sign is removed the chest becomes accessible again normally. Admins with
Commands
Permissions
Data Storage
All trade signs are saved automatically to
Sign-based chest trading system for Paper servers.
Overview
TradeSign lets players create physical shop signs attached to chests. Any player can walk up to a trade sign, see what's being offered, and execute the trade instantly — no GUIs, no menus, just signs and chests.
The linked chest is locked — only the sign owner (and admins) can open it directly. Everyone else can only interact with it through the sign.
Requirements
- Paper 1.21+ (or compatible fork)
- Java 21+
Creating a Trade Sign
1. Place a chest and attach a sign to it (or place the sign adjacent to the chest).
2. On the sign, write the following lines:
Code:
Line 1: [Trade]
Line 2: <amount> <item> ← what the buyer pays
Line 3: <amount> <item> ← what the buyer receives
Line 4: (auto-filled with your name)Example:
Code:
Line 1: [Trade]
Line 2: 1 DIAMOND
Line 3: 192 SPRUCE_LOG
Line 4: (your name)This creates a sign where the buyer pays 1 Diamond and receives 192 Spruce Logs from your chest.
- Item names follow Minecraft material names (e.g.
OAK_LOG,IRON_INGOT,NETHERITE_SCRAP) - Amounts can be between 1 and 1728 (up to a full single chest worth)
- The chest must be placed adjacent to the sign (any horizontal side, or directly below)
Using a Trade Sign
Right-Click — View trade details (owner, what you pay, what you get).
Shift + Right-Click — Execute the trade instantly.
The trade will fail with a clear message if:
- The chest is out of stock
- You don't have enough of the required item
- The sign has no chest linked to it
- You try to trade with your own sign
Chest Protection
Once a chest is linked to a trade sign, it is automatically locked. Only the sign owner and players with
tradesign.admin can open the chest directly. All other players will be blocked with a message. No extra setup required — the lock is applied as long as the trade sign exists next to the chest.Removing a Trade Sign
Break the sign. You can only break your own trade signs. Once the sign is removed the chest becomes accessible again normally. Admins with
tradesign.admin can break any sign.Commands
| Command | Description | Permission |
|---|---|---|
/tradesign list | Lists your active trade signs. Admins see all signs. | none |
/tradesign remove <x> <y> <z> [world] | Force-removes a trade sign by coordinates. | tradesign.admin |
/tradesign reload | Reloads trade data from disk. | tradesign.admin |
Permissions
| Permission | Default | Description |
|---|---|---|
tradesign.create | true (all players) | Allows creating trade signs. |
tradesign.use | true (all players) | Allows executing trades (Shift+Right-Click). |
tradesign.admin | op only | Break any sign, open any linked chest, use admin commands. |
Data Storage
All trade signs are saved automatically to
plugins/TradeSign/trades.yml. Data persists across restarts. Use /tradesign reload to reload without restarting the server.
