ВЕРСИИ (3)

https://github.com/polang233/GoodsTrade/releases

### 主要改动 - 支持 Vault、PlayerPoints、ExcellentEconomy 和原版经验等级，同一笔交易可同时加入多种货币。经验按整数等级支付，保留经验条进度。 - 左键中央栏切换交易类型，保留已设置的数量，并显示双方需要支付的内容。金币、点券、经验等级和代币分别使用金锭、绿宝石、经验瓶和向日葵作为默认按钮。 - 修改物品或支付数量后撤销已有确认；支付失败时返还物品，并尝试退回已完成的款项。 - 修复交易请求来源与过期校验、管理员直接交易、代发权限和负数倒计时问题。 - 修复自定义按钮只更换材质时丢失名称与 Lore 的问题。分档按钮继承通用样式，自定义中央栏保留切换提示和支付明细。 ### 配置变更 - `config.yml` 新增 `Trade.Economy.Currencies`，每种类型可设置 `Enable`、`Provider`、`Name` 和 `Amounts`。旧配置继续使用 Vault，点券、代币和经验等级需按需开启。 - 经验等级使用 `Provider: experience`；ExcellentEconomy 使用 `Provider: excellenteconomy`，并填写已有币种的 `Currency` ID。同一底层账户只配置一次。 - `View.yml` 新增 `currency-defaults` 和 `currency-buttons`，可按经济类型或币种 ID 设置材质、名称、Lore、模型数据及分档外观。原有 `button.Money`、`Money-1` 至 `Money-4` 继续生效，具体币种配置优先。 - 名称和 Lore 支持 `%amount%` 和 `%currency%`，只改材质会继承其余样式。若通用 `Money` 已写死材质，移除该字段或设为 `@default@` 后即可使用按类型的默认物品。 - 新增切换提示位于语言文件的 `trade-view.currency-selected` 和 `trade-view.currency-switch`。旧语言文件缺少这些键时自动使用内置内容；自定义 Lore 中写死的“金币”等文字需要自行调整。 [默认配置](https://github.com/polang233/GoodsTrade/blob/1.1.9/src/main/resources/config.yml) · [界面配置](https://github.com/polang233/GoodsTrade/blob/1.1.9/src/main/resources/View.yml) · [使用说明](https://github.com/polang233/GoodsTrade/blob/1.1.9/README.md)

## 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 分支](https://github.com/polang233/GoodsTrade/tree/lite) · [英文文档](https://github.com/polang233/GoodsTrade/blob/lite/doc/README_EN.md) · [Modrinth 文案](https://github.com/polang233/GoodsTrade/blob/lite/doc/MODRINTH.md)