- 版权类型
- 原创
- 插件中文名称
- 双形态工具
- 插件英文名称
- ToolAxe
- 原帖地址
- #
- 支持的核心（服务端）
- Spigot
- Paper
- Folia
- Purpur
- Leaves
- 其他核心
- 语言支持
- 中文（简体）
- 适配版本（Java）
- 最新版本
- 26.x
- 1.21
ToolAxe 是一款面向 服务器的可视化自定义工具插件。它将工具创建、附魔配置、玩家绑定与时运/精准采集切换整合到游戏内菜单中，无需反复手改配置即可创建专属工具。
插件同时兼顾 Java 版与基岩版玩家：Java 玩家使用箱子 GUI，安装 Geyser 与 Floodgate 后，基岩版玩家可直接使用原生表单完成工具切换和管理操作。
核心技术亮点
1. 事件驱动架构
插件不会创建逐 Tick 扫描或固定周期同步任务。工具绑定、使用校验、形态切换和附魔记录全部由 Paper 事件触发；玩家背包也只会在打开菜单时进行一次有限扫描，避免产生无意义的后台性能消耗。
2. PDC 物品数据持久化
每件工具均通过 PersistentDataContainer 保存工具 ID、实例 UUID、绑定玩家、当前形态、数据版本及玩家新增附魔。工具数据直接跟随物品保存，不依赖物品名称或 Lore 判断，有效避免改名、铁砧操作或显示文本变化造成的识别错误。
3. 完整的绑定保护
工具可自动绑定至获得或首次使用它的玩家，其他玩家无法拿去挖掘、攻击、交互、钓鱼、穿戴或继续加工。插件同时处理背包操作、快捷栏交换、拾取、漏斗与发射器等常见绕过途径；管理员可通过 `toolaxe.admin` 权限管理或使用任意绑定工具。
4. Java / 基岩双端界面
Java 玩家使用完整的箱子 GUI 创建、编辑和切换工具。安装 Floodgate 后，基岩版玩家将优先收到 Cumulus 原生表单；Floodgate 未安装、版本不兼容或表单发送失败时，会自动回退到箱子 GUI，不影响插件的基础功能。
5. 附魔数据安全
管理员预设的附魔与玩家后续通过附魔台、铁砧添加的附魔分开保存。切换时运和精准采集形态时，玩家新增的合法附魔不会丢失，并会在物品 Lore 中单独显示名称、等级与效果说明。
核心功能
双形态一键切换： 斧头、镐子、锄头和铲子支持在时运与精准采集之间切换，可使用 `/tool` 打开菜单，也可在主手持有工具时潜行右键快速切换。
同类工具同步切换：通过玩家菜单选择某个工具后，背包中所有相同工具 ID 的实例会统一切换至同一形态，无需逐件操作。
可视化工具创建：管理员可在游戏内创建、编辑、预览、领取和删除工具，并配置显示名称、多行 Lore、物品类型与附魔等级。
多种装备类型：支持剑、头盔、胸甲、鞘翅、护腿、靴子、斧头、镐子、锄头、铲子和钓竿。其中斧头、镐子、锄头和铲子支持双形态切换。
自定义高等级附魔：管理菜单可配置服务器当前版本提供的附魔，支持 `1～255` 级；附魔列表带中文名称与效果说明，并支持分页管理。
玩家专属绑定： `/tool give` 发放的工具会按规则绑定至目标玩家，未绑定工具也可在首次使用时自动绑定。管理员创造模式下可配置为保持未绑定，方便制作和分发。
附魔台与铁砧兼容： 已绑定玩家仍可通过原版附魔台或铁砧继续强化工具，插件会保留工具身份、绑定信息、当前形态以及新增附魔。
自定义物品显示： 名称与描述支持传统 `&` 颜色代码和 MiniMessage 标签；形态、绑定者、附魔等级及效果说明均可通过配置文件自定义显示。
配置热重载：`config.yml` 与 `tools.yml` 均可通过指令重新加载，无需重启服务器。若 `tools.yml` 格式错误，插件会保留内存中当前可用的工具定义，避免错误配置直接覆盖运行数据。
插件指令
`/tool` - 打开背包工具形态切换菜单
`/tool admin` - 打开管理员工具创建与管理菜单
`/tool give <工具ID> <在线玩家>` - 向指定在线玩家发放工具
`/tool list` - 查看所有已创建工具的 ID 与显示名称
`/tool reload` - 热重载主配置与工具定义
完整命令也可使用 `/toolaxe`，并支持 `/ta` 别名及 Tab 补全。
权限节点
`toolaxe.use` - 使用玩家菜单与 ToolAxe 工具，默认所有玩家拥有
`toolaxe.admin` - 使用管理员菜单、管理指令并无视工具绑定，默认仅 OP 拥有
插件同时兼顾 Java 版与基岩版玩家：Java 玩家使用箱子 GUI，安装 Geyser 与 Floodgate 后，基岩版玩家可直接使用原生表单完成工具切换和管理操作。
核心技术亮点
1. 事件驱动架构
插件不会创建逐 Tick 扫描或固定周期同步任务。工具绑定、使用校验、形态切换和附魔记录全部由 Paper 事件触发；玩家背包也只会在打开菜单时进行一次有限扫描，避免产生无意义的后台性能消耗。
2. PDC 物品数据持久化
每件工具均通过 PersistentDataContainer 保存工具 ID、实例 UUID、绑定玩家、当前形态、数据版本及玩家新增附魔。工具数据直接跟随物品保存，不依赖物品名称或 Lore 判断，有效避免改名、铁砧操作或显示文本变化造成的识别错误。
3. 完整的绑定保护
工具可自动绑定至获得或首次使用它的玩家，其他玩家无法拿去挖掘、攻击、交互、钓鱼、穿戴或继续加工。插件同时处理背包操作、快捷栏交换、拾取、漏斗与发射器等常见绕过途径；管理员可通过 `toolaxe.admin` 权限管理或使用任意绑定工具。
4. Java / 基岩双端界面
Java 玩家使用完整的箱子 GUI 创建、编辑和切换工具。安装 Floodgate 后，基岩版玩家将优先收到 Cumulus 原生表单；Floodgate 未安装、版本不兼容或表单发送失败时，会自动回退到箱子 GUI，不影响插件的基础功能。
5. 附魔数据安全
管理员预设的附魔与玩家后续通过附魔台、铁砧添加的附魔分开保存。切换时运和精准采集形态时，玩家新增的合法附魔不会丢失，并会在物品 Lore 中单独显示名称、等级与效果说明。
核心功能
双形态一键切换： 斧头、镐子、锄头和铲子支持在时运与精准采集之间切换，可使用 `/tool` 打开菜单，也可在主手持有工具时潜行右键快速切换。
同类工具同步切换：通过玩家菜单选择某个工具后，背包中所有相同工具 ID 的实例会统一切换至同一形态，无需逐件操作。
可视化工具创建：管理员可在游戏内创建、编辑、预览、领取和删除工具，并配置显示名称、多行 Lore、物品类型与附魔等级。
多种装备类型：支持剑、头盔、胸甲、鞘翅、护腿、靴子、斧头、镐子、锄头、铲子和钓竿。其中斧头、镐子、锄头和铲子支持双形态切换。
自定义高等级附魔：管理菜单可配置服务器当前版本提供的附魔，支持 `1～255` 级；附魔列表带中文名称与效果说明，并支持分页管理。
玩家专属绑定： `/tool give` 发放的工具会按规则绑定至目标玩家，未绑定工具也可在首次使用时自动绑定。管理员创造模式下可配置为保持未绑定，方便制作和分发。
附魔台与铁砧兼容： 已绑定玩家仍可通过原版附魔台或铁砧继续强化工具，插件会保留工具身份、绑定信息、当前形态以及新增附魔。
自定义物品显示： 名称与描述支持传统 `&` 颜色代码和 MiniMessage 标签；形态、绑定者、附魔等级及效果说明均可通过配置文件自定义显示。
配置热重载：`config.yml` 与 `tools.yml` 均可通过指令重新加载，无需重启服务器。若 `tools.yml` 格式错误，插件会保留内存中当前可用的工具定义，避免错误配置直接覆盖运行数据。
插件指令
`/tool` - 打开背包工具形态切换菜单
`/tool admin` - 打开管理员工具创建与管理菜单
`/tool give <工具ID> <在线玩家>` - 向指定在线玩家发放工具
`/tool list` - 查看所有已创建工具的 ID 与显示名称
`/tool reload` - 热重载主配置与工具定义
完整命令也可使用 `/toolaxe`，并支持 `/ta` 别名及 Tab 补全。
权限节点
`toolaxe.use` - 使用玩家菜单与 ToolAxe 工具，默认所有玩家拥有
`toolaxe.admin` - 使用管理员菜单、管理指令并无视工具绑定，默认仅 OP 拥有
