HNCore 内置了一个面向服主与开发者的 工具箱浏览器。它不是脚本管理页，而是一个用于快速查找和预览 Bukkit 枚举内容的 GUI。

入口命令

主命令仍然挂在 /hncore 下：

/hncore tools
/hncore tool
/hncore browser

• tools 是正式子命令名
• tool、browser 是别名
• 权限节点：hncore.command.tools

使用限制

这个命令 仅限玩家执行。

原因很直接：工具箱是一个可交互 GUI，会打开背包菜单，并在分类页里执行声音、粒子等预览。

一级菜单内容

当前工具箱首页提供 4 个分类：

分类	浏览内容	左键行为
Sound	Bukkit Sound 枚举	播放该声音给当前玩家
Particle	Bukkit Particle 枚举	在玩家前方生成粒子预览
Entity	Bukkit EntityType 枚举	仅显示安全说明，不直接生成实体
Material	Bukkit Material 枚举	查看材质图标与基础信息

首页还提供 全局搜索，可以跨全部分类找关键词。

分类页能做什么

进入任意分类后，底部会出现一整套浏览操作：

• 分类内搜索
• 清空搜索
• 上一页 / 下一页
• 快速跳页
• 返回一级分类菜单

每个条目都支持：

• 左键：执行该分类对应的预览动作
• 右键：复制当前条目的 ID

搜索行为

工具箱不是简单的纯枚举列表，它带有专门的搜索排序逻辑。

分类内搜索

分类搜索会匹配：

• 枚举 ID
• 显示名
• 条目详情文本
• 搜索别名字典映射结果

结果会按相关度排序，而不是原顺序硬过滤。

全局搜索

全局搜索会跨以下全部分类一起匹配：

• Sound
• Particle
• Entity
• Material

结果会额外显示所属分类，并按相关度排序。

搜索别名

工具箱会加载：

plugins/HNCore/toolbox-search-aliases.yml

这个文件里的每一组词会建立双向别名关系，方便处理中英文、复数形式或近义词匹配。例如：

• 音效 ↔ sound
• 粒子 ↔ particle
• 实体 ↔ entity
• 材质 ↔ material
• 僵尸 ↔ zombie
• 箱子 ↔ chest

当前文件默认已经内置多组：

• 分类词
• 常见实体词
• 常见材质词
• 常见粒子 / 音效词

别名字典什么时候生效

工具箱服务会在插件启用时读取 toolbox-search-aliases.yml。

因此如果你改了这个文件，最稳妥的做法是：

• 重启服务器，或
• 重新加载整个 HNCore（而不是只做 reload scripts）

聊天输入交互

搜索与跳页不是在 GUI 输入框里完成，而是通过聊天消息完成。

点击搜索或跳页按钮后，下一条聊天消息会被当作输入内容处理。

搜索输入

分类搜索与全局搜索都支持：

• cancel / 取消：取消输入并回到原页面
• clear / 清空：清空当前搜索

跳页输入

快速跳页支持：

• 输入具体页码
• last
• 末页
• 最后一页
• cancel / 取消

预览行为细节

Sound

左键后会直接把对应 Sound 播放给当前玩家，并在 ActionBar 显示当前声音 ID。

Particle

粒子预览会在玩家视线前方约 1.5 格位置生成。

对于需要额外数据的粒子，HNCore 会尽量使用默认测试数据：

• BlockData：默认石头方块数据
• ItemStack：默认钻石物品数据
• DustOptions：默认青色粉尘
• DustTransition：默认青色到洋红过渡
• Float / Integer / Color：使用默认测试参数

如果该粒子仍然不适合直接预览，工具箱会提示“需要额外数据，暂不支持直接预览”。

Entity

实体分类启用了 安全模式。

左键只会提示当前实体 ID，并不会直接在玩家面前生成实体，避免误刷怪。

Material

材质分类不会额外生成对象，当前 GUI 里的图标本身就是材质预览。

常用工作流

找一个声音或粒子做调试

/hncore tools

然后进入对应分类，搜索关键词并左键试听或预览。

查一个枚举 ID 用于配置

1. 打开工具箱
2. 搜索目标条目
3. 对目标条目右键
4. 点击聊天消息里的复制文本

不确定属于哪个分类

直接使用一级菜单里的 全局搜索 更省时间。

想优化中文搜索体验

直接维护：

plugins/HNCore/toolbox-search-aliases.yml

比如你经常搜“骷髅”“火焰”“材质”“方块”，就可以把这些词整理进别名字典组里。

与脚本命令的区别

• /hncore scripts ...：管理 Groovy 脚本的加载、启用与重载
• /hncore reload：重载主配置、storage.yml、实体映射、脚本系统与共享存储
• /hncore tools：查找并预览 Sound / Particle / Entity / Material

如果你想看脚本命令，继续阅读 命令说明。