TradeUI - 便捷交易插件

TradeUI 是一款简洁的玩家交易插件，它允许玩家通过一个直观的库存界面进行物品交换。玩家可以通过命令或简单的交互发起和接受交易请求。

💡重要须知

• 如需在 1.14 或 1.15 版本上运行此插件，请务必在配置文件中修改 version 选项。
• 本插件由人工编写，不保证完全没有错误，请自行承担使用风险。
• 请将发现的任何漏洞报告至 GitHub Issues 或插件的讨论区。

🎮功能概述

TradeUI 让玩家可以通过一个库存菜单界面进行交易。一切从发送交易请求开始。

发起与接受交易

• 玩家可以通过 Shift + 右键点击 另一名玩家来发送交易请求。
• 也可以使用 /trade <玩家名> 命令来发送请求。
• 同一时间只能有一个活跃的交易请求。
• 对方玩家必须在限定时间内接受请求，交易才能开始。
• 如果请求超时，或任何一方走远，请求将被自动取消。

进行交易

• 交易开始后，双方会打开交易菜单。
• 在菜单左侧放入你想要交易的物品。
• 在菜单右侧预览你将收到的物品。
• 菜单底部各有一个接受按钮。当双方都点击按钮变为绿色后，交易即刻完成，物品自动交换。
• 如果任何一方在交易过程中关闭菜单，交易将被取消，所有物品会返还给原主人。

🔧命令与权限

命令列表

• /trade <player> – 向指定玩家发送交易请求，或接受其请求。
• /trade accept <player> – 接受指定玩家的交易请求。
• /trade deny <player> – 拒绝指定玩家的交易请求。
• /trade cancel – 取消你已发送的交易请求。
• /trade reload – 重载整个插件（包括配置文件）。

权限节点

• trade_ui.trade – 玩家发送和接受交易请求所必需的权限。
• trade_ui.reload – 授予使用 /trade reload 命令的权限。

⭐配置文件详解

配置文件更新后，需要您手动更新配置文件以使用新选项（除非您不想使用它们）。

config.yml 主要选项

# 日志记录级别：DEBUG -> INFO -> WARN -> SEVERE
logger-priority: INFO

# 是否允许使用命令进行交易
allow-commands: true

# 是否允许通过 Shift+右键点击进行交易
allow-shifting: true

# 是否要求玩家拥有 trade_ui.trade 权限才能交易
require-trade-permission: true

# 最大交易距离，设为 -1 则无距离限制
max-trade-distance: 15

# 交易请求超时时间（秒）
trade-request-timeout: 20

# 玩家走远时是否自动取消请求
cancel-request-on-walk-away: true

# 是否允许玩家与自己交易（警告：仅用于测试，开启可能导致插件异常）
allow-self-trading: false

# 服务器主要运行版本（例如：1.16.x 填写 116）
version: 116

lang.yml 语言文件

此文件用于自定义插件发送的所有消息。

• 使用 & 符号进行颜色代码格式化（例如 &a 代表绿色）。
• 使用 [Player]、[Timeout]、[Permission] 作为消息变量，它们会被实际值替换。
• 使用 \n 来添加换行符。

❓常见问题与限制

本插件不支持的功能

为了保持简洁易用，TradeUI 不支持以下功能，并且未来也不会添加：

• 交易玩家经验值（EXP）。
• 直接交易经济插件中的货币。

替代方案建议

如果您需要交易经验或货币，建议使用以下类型的插件作为替代方案：

• 经验瓶插件：将经验存储为可交易的物品（经验瓶）。
• 银行票据插件：将货币转换为可交易的物品（银行票据）。

这是一种更直观且受支持的方式。

✨统计与链接

• bStats 统计页面：https://bstats.org/plugin/bukkit/TradeUI/7321