菜单打开入口

bindings 写在菜单文件顶层，别名为 binding、activator、activators。下面的片段都合并到要打开的那个菜单中；保存后按文件更新规则重载。

入口字段Copy Anchor Link

items、chats、ady 能被配置读取，但不会由对应物品、聊天和 NPC 事件触发；请使用 item、chat、adyeshach。命令的四种字段名都能注册命令；同一菜单中同时使用这些命令字段时，定义会合并检查，而不是后者覆盖前者。没有对应入口的字段会被忽略，不会自动成为一个新入口。

命令入口Copy Anchor Link

bindings:
  command: hello-menu

保存并重载后，玩家执行 /hello-menu 打开这个菜单；绑定名称不含开头 /。这种打开不要求管理命令权限，也不受其他事件入口的一秒共享间隔限制。

多个命令可写成列表，共同打开当前菜单，但分别定义自己的参数和权限：

bindings:
  command:
    - name: guide
      aliases:
        - menu-guide
    - name: help-menu
      description: '打开同一个帮助菜单'

命令名称与别名会转成小写，别名会去重；命令名不能空白或含空格。同一菜单内任何命令名、别名都不能与另一条定义重名。其他菜单占用相同的 Invero 命令标签时会注册失败；其他插件占用普通标签时，可能只能使用 /invero:<命令名>，按后台冲突提示确定实际入口。

命令字段Copy Anchor Link

命令对象写在 bindings.command 下；只有名称时直接写文字即可。

命令权限仅限制这一条绑定命令。 它不自动限制指南针、聊天、实体或管理命令直接打开同一菜单。需要所有入口共用的打开条件，写在菜单的 events.pre_open，见菜单事件。

命令参数Copy Anchor Link

以下片段让 /profile 默认查看“自己”，也允许输入 /profile Steve，并要求绑定命令权限：

bindings:
  command:
    name: profile
    aliases:
      - my-profile
    description: '打开资料菜单'
    permission: 'invero.profile'
    permissionMessage: '你没有权限打开资料菜单。'
    arguments:
      - id: target
        type: ANY
        optional: true
        default: '自己'
        suggest:
          - 自己
          - Steve

此处 default: '自己' 是示例中显式填写的值，不是参数省略后的内置值。允许使用该命令的玩家输入 /profile Steve 时，{{&target}} 为 Steve；输入 /profile 时为 自己。

输入和默认值进入菜单后都是文字，不会因为 INTEGER 或 BOOLEAN 自动变成对应变量类型。参数按位置填写，不能跳过中间某个参数；将必填参数放在可选参数前。最后一个参数会收下剩余的空格内容，因此不要把它当作禁止多余尾部文字的严格结构。

物品、聊天与按键Copy Anchor Link

bindings:
  item: 'minecraft:compass'
  chat:
    - '打开菜单'
    - '/open-guide'
  shift_f: 800

800 是上例选择的窗口，不是省略 shift_f 后自动启用的值。换手键使用玩家实际绑定的按键，不要求客户端一定使用字母 F。

物品匹配写法Copy Anchor Link

item 列表中任意一条表达式匹配即可。内置材质匹配使用小写名称，可省略 minecraft:，也可用 material:：

bindings:
  item:
    - 'minecraft:compass[name=菜单]'
    - 'material:clock'

第一条要求指南针名称包含“菜单”，第二条匹配时钟。材质条件支持 *（任意材质）、^前缀、后缀$、(包含文字)；这些不是完整正则，多个材质标记也不是逐项“且”判断。%标签% 不提供物品标签匹配。

方括号内用逗号分隔条件，所有条件同时满足才算匹配。内置条件键如下：

除名称与 Lore 固定包含判断外，可写 =、!=、>、>=、<、<=，以及 键(值一|值二)。数值大小比较的方向是配置值与物品值比较：例如 damage>10 实际检查 10 > 物品损伤值，不是“损伤值大于 10”。未支持的条件键不匹配。

显示图标使用的外部物品 source 不等于这里的匹配命名空间；内置匹配不提供各物品插件 ID 的自动识别。不要把 itemsadder:某ID 等显示来源写法直接当作已经支持的入口条件。

实体入口Copy Anchor Link

bindings:
  entity:
    - VILLAGER
    - WANDERING_TRADER

右键这两种实体时打开当前菜单，填写实体类型而不是显示名；单个类型可直接写 entity: VILLAGER。副手触发与已取消的事件会被跳过，匹配本身不取消原实体交互。

Adyeshach NPC 入口Copy Anchor Link

安装并启用 Adyeshach 后，按 NPC ID 配置：

bindings:
  adyeshach:
    - menu_guide
    - help_guide

主手交互任意一个 ID 即可打开，不填写 NPC 显示名。该入口不取消原 NPC 交互；只写别名 ady 不会由事件触发。

入口变量Copy Anchor Link

这些变量在对应入口打开菜单时传入，可在文字中用 {{&变量名}} 读取。物品和实体本身是对象，不等同于其名称或 ID。

其他入口不会自动获得上述变量。管理打开可用分号格式显式传值，见命令；通用玩家信息见占位符。

其他打开方式与变量保留Copy Anchor Link

脚本打开还可用 for <准确在线玩家名> 指定目标，省略时使用当前玩家；显式目标不存在时会回退到当前脚本玩家。脚本菜单 ID 区分大小写。菜单跳转见导航示例，输入流程见输入收集。

多入口同时存在Copy Anchor Link

物品、聊天、潜行换手、实体、Adyeshach 事件共用每名玩家约一秒的触发间隔；没有匹配到菜单的尝试也可能占用这个间隔。同一事件匹配多个菜单时只尝试其中一个，不提供固定优先顺序。pre_open 拒绝打开也不会继续尝试下一个匹配菜单，已被取消的聊天、物品或换手行为不会因此恢复。

所有打开方式仍经过菜单打开条件；已有菜单会话创建不足约 200 毫秒时，紧接着再次打开也会被忽略。这与事件入口共享的一秒间隔不是同一个限制。