GoodsTrade

GoodsTrade Lite 1.1.7

本次版本新增 Vault 金币交易、管理员沙盒测试和更完整的命令帮助，并加强交易确认阶段的安全处理。适合从 1.1.5 Lite 直接升级。

热修复

• 修复 Paper 26.x 上蹲下右键无法向其他玩家发起交易的问题。新核心只触发 PlayerInteractAtEntityEvent，旧版父类监听收不到事件。

Vault 金币交易

• 交易双方可通过 GUI 金币按钮调整各自需要支付的金额。
• 支持配置 1–4 档按钮金额；左键增加、右键减少。
• 可通过 Trade.Economy.Allow-Negative 控制是否允许负数报价；负数表示要求对方支付。
• 中央分隔板会同时显示双方最终需要支付的金额。
• 每次改价、确认和最终结算前都会检查余额，余额不足时不会允许超额报价或完成交易。
• Vault 或经济插件不可用时自动隐藏金币按钮，原有物品交易不受影响。

交易安全与确认流程

• 任一方修改金币报价后，已有确认会被撤销并通知另一方重新检查。
• 双方确认后的倒计时期间继续锁定物品与金额，避免最后一刻偷偷改价。
• 结算失败时不会交换物品，并会返还交易界面中的物品。
• 增强拖拽和双方交易区域的权限检查，保持原有物品交易流程安全。

管理员沙盒与命令帮助

• 新增 /gt test [虚拟玩家名]，管理员可独自控制交易双方区域、金额按钮和确认流程。
• 沙盒交易不会调用 Vault，也不会实际转移金币或物品；测试物品会在结束时返还。
• /gt 默认帮助现在显示各子命令的功能描述，并按玩家权限过滤。
• 命令说明、测试提示和金币交易文案均可在语言文件中修改。

兼容性

• Minecraft：1.12 – 26.1
• 服务端：Bukkit / Spigot / Paper
• Java：8 及以上
• PlaceholderAPI：可选
• Vault 与支持 Vault 的经济插件：仅金币交易需要；未安装时仍可正常交易物品
• 当前 Lite 版不声明 Folia 兼容

升级提示

1. 建议先备份 plugins/GoodsTrade/。
2. 停止服务器并用本版本 JAR 替换旧文件。
3. 已有 config.yml、View.yml 和语言文件不会被覆盖；如需调整金币按钮，请参考新版默认配置补充 Trade.Economy，并在 View.yml 中配置 Money、Money-1 至 Money-4。
4. 金币交易需要同时安装 Vault 和已接入 Vault 的经济插件；不使用金币交易时可保持未安装，或将 Trade.Economy.Enable 设为 false。
5. 升级后建议先使用 /gt test [虚拟玩家名] 检查金额按钮、负数报价和确认倒计时流程，再开放给普通玩家。

查看 Lite 分支 · 英文文档 · Modrinth 文案