OmniTool [The Ultimate Multitool Plugin] - OmniTool 全能工具插件

OmniTool 是一款免费的多功能工具插件，为你的服务器提供一把能自动切换形态、适应各种操作的全能工具。

💡核心功能

玩家手持 OmniTool 时，工具会根据当前操作自动切换为最高效的形态：

• 挖掘：镐
• 铲土：锹
• 砍树：斧
• 锄地：锄
• 清除树叶：剪刀
• 战斗、破坏蜘蛛网或竹子：剑

🎮命令与权限

命令列表

• /omni gui [玩家] - 为指定玩家打开工具配置界面
• /omni <玩家> <效率> <耐久> <时运> <锋利度> [显示名称] - 直接生成一把自定义属性的 OmniTool
• /crystal <玩家> [成功率] - 给予玩家一个 OmniCrystal（成功率默认 100）
• /extractor <玩家> - 给予玩家一个 OmniExtractor

权限节点

• omni.tool - 使用 OmniTool 的基础权限
• omni.crystal - 使用 OmniCrystal 的权限
• omni.extractor - 使用 OmniExtractor 的权限
• omni.reload - 重载插件配置的权限

🔧自定义模型数据 (CustomModelData)

适用于 1.14+ 的服务器版本。

启用与配置

• 更新至最新版插件，并备份现有配置。
• 在 config.yml 中将 tool.useCustomModelData 设置为 true。
• 在 tool.customModelData 部分，为每个工具等级（木、石等）设置不同的 customModelData 数值。
• 配套的资源包需要你按常规方式自行制作和配置。

调试与验证

在配置中启用 debug-mode 后，执行 /nbtdebug 命令可以查看物品的 CustomModelData 标签。这有助于验证你的资源包是否正确加载了每个工具的外观。

重要提示

初次设置后，如果更改了 CustomModelData 数值，所有已存在的 OmniTool 将在下一次状态更新时（如破坏方块或攻击实体）自动应用新的数据。

✨开发者 API

插件提供了丰富的 API 供开发者集成和扩展。

物品判断方法

• isOmniTool(ItemStack item) - 判断物品是否为 OmniTool，返回布尔值
• isOmniCrystal(ItemStack item) - 判断物品是否为 OmniCrystal，返回布尔值
• isOmniExtractor(ItemStack item) - 判断物品是否为 OmniExtractor，返回布尔值

自定义工具表

• addBlockToTable(ToolType type, Material material) - 向指定工具类型添加新的可挖掘方块
• removeBlockFromTable(ToolType type, Material material) - 从工具表中移除特定方块，实现更个性化的支持列表

实用方法

• openOmniToolBuilder(Player player) - 为在线玩家打开 OmniTool 构建界面
• getOmniCrystal(int success) - 根据指定成功率生成一个 OmniCrystal
• getOmniExtractor() - 生成一个 OmniExtractor

事件

• OmniCrystalApplyEvent - 玩家将 OmniCrystal 应用到物品上时触发
• OmniExtractorApplyEvent - 玩家将 OmniExtractor 应用到 OmniTool 上时触发
• OmniToolChangeEvent - OmniTool 状态改变时触发

⭐配置与本地化

你可以在配置文件中修改工具和晶体的描述文本（Lore）。

• 主配置：config.yml - 查看示例
• 模型数据配置：customModelData.yml - 查看示例
• 消息文件：messages.yml - 查看示例

❓常见问题与说明

性能与依赖

当前版本插件已完全无需任何外部依赖库，这显著提升了插件性能，提供了更优化的解决方案。

问题反馈

如果你遇到任何漏洞（Bug）

• 请勿在评论中直接报告。
• 请通过本网站发送私信（PM），或在 Discord 上联系我（@subnet.mask），我会尽快修复并发布更新。

服务器展示

如果你的服务器正在使用此插件，欢迎在 Discord 上联系我（@subnet.mask），我可以将你的服务器展示在这里！

即将推出的功能 (2025年5月6日更新前瞻)

• 自动将掉落物收入背包
• 游戏内方块支持表（BlockTables）GUI
• 游戏内插件配置 GUI
• 更丰富的开发者 API
• （欢迎通过 Discord @subnet.mask 私信我，提议新功能）