Player Trade
Last updated Oct 4, 2026
Player Trade
Module: player-trade. Config: trade.yml. Permission: soapsadmin.trade.
Commands
| Command | Usage |
|---|---|
/sa trade <player> |
Send a trade request |
/sa trade accept |
Accept a pending request |
/sa trade deny |
Decline a pending request |
/sa trade cancel |
Cancel an open trade or pending request |
/sa tradetoggle |
Block incoming trade requests (player utilities) |
Privacy: players can refuse requests with /sa tradetoggle. Distance limits are in trade.yml.
How a trade works
- Both players open the shared trade GUI after accept.
- Place items in your left slots (12 each). Physical custom-economy currency items are allowed by default.
- Optional soft money and XP level offers (bottom row).
- Both players click Ready.
- A configurable countdown runs (
countdown-seconds, default 3). Either player can un-ready or cancel. - On complete: items, money, and XP transfer. Nothing moves until the countdown finishes.
Offer types
| Asset | Notes |
|---|---|
| Items | Normal ItemStacks, including filled shulkers (contents travel with the box) |
| Physical currency | Custom economy drop items when allow-currency-items: true |
| Soft money | Gold button: left/right adjust, shift-left type amount, shift-right cycle currency |
| XP levels | Bottle button: left/right adjust, shift-left type levels |
Not supported (by design): trading ranks, permissions, claims, homes, or whole vault backpacks.
Full inventory
overflow-mode in trade.yml:
| Mode | Behavior |
|---|---|
cancel (default) |
Refuse Ready / complete if either side cannot fit the partner’s items |
drop |
Complete anyway; extras drop at the player’s feet |
vault |
Try the player’s autopickup vault first, then drop leftovers |
Safety options
cancel-on-damage/cancel-on-world-change- Offers freeze during countdown
- Ready clears when either offer changes
- Closing the GUI cancels and returns your items