文件目录与菜单 ID
保存菜单文件，确认菜单 ID，并让修改生效。
默认目录
菜单文件放在 plugins/Invero/workspace/，每个文件对应一份菜单，也可以放进子目录分类：
config.yml · 主配置
hello.yml
使用 YAML 时，将文件保存为小写扩展名 .yml 或 .yaml。更改菜单目录、加载其他格式或排除文件，见工作空间与文件筛选。
ID 与标题
| 内容 | 示例 | 用途 |
|---|---|---|
| 文件名 | hello.yml | 在服务端保存和编辑配置 |
| 菜单 ID | 默认是 hello | 打开命令、菜单跳转和菜单列表 |
| 窗口标题 | menu.title | 玩家看到的文字 |
省略顶层 id 时，菜单 ID 使用文件名去掉最后一个扩展名，不包含目录。不同目录中的 hello.yml 会使用相同 ID，Hello 与 hello 也会被判为重复。
要让菜单 ID 不随文件名变化，在现有菜单顶层填写 id：
id: welcome
menu:
title: '&8欢迎回来'
rows: 3重载后用 /invero menu open welcome 打开。打开命令与 menu open 动作中的 ID，要与菜单列表里的大小写一致。
更新配置
新增或修改菜单后执行：
/invero menu reload
/invero menu open hello第二条中的 hello 换成实际菜单 ID。用 /invero menu list 查看当前已加载的菜单。
| 修改内容 | 生效方式 |
|---|---|
| 已加载菜单的内容、绑定命令或权限 | 重载菜单；默认也会监听原文件的保存 |
新增、移动、改名或删除菜单文件，或给文件名加 # / ! | 执行 /invero menu reload 重新扫描 |
| 全局节点文件 | 执行 /invero gnode reload |
| 主配置、菜单路径、文件筛选、数据库或导出服务 | 完整重启服务端 |
| 安装或移除外部物品插件 | 完整重启服务端 |
重载成功时，正在查看该菜单的玩家会重新打开窗口，会话变量保留，但不保证保留页码、滚动位置等状态；菜单被移除时会关闭窗口。
重载失败时，旧菜单可能仍然可以打开。应先修正后台日志中的错误，再重新加载，不能只凭窗口能打开判断修改是否成功。
Last updated on