<h1 align="center">💱 expTrade</h1> <h3 align="center">Trade XP between players — give it, request it, and confirm every exchange through a chest-GUI queue.</h3> <p align="center"><img src="https://img.shields.io/badge/Fabric-DBA463?style=for-the-badge&amp;logoColor=white" alt="Fabric"> <img src="https://img.shields.io/badge/NeoForge-F16436?style=for-the-badge&amp;logoColor=white" alt="NeoForge"></p> <p align="center"><a href="https://www.curseforge.com/minecraft/mc-mods/exptrade-mod"><img src="https://img.shields.io/badge/Download_on-CurseForge-F16436?style=for-the-badge&amp;logo=curseforge&amp;logoColor=white" alt="Download on CurseForge"></a> <a href="https://discord.gg/J9QnJWDFB3"><img src="https://img.shields.io/badge/Join_the-Discord-5865F2?style=for-the-badge&amp;logo=discord&amp;logoColor=white" alt="Discord"></a> <a href="https://github.com/LunixiaLIVE/expTrade"><img src="https://img.shields.io/badge/Source-GitHub-181717?style=for-the-badge&amp;logo=github&amp;logoColor=white" alt="GitHub"></a></p> <p align="center"><img src="https://img.shields.io/badge/Minecraft-26.x_%26_1.21.x-62B47A?style=flat-square" alt="Minecraft 26.x & 1.21.x"> <img src="https://img.shields.io/badge/Side-Single_Player_%26_Server-8E44AD?style=flat-square" alt="Single Player & Server"> <img src="https://img.shields.io/badge/Fabric_API-required_on_Fabric-4A90D9?style=flat-square" alt="Fabric API required on Fabric"> <img src="https://img.shields.io/badge/License-MIT-blue?style=flat-square" alt="MIT License"></p> --- Ever finished a mob grinder with 40 spare levels while a friend is scraping to enchant their first pickaxe? **expTrade** lets players hand XP back and forth like any other resource — give it, ask for it, and confirm the exchange through a clean chest-GUI queue. No dropping bottles o' enchanting on the floor, no trust games: every transfer is explicit, previewed before it happens, and time-boxed so stale offers clean themselves up. It's fully **server-side** — a **vanilla client** can join a modded server and it just works. Runs in single-player too. No new blocks, no new items, no library mods: just `/exptrade` and a virtual chest menu built from vanilla items. ## Why expTrade? | | expTrade | |:---|:---| | 💱 **Direction** | Give XP away *or* request it — the other player always confirms | | 📊 **Units** | Whole **levels**, exact **raw XP**, or `all` — the mod does the curve math | | 📦 **Queue** | A live chest-GUI queue with per-player TTL and countdown clocks | | 🛡️ **Safety** | Personal level thresholds + re-validation at the moment of accept | | 🎒 **Client** | Server-side only — vanilla clients connect and play as normal | ## ✨ Key features - 💱 **Give or request, either direction.** Push your own XP to someone with `give`, or ask them for some with `request`. The other player always gets the final say. - 📊 **Levels or raw XP.** Trade a round number of **levels** or an exact **raw XP** amount — or `all` to empty your bar in one go. The mod does the vanilla XP-curve math for you. - 📦 **A live chest-GUI queue.** `/exptrade pending` opens a virtual chest showing every incoming offer as its own row: a **clock** ticking down the time left, the sender's **player head**, an **offer/request** marker, a **details** page, and one-click **Accept** / **Decline** buttons. - ⏳ **Per-player queue with TTL.** Each player has their own incoming queue (default cap **10**). Offers expire automatically after a timeout (default **60s**), notifying both sides — nothing lingers forever. - 🛡️ **Threshold protection.** Set a personal level floor with `/exptrade threshold` and the mod refuses any trade that would drop you below it — great insurance against fat-fingering `give … all`. - 🔍 **Balance preview before you commit.** Every offer shows a **before → after** readout of both players' levels and XP, so nobody agrees blind. - 🖱️ **Clickable chat controls.** Offers come with ``, ``, and (for admins) `` / `` buttons wired straight to the commands. - ✅ **Double-checked at execution.** Amounts are validated when the offer is made **and re-validated the instant it's accepted** — if the giver spent their XP in the meantime, the trade fails cleanly instead of going negative. - 🛠️ **Admin transfers.** Operators can move XP between any two online players with a two-step confirm, bypassing thresholds — handy for events, refunds, and prizes. - 🔒 **No item risk.** The GUI slots are display-only; you can't pull items out or drop your own in. The only interactive slots are Accept and Decline. ## ⌨️ Commands Everything lives under `/exptrade`. `<player>` targets are online players; amounts are positive integers, or the literal `all` to move your entire bar. | Command | What it does | |:---|:---| | `/exptrade give <player> levels <amount>` | Offer that many **levels** to a player | | `/exptrade give <player> levels all` | Offer **all** your XP (expressed as levels) | | `/exptrade give <playe