SimpleTrading

插件

· 作者 JohnDingleSin

为你的 Minecraft 服务器添加一个简单的交易系统

0 本站下载 0 关注 更新于 1 个月前

最新 1.3.0 · 26.3 · Paper / Purpur

一键开服(送7天)

SimpleTrading

一款轻量级、简洁实用的 Paper 服务器交易插件。玩家可以发起交易请求,接受请求,并通过整洁的图形用户界面(GUI)交换物品。

[重要]:已添加对 26.3 版本的支持,但测试仍在进行中。如果您在使用 26.3 时遇到任何错误或问题,请通过我们的错误报告表单提交。

示例

功能特性

  • /trade <player> — 向附近的玩家发送交易请求。
  • /tradeaccept — 接受传入的交易请求。
  • /tradedecline — 拒绝传入的交易请求。
  • 双箱 GUI — 双方玩家看到相同的 54 格背包。一列屏障方块将两侧分开,防止任何人触碰对方的物品。
  • 玩家头颅 — 每位玩家的头颅位于其所在侧的顶部角落,以便您清楚哪一侧是自己的。
  • 接受 / 拒绝按钮 — 每位玩家在其所在侧的底部角落拥有独立的接受和拒绝按钮。只有双方都接受后,交易才会生效。
  • 5 秒接受冷却时间 — 当一名玩家从其交易栏位中添加或移除物品时,双方玩家的接受状态将被重置,并强制执行 5 秒冷却时间,之后才能再次接受。这可以防止玩家在最后一刻抽出物品来欺骗对方。
  • 取消时返还物品 — 如果交易被取消或拒绝,放置在 GUI 中的所有物品都将归还给原主。
  • 可配置的聊天颜色 — 插件发送的每条消息均根据配置进行着色(messages.success、messages.error、messages.info),因此您可以调整插件颜色以匹配您的服务器风格。
  • 可配置的 GUI 颜色 — gui.color 和 gui.decline-color 控制交易窗口中按钮和玩家头颅的颜色。
  • 可配置的 GUI 标题 — gui.title 设置交易窗口顶部的文本,支持 %player1% 和 %player2% 占位符。

命令

命令 描述 权限
/trade <player> 向指定玩家发送交易请求。 simpletrading.trade
/tradeaccept 接受待处理的交易请求。 simpletrading.tradeaccept
/tradedecline 拒绝待处理的交易请求。 simpletrading.tradedecline

别名:

  • /trade → /t
  • /tradeaccept → /ta
  • /tradedecline → /td

所有权限默认值为 true(任何人都可以进行交易)。


工作原理

  1. 发送请求
    玩家 A 输入 /trade PlayerB。如果玩家 B 在线、在范围内且未处于其他交易中,玩家 B 会收到一条消息,提示他们输入 /tradeaccept 或 /tradedecline。

  2. 接受交易
    玩家 B 输入 /tradeaccept。如果双方仍处于有效范围内且均未处于其他交易中,则交易 GUI 将同时向两名玩家打开。

  3. GUI 界面
    两名玩家均会看到一个双格箱子库存(共 54 个槽位)。中间有一列垂直排列的屏障方块(第 4 列)。玩家 A 的物品放置在左侧(第 0–3 列),玩家 B 的物品放置在右侧(第 5–8 列)。

    • 顶部角落: 玩家头像,用于标识各自的操作区域。
    • 您所在侧的左下角: 拒绝按钮(红色玻璃板)。
    • 您所在侧的右下角: 接受按钮(绿色玻璃板)。
    • 屏障列: 不可点击、不可移动。
  4. 交易操作
    玩家将物品从自己的库存拖拽至自己所属的交易 GUI 区域。他们无法触碰对方的物品、屏障、头像或不属于他们的按钮。

  5. 确认交易
    每位玩家点击各自的“接受”按钮。若双方均已确认,则交换物品:玩家 A 放入的所有物品归玩家 B 所有,反之亦然。若背包空间不足,多余物品将掉落至地面。

  6. 拒绝 / 取消交易
    若任意一方点击“拒绝”、关闭库存、超出有效范围或断开连接,交易将被取消,所有物品归还给原主。


配置

首次运行后,会在 plugins/SimpleTrading/config.yml 生成一个 config.yml 文件。

# 玩家发送/接受交易请求时彼此之间允许的最大距离(以方块为单位)。
# 设置为 -1 表示无距离限制。
trade-range: 10

# 是否在收到交易请求时通知玩家
notify-on-request: true

# 当玩家移动过远时是否取消交易
cancel-on-move: true

# 本插件发送聊天消息的颜色代码。
# 支持所有颜色代码:&0-&f 表示颜色,以及 &l(粗体)、&o(斜体)、&n(下划线)、
# &m(删除线)和 &k(随机字符)。若希望插件所有消息使用统一颜色,请将所有值设为相同代码。
messages:
  # 确认操作成功的消息(如请求已发送、交易完成等)
  success: '&a'
  # 提示操作失败的消息(如距离过远、已在交易中等待等)
  error: '&c'
  # 中性状态更新(有人已接受、物品发生变化等)
  info: '&e'

# 交易 GUI 本身的相关设置。
gui:
  # GUI 主色调:接受按钮和玩家头像的颜色。
  color: '&a'
  # 拒绝按钮及冷却状态(即“暂不可操作”状态)所使用的颜色。
  decline-color: '&c'
  # GUI 顶部显示的文字。%player1% 和 %player2% 会被替换为实际玩家名称。
  title: '&0Trading — %player1% &7x &0%player2%'

支持

如果您发现了 Bug、有功能建议或评论,请前往 表单

赞助者

ChunkHost

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源