插件介绍

MythicBind 会自动检测玩家背包中的 MMOItems 物品,并为满足规则的物品写入 Soulbound(灵魂绑定)数据,使物品绑定到当前玩家(可配置绑定等级 1-3)。支持多种“检测触发点”,并提供冷却/缓存等性能优化选项。

主要功能

  • 默认绑定等级 —— default-soulbound-level(范围 1-3)
  • 按类型绑定 —— auto-bind-types 支持三种模式:全绑定 / ids 白名单 / exclude-ids 黑名单
  • 多触发点检测 —— 拾取、加入服务器、打开背包等(可分别开关)
  • 强制刷新显示 —— 解决“手持物品不显示 lore”的客户端刷新问题(refresh-mode)
  • 性能优化 —— 玩家检查冷却、物品缓存、可选定期巡检

配置文件

配置文件路径:plugins/MythicBind/config.yml

YAMLconfig.yml
default-soulbound-level: 3

auto-bind-types:
  SWORD: {}
  ARMOR: {}
  MATERIAL_FB:
    exclude-ids:
      - 虚空石

check-on-item-pickup: true
check-on-join: true
check-on-inventory-open: true
check-delay: 5

periodic-check-interval: 0
player-check-cooldown: 3
item-cache-duration: 60
notify-player-on-bind: true
refresh-mode: UPDATE_INVENTORY

触发时机

  • 拾取/获取物品 —— check-on-item-pickup,包含多种 GUI/合成站/容器流转场景
  • 进服检查 —— check-on-join,确保老物品也会被补绑
  • 打开背包 —— check-on-inventory-open,可捕获部分命令/GUI给予物品

性能建议

  • 冷却 —— player-check-cooldown 建议 3-5 秒(人多可适当提高)
  • 缓存 —— item-cache-duration 建议 30-120 秒
  • 整理背包检测 —— check-on-inventory-organize 默认关闭(开启可能严重影响性能)
  • 定期检查 —— periodic-check-interval 设为 0 表示禁用;只建议当你怀疑仍有遗漏时开启

依赖插件

插件是否必须说明
MMOItems必须提供 MMOItems API 与 Soulbound 数据