重构

菜单按钮动作体系重构为 triggers 动作列表写法，按点击类型 left right shift_left shift_right 分发，列表内按顺序执行

通用动作支持 close sound command op console message open delay，业务动作统一为小写下划线风格如 open_category prev_page save_recipe

旧版 action 单值写法完全兼容，自动映射为新动作，已有配置无需修改

按钮动作渲染时写入物品数据，点击时零配置查询，单个动作执行异常只记录日志，不再中断后续动作

新增

close 关闭菜单后，后续动作默认延迟 1 tick 再执行，显式 delay 在此基础上累加，如 close 加 delay 5 等于 6 tick 后执行

按钮点击冷却防连点，config.yml 新增 features.button-cooldown-seconds，默认 0.3 秒，设 0 关闭

默认点击音可配置，config.yml 新增 features.default-button-sound，按钮 sound 支持名称-音量-音调写法和分号串联多个音效

menu.yml 和 recipesmenu.yml 新增 config_version 2，更新后首次启动自动迁移旧配置，旧文件自动备份为 bak，只补缺失的新键，自定义修改全部保留

新增动作解析单元测试 14 个用例，mvn test 自动执行，锁定解析行为

修复

主菜单配方计数与实际不一致，count 现在只统计玩家实际能看到的配方条目数，已隐藏的不计入，同一物品多种合成方式只算一条，与列表条目数和翻页总数严格一致

无效音效名和未知动作类型改为只警告一次，不再每次点击刷控制台日志

纯装饰按钮如背景玻璃不再播放点击音效

优化

管理端主菜单保持显示配方总数并附已隐藏数量，方便管理

延迟动作统一走 FoliaLib 调度器，完整兼容 Folia

GUI 监听器精简为纯路由层，删除五个按菜单类型分散的巨型分支处理

ALCERecipeViewer 更新

2026/08/08

- 新增配方隐藏/显示管理：管理员可通过 /alcerecipes admin（或 manage）切换配方可见性，状态保存至 hidden_recipes.yml，
重启后仍会保留。
- 普通玩家的分类浏览与搜索将自动过滤隐藏配方；管理员仍可查看全部配方。
- 改进 CraftEngine 兼容性：支持多种 CE 实例结构，并统一通过 CE ClassLoader 加载相关类。
- 支持 CraftEngine 重载自动同步：CE 加载或 reload 后自动刷新配方、名称与翻译缓存，并避免并发刷新覆盖。
- 优化多语言名称缓存与物品转换错误处理，减少中英文名称串用和重复控制台日志。
- 配方主菜单、列表与详情菜单打开时，玩家背包区域的任何点击操作都会被取消。

ALCERecipeViewer 更新

2026/07/25

修复玩家背包偶发无法操作问题

ALCERecipeViewer 更新

2026/07/22

已修复合成表菜单物品保护问题：

- 玩家无法再将物品放入插件菜单，防止物品被菜单吞掉
- 玩家无法在菜单打开时移动背包物品

ALCERecipeViewer 更新

2026/07/05

新增：按钮自定义命令与点击音效功能
---- 自定义命令按钮示例（将 Z 加入 shape 即可启用）----
Z: #按钮编号名字
material: "BOOK"
name: "&6Wiki"
lore:
- "&7打开Wiki页面"
action: "RUN_COMMAND" #按钮行为（RUN_COMMAND设置后，下方必须添加command:）
command: "wiki open" #自定义命令
as_player: true #true=以玩家身份执行，false=控制台（{player}=玩家名）
sound: "block.note_block.pling" #点击音效，支持原版声音（如 block.note_block.pling）或 CE 自定义声音（如 namespace:sound_id）不填默认使用 block.note_block.pling

修复：按钮无法设置CE材质问题，现在 material: "材质命名空间:材质ID" 如 "namespace:item_id"

反馈： XruiDD 和 119

ALCERecipeViewer 更新

2026/07/04

新增：搜索模式切换
右键点击搜索按钮（指南针），可在两种搜索模式间切换：
- 成品名称 — 搜索配方产出的物品（默认）
- 材料名称 — 搜索配方使用的原料
▎ 例：羊毛合成金苹果的配方，材料模式下搜"羊毛"即可找到。

新增：配置文件自动补全
插件更新后，新增的配置项会自动写入配置文件，不再需要手动删除旧配置。（如遇错误，还需重新删除配置！）

修复：服务器启动时 FoliaLib 类找不到的问题。