Chorus Trade

ChorusTrade

Secure, fully customizable player-to-player trading for Paper 26.2.

ChorusTrade gives your players a clean trade GUI where both sides can see each other's offer in real time, add items and money, and confirm with a short safety countdown. Everything is editable: messages, menu items, slots, sounds, colors. It ships with a purple theme and full hex color support.

Features

• Two-sided trade GUI: your offer on the left, the other player's offer on the right
• Money trades through Vault (any economy plugin), with optional tax and min/max limits
• Clickable chat requests with [ACCEPT] / [DENY] buttons, plus Shift + Right-click on a player
• Safety countdown after both players accept; any change resets the confirmation
• Dupe protection: the final exchange is verified against a snapshot, clicks and drags outside the offer area are blocked, double-click collecting is disabled
• Inventory space check so nobody loses items to a full inventory (or drop them if you prefer)
• Items always return to their owners on cancel, disconnect, death or server shutdown
• Item blacklist by material or by name
• Toggle to turn requests off, request cooldown, expiry, distance and world limits
• Trade history log (history.log)
• Admin tools: /trade force, /trade reload
• Works with custom items (names, lore, enchantments, custom data are preserved)

Fully customizable

• messages.yml: every single message, with placeholders
• gui.yml: title, materials, names, lore, glow and button slots
• config.yml: limits, tax, blacklist, sounds and behavior

Colors

All texts support legacy codes and hex colors. All of these work:

&#9D4EDD #9D4EDD {#9D4EDD} &l &o &7

The default theme is purple.

Commands

Command · Description
/trade · Send a trade request
/trade accept [player] · Accept a request
/trade deny [player] · Deny a request
/trade cancel · Cancel the requests you sent
/trade toggle · Enable or disable incoming requests
/trade reload · Reload the configuration (admin)
/trade force [player] · Force a trade (admin)

Aliases: /ct, /chorustrade, /scambio

Permissions

Permission · Default · Description
chorustrade.use · everyone · Use /trade
chorustrade.toggle · everyone · Use /trade toggle
chorustrade.admin · op · Reload and force trades
chorustrade.bypass.toggle · op · Send requests to players who disabled them
chorustrade.bypass.cooldown · op · Ignore the request cooldown
chorustrade.bypass.distance · op · Ignore distance and world limits
chorustrade.bypass.blacklist · op · Trade blacklisted items

Requirements

• Paper 26.2
• Java 25
• Vault and an economy plugin (optional, only for money trades)

Installation

1. Drop ChorusTrade.jar into your plugins folder
2. Restart the server
3. Edit the files in plugins/ChorusTrade/ and run /trade reload

Made by Controll3r24.