HyBindItem

HyBindItem

HyBindItem 为你的 Hytale 服务器添加了玩家 UUID 物品绑定功能。
一旦物品被绑定，只有所有者可以保留/使用它。如果非所有者获取了该物品（拾取、箱子转移、交易等），插件会强制执行所有权并防止盗窃。

---

✅ 功能

🔒 绑定与所有权

• 将物品绑定至玩家 UUID（仅所有者可使用/持有）。
• 防重新绑定保护：已绑定的物品不能被其他玩家重新绑定。
• 通过物品栏 + 容器交易生效，不仅限于地面拾取。

🛡️ 防盗窃强制执行

如果非所有者获得了绑定的物品，会立即强制执行：

• 从非所有的物品栏中移除（或通过回滚恢复，如果可能）。
• 返还给所有者（待返系统），或根据服务器配置丢弃在非所有者附近。
• 防范箱子转移、Shift+点击移动、快捷栏互换等边缘情况。

🔁 可靠返还系统（全物品栏安全）

如果所有者物品栏已满，而物品应返还时：

• 物品会被保存在待返队列中。
• 插件会自动重试返还。
• 所有者会收到通知：
  • 立即通知 1 次：尝试返还您的绑定物品，但您的物品栏已满。
  • 然后每 5 秒通知 2 次，最多 10 轮。
  • 一旦有空间 → 物品返还，通知停止。

🔔 通知

• 当有人试图拿走所有者的绑定物品时，所有者会收到通知：
  • "{玩家} 试图拿走您的 {物品}。"

📋 绑定列表

• /bindlist — 显示你拥有多少绑定物品及其名称。
• /bindlist <玩家名> — 管理员查看指定玩家的绑定列表。

---

💬 命令

• /binditem — 将手中的物品绑定到你的 UUID（仅所有者）。
• /bindinfo — 显示手中物品被绑定给谁。
• /unbinditem — 解绑手中物品（仅所有者，管理员可覆盖）。
• /bindlist — 列出你的绑定物品。
• /bindlist <玩家名> — 列出其他玩家的绑定物品（管理员）。

---

🔑 权限

• hybinditem.command.binditem
• hybinditem.command.bindinfo
• hybinditem.command.unbinditem
• hybinditem.unbind.override （可选的管理员覆盖）
• hybinditem.command.bindlist
• hybinditem.command.bindlist.admin

---

⚙️ 数据/存储

• 持久的绑定数据存储在：
  • mods/HyBindItem/bound_items.json5
• 待返数据存储在：
  • mods/HyBindItem/pending_returns.json5

---

🧩 备注

• 专为生存 / RPG / 经济类服务器设计，这些服务器需要所有权保护和防盗。
• 建议：除非诊断问题，否则保持 debug: false。