ItemSoulBind - 物品灵魂绑定

💡简介

SoulBind 是一款用于将物品与玩家或权限组绑定的插件，确保物品的专属使用并提供多种保护机制。你可以通过命令直接绑定，或将其无缝集成到你的礼包和任务系统中，以丰富游戏设计。

🎮功能特性

• 绑定类型：可将物品绑定给单个玩家，或绑定给一个权限组，供拥有该权限的多个玩家使用。
• 全面保护：防止未授权玩家拾取、从容器中取出或移动灵魂绑定物品。
• 死亡保留：拥有特定权限的玩家，其灵魂绑定物品在死亡时可保留在物品栏中。
• 礼包集成：物品描述（Lore）中包含注册字符串（默认为 %soulbind%，可配置）时，玩家点击、丢弃或拾取该物品即会自动绑定。可通过命令强制扫描并绑定玩家物品栏中所有此类物品，非常适合在发放礼包后使用。
• 条件绑定：支持仅在物品被使用、装备或拾取时才进行绑定。
• 操作限制：防止灵魂绑定的方块被放置，或物品被用于合成、附魔及铁砧操作。
• 远程绑定：可远程绑定目标玩家物品栏中的物品。

🔧命令列表

绑定与解绑

• /bindItem <玩家名> - 将主手持有的物品绑定给指定玩家。
• 权限：itemsoulbind.bind
• /bindAll - 绑定自己物品栏中的所有物品。
• 权限：itemsoulbind.bindall
• /unbindItem - 移除主手持有物品的灵魂绑定。
• 权限：itemsoulbind.unbind
• /groupBindItem <权限名> - 将主手持有的物品绑定给所有拥有 itemsoulbind.group.<权限名> 权限的玩家。
• 权限：itemsoulbind.groupbinditem
• /remoteBindItem <玩家> slot|0-40|all - 远程绑定指定玩家物品栏中特定槽位（0-40）或所有物品。
• 权限：itemsoulbind.remotebind

物品栏操作

• /bindInvItems <玩家名> - 扫描指定玩家的物品栏，并绑定所有描述中含有注册字符串的物品。
• 权限：itemsoulbind.bindinvitems
• /returnItems - 取回系统发现的、属于你但被其他玩家持有的灵魂绑定物品。
• 权限：itemsoulbind.returnitems

特殊绑定模式

• /bindOnUse - 将主手持有的物品设置为“使用时绑定”。
• 权限：itemsoulbind.admin
• /bindOnEquip - 将主手持有的物品设置为“装备时绑定”。
• 权限：itemsoulbind.admin
• /bindOnPickup - 将主手持有的物品设置为“拾取时绑定”。
• 权限：itemsoulbind.admin

管理

• /isb-reload - 重载插件配置（仅控制台可用）。
• 权限：itemsoulbind.admin

✨权限节点

管理员权限

• itemsoulbind.admin - 拥有所有权限，并可重载配置。
• 默认：OP

核心使用权限

• itemsoulbind.bind - 允许使用 /bindItem（仅限自己）。
• itemsoulbind.bind.others - 允许使用 /bindItem <玩家>（为他人绑定）。
• itemsoulbind.bindall - 允许使用 /bindAll。
• itemsoulbind.unbind - 允许使用 /unbindItem。
• itemsoulbind.groupbinditem - 允许使用 /groupBindItem。
• itemsoulbind.remotebind - 允许使用 /remoteBindItem。
• itemsoulbind.bindinvitems - 允许使用 /bindInvItems。
• itemsoulbind.returnitems - 允许使用 /returnItems。
• 默认：true

功能权限

• itemsoulbind.notify - 当玩家物品栏中出现绑定给其他人的物品时收到通知。
• itemsoulbind.keepondeath - 死亡时灵魂绑定物品保留在物品栏中。
• itemsoulbind.bypass - 绕过所有灵魂绑定保护、注册字符串检查及操作限制（合成、附魔、铁砧）。
• itemsoulbind.bypass.craft - 仅绕过合成限制。
• itemsoulbind.bypass.enchant - 仅绕过附魔限制。
• itemsoulbind.bypass.anvil - 仅绕过铁砧限制。

⭐配置详解

绑定识别字符串

• registerString: "%soulbind%" - 物品描述中出现此字符串时，会在交互时绑定给玩家。
• groupRegisterString: "%soulbindgroup%" - 用于组绑定的识别字符串，后面需跟上权限名（如 %soulbindgroup%perm 对应权限 itemsoulbind.group.perm）。

特殊绑定模式

• bindOnUse: false - 是否启用“使用时绑定”。
• bouString: "&9Soul binds on use" - 对应的识别文本。
• bindOnEquip: false - 是否启用“装备时绑定”。
• boeString: "&9Soul binds on equip" - 对应的识别文本。
• bindOnPickup: false - 是否启用“拾取时绑定”。
• bopString: "&9Soul binds on pickup" - 对应的识别文本。

视觉效果与提示

• disableEffects: false - 禁用绑定时的粒子与音效。
• displayLoreMsg: true - 是否在绑定物品的描述中显示提示。
• loreMsg: "&9Soul bound to %username%" - 提示文本，%username% 为玩家名占位符。
• displayLoreMsgGroup: true - 是否在组绑定物品的描述中显示提示。
• loreMsgGroup: "&9Soul bound to group %group%" - 提示文本，%group% 为权限组占位符。

保护与限制

• preventPlacing: false - 防止放置灵魂绑定的方块。
• preventCraft: false - 防止使用灵魂绑定物品进行合成。
• preventEnchant: false - 防止对灵魂绑定物品进行附魔。
• preventAnvil: false - 防止在铁砧中使用灵魂绑定物品。
• blockedCommands: - 当手持灵魂绑定物品时，阻止执行以此列表内容开头的命令（例如 "auction" 会阻止 /auction sell）。

消息与日志

• consoleLogDetection: true - 在控制台记录检测到玩家持有他人绑定物品的事件。
• 所有消息文本（如 denyMsg, bindSuccess 等）均可使用 & 颜色代码自定义。

❓支持与说明

• 支持：可通过 Discord 获取帮助。
• 问题反馈：请在此处报告漏洞和利用方式。
• 开发贡献：欢迎访问 GitHub 和项目看板。
• 统计说明：本插件使用 bStats 收集匿名的使用统计数据。