
专为现代 Paper 生存服务器设计的安全、防刷交易图形界面。
概述
将物品掉落地上进行交易会导致物品被盗、岩浆损失和欺诈。TradeX 用同步的、以服务器权威为准的双箱 GUI 取代了地面交易,该 GUI 包含锁定倒计时确认机制,且零物品复制漏洞。
- 无需地面掉落 — 物品直接在库存之间传输。
- 无需服务器经济系统 — 开箱即用的纯物品对物品交易。
- 100% 防复制 — 原子级主线程执行与严格的状态锁定。
工作原理
- 发起请求: 运行
/trade <player>。目标玩家会收到一个带有可点击 [Accept](接受)按钮的交互式聊天邀请。
- 放置物品: 双方玩家将物品放入分屏的 54 格箱子中。每一侧都严格隔离。
- 准备就绪: 当双方都对报价满意时,点击绿色的 Ready(准备)按钮。
- 倒计时锁定: 开始 5 秒倒计时,分隔栏中显示实时时钟。所有物品移动被锁定。
- 原子交换: 当计时器归零时,物品安全地交换到各自的库存中。
(在倒计时期间,任何玩家都可以随时点击 Unready(取消准备)来取消计时器并调整报价。)
功能
- 分屏箱子界面: 54 格双箱,中间有灰色玻璃分隔物将两侧分开。
- 可点击的聊天邀请: 使用
/trade <player> 发送交易;接收者只需在聊天中点击一次即可接受。
- 5 秒倒计时锁定: 防止最后一刻的调包欺诈。
- 原子防复制引擎: 容器关闭前清空 GUI 槽位;物品在主线程上同步传输。
- 紧急取消: 点击 Cancel(取消)或按 ESC 键会立即将所有物品归还给原主人。
- 玩家偏好设置: 运行
/tradesettings 切换传入的交易请求或通知声音。
- 兼容 LuckPerms: 原生集成 LuckPerms,并回退到标准 Bukkit 权限。
命令
| 命令 |
别名 |
描述 |
/trade <player> |
— |
向在线玩家发送交易请求 |
/tradeaccept |
/ta |
接受你最新的传入交易请求 |
/tradedeny |
/td |
拒绝你最新的传入交易请求 |
/tradesettings |
/ts |
打开你的个人交易设置菜单 |
权限
| 权限 |
默认值 |
描述 |
tradex.use |
Everyone |
访问所有交易命令 |
tradex.admin |
OP |
访问管理功能 |
tradex.bypass.disabled |
OP |
向已关闭交易的玩家发送交易请求 |
配置
plugins/TradeX/config.yml 中的默认选项:
request-timeout: 60
countdown-seconds: 5
request-sound: ENTITY_EXPERIENCE_ORB_PICKUP
complete-sound: ENTITY_PLAYER_LEVELUP
countdown-sound: UI_BUTTON_CLICK
所有游戏内消息均支持 MiniMessage 标签、悬停事件和自定义十六进制颜色。
依赖
| 软件 |
支持版本 |
| 服务端核心 |
Paper (1.21 – 1.21.11 & 26.1 – 26.3) |
| Java 运行时 |
Java 21 或更高版本 |
| 权限插件 |
LuckPerms 5.x (可选) |
支持
有问题、疑问或建议?请使用此项目页面上的 Discussions(讨论)标签。
© undefinedX — 保留所有权利。严禁重新分发、转售或未经授权的修改本软件。

A secure, dupe-proof trading GUI designed for modern Paper survival servers.
Overview
Dropping items on the ground to trade causes item theft, lava loss, and scams. TradeX replaces ground trading with a synchronized, server-authoritative double-chest GUI featuring locked-in countdown confirmations and zero item-duplication exploits.
- No Ground Drops — Items transfer directly between inventories.
- No Server Economy Needed — Pure item-for-item trading out of the box.
- 100% Dupe-Proof — Atomic main-thread execution with strict state locking.
How It Works
- Request: Run
/trade <player>. The target receives an interactive chat invite with a clickable [Accept] button.
- Place Items: Both players place their items in a split 54-slot chest. Each side is strictly isolated.
- Ready Up: When satisfied with the offer, both players click the green Ready button.
- Countdown Lock: A 5-second countdown begins with a live clock in the divider. All item movement is locked.
- Atomic Swap: When the timer reaches zero, items swap safely into each player's inventory.
(Either player can click Unready at any second during the countdown to cancel the timer and adjust their offer.)
Features
- Split-Chest Interface: 54-slot double chest with a central grey glass divider separating both halves.
- Clickable Chat Invites: Send trades with
/trade <player>; recipients accept with one click in chat.
- 5-Second Countdown Lock: Prevents last-second bait-and-switch scams.
- Atomic Anti-Dupe Engine: GUI slots are wiped before containers close; items transfer synchronously on the main thread.
- Emergency Cancel: Clicking Cancel or pressing ESC immediately returns all items to original owners.
- Player Preferences: Run
/tradesettings to toggle incoming trade requests or notification sounds.
- LuckPerms Ready: Integrates natively with LuckPerms and falls back to standard Bukkit permissions.
Commands
| Command |
Alias |
Description |
/trade <player> |
— |
Send a trade request to an online player |
/tradeaccept |
/ta |
Accept your latest incoming trade request |
/tradedeny |
/td |
Deny your latest incoming trade request |
/tradesettings |
/ts |
Open your personal trade settings menu |
Permissions
| Permission |
Default |
Description |
tradex.use |
Everyone |
Access to all trading commands |
tradex.admin |
OP |
Access to administrative features |
tradex.bypass.disabled |
OP |
Send trade requests to players with trades toggled off |
Configuration
Default options in plugins/TradeX/config.yml:
request-timeout: 60
countdown-seconds: 5
request-sound: ENTITY_EXPERIENCE_ORB_PICKUP
complete-sound: ENTITY_PLAYER_LEVELUP
countdown-sound: UI_BUTTON_CLICK
All in-game messages support MiniMessage tags, hover events, and custom hex colors.
Requirements
| Software |
Supported Versions |
| Server Engine |
Paper (1.21 – 1.21.11 & 26.1 – 26.3) |
| Java Runtime |
Java 21 or newer |
| Permissions |
LuckPerms 5.x (Optional) |
Support
Have an issue, question, or suggestion? Use the Discussions tab on this project page.
© undefinedX — All Rights Reserved. Redistribution, resale, or unauthorized modification of this software is strictly prohibited.
评论 0
登录后参与评分
还没有评论,来抢沙发吧