expTrade

A Minecraft mod/plugin that lets players trade XP with each other. Offers and requests queue up per-player with individual TTLs, and are managed through an in-game chest GUI.

Branches

| Branch | Platform | MC Version |
|---|---|---|
| multi_1.21.11 | Fabric + NeoForge (Architectury) | 1.21.11 |
| plugin_1.21.11 | Spigot, Paper, Purpur, Pufferfish | 1.21.11 |
| multi_26.x (upcoming) | Fabric + NeoForge (Architectury) | 26.x |
| plugin_26.x (upcoming) | Spigot, Paper, Purpur, Pufferfish | 26.x |

Features

• Give or request XP levels or raw XP from any online player
• Per-player incoming trade queue — multiple players can send trades simultaneously
• Chest GUI to review, accept, and decline queued trades
• Live TTL countdown per trade — expired trades are removed automatically
• Configurable timeout and max queue size
• Personal XP threshold — prevent trades that would drop you below a set level
• Admin force-transfer with confirmation step
• Config hot-reload without restarting the server

Trade Queue GUI

Opening /exptrade pending shows a chest with one row per queued trade:

| Slot | Item | Meaning |
|---|---|---|
| 1 | Clock | Seconds remaining before this trade expires |
| 2 | Player Head | Who sent the trade |
| 3 | Water Bucket / Bucket | Offer (giving XP) / Request (asking for XP) |
| 4 | Paper | Trade details on hover (from, type, amount) |
| 8 | Recovery Compass | Click to accept |
| 9 | Compass | Click to decline |

The GUI stays open after each action as long as trades remain in the queue.

Commands

All commands use /exptrade.

| Command | Description |
|---|---|
| /exptrade give <player> <levels\|exp> <amount\|all> | Offer XP to a player |
| /exptrade request <player> <levels\|exp> <amount\|all> | Request XP from a player |
| /exptrade accept [player] | Accept the first (or a specific) queued trade |
| /exptrade decline [player] | Decline the first (or a specific) queued trade |
| /exptrade cancel | Cancel your outgoing trade |
| /exptrade pending | Open the trade queue GUI |
| /exptrade threshold <levels> | Set minimum level to keep after a trade |

Admin (exptrade.admin / op permission)

| Command | Description |
|---|---|
| /exptrade admin transfer <from> <to> <levels\|exp> <amount\|all> | Force an XP transfer between two players |
| /exptrade admin confirm | Confirm a pending admin transfer |
| /exptrade admin cancel | Cancel a pending admin transfer |
| /exptrade config timeout <10-300> | Set trade TTL in seconds |
| /exptrade config maxqueue <1-50> | Set max trades per player queue |
| /exptrade config reload | Reload config from disk |

Configuration

Config is written on first launch.

Multi-loader — config/exptrade.json
Paper plugin — plugins/expTrade/config.json

{
  "timeoutSeconds": 60,
  "maxQueueSize": 10
}

| Field | Default | Description |
|---|---|---|
| timeoutSeconds | 60 | Seconds before an unaccepted trade expires |
| maxQueueSize | 10 | Max number of queued trades per player |

Requirements

Multi-loader: Architectury API
Paper: Paper 1.21.11+