问题排查

检查文件位于 Workspaces.paths 中、扩展名符合 filter，且未以 # 或 ! 开头。确认 YAML 缩进正确，并含 menu / title 与面板配置。不同目录中的菜单 ID 也需要唯一。

菜单默认 ID 来自文件名，也可由顶层 id 指定；绑定命令检查 command.name 与 aliases，确认没有其他插件占用。

确认 layout 字符与图标 ID 一致，箱子布局每行九格；slot 从 0 开始，按当前面板局部坐标计算。locate 指定面板起点，详见布局页。

检查 material 名称、customModelData / itemModel 值及当前版本支持情况。外部物品检查 source、value 和物品插件是否启用。

如果 Lore 是普通列表或 |- 多行文字，不需要增强换行。如果节点、占位符或单引号文字带有文字形式的 \n，将 enhancedLore: true 与 lore 放在同一显示配置中；使用 display 时两者都写在 display 下。写法见物品属性。

async 影响普通 Bukkit / Paper 自动启动的任务，不改变手动 task 调用的执行方式；Folia 自动任务也按玩家所属线程运行。同步网络读取仍会等待结果，具体范围见任务。

物品 color 不用于当前物品染色；命令参数 incorrectMessage 不用于自定义参数错误提示。命令没有权限时的提示配置在 command.permissionMessage。可用字段与限制见配置字段索引。

确认附魔为英文名称、等级为整数。文字隐藏时检查 HIDE_ENCHANTS、glow、hideTooltip 和导入物品已有属性。

确认 action 写在图标层，不在 display 内；检查点击类型、权限条件与语句内容。def 会和对应点击类型一起执行。后台日志会显示语句错误。

执行 icons relocate 再执行 icons update，或重新打开菜单。条件外观写在 sub 中，点击许可判断写在 action 中；生成器列表不使用 icons refresh 保留当前页。

方括号属性使用 fmsg，标签使用 mmsg；检查括号与引号完整。聊天点击命令包含 /，并需要发送者有权限。物品点击使用 action。

确认变量在图标生成前有值，例如在 pre_open 中初始化。图标文字使用 icon update / icons update，子状态变化按图标刷新页重新选择状态；标题文字变化使用 menu title update。PAPI 占位符需安装对应扩展，element_ 字段在生成器 output 中使用。

page 语句切换内容，固定导航的 sub 状态用 icon by 单独刷新。icons refresh 会使生成器回到第一页，不能作为保留当前页的导航更新，见生成器示例。

在线玩家等名单在打开时取得，重新打开菜单更新。regenerate 用于现有列表的筛选与排序；固定导航状态另用 icon by 更新。

reopen 用于输入成功后的重开；取消时需要在 onCancel 中配置 menu open 等动作。

暂停相关兑换操作，检查 storage del 是否删除输入、listener 与关闭事件是否重复发物品，并确认存储槽位按局部坐标设置。记录关闭、跳转或断线的具体触发步骤。