Skip to content

菜单格式变动

自 Beta 1.3.0 以来,插件菜单出现的改动一览。

这是一份自 Beta 1.3.0 以来的插件菜单配置改动一览。已存在的配置文件将会自动升级,但更新后的改动必须以新格式为基础进行修改。

改动一览

  • 之前的 menus.yml 被分成了多个单独的菜单配置文件,并存放在插件的菜单文件夹中;

    • 对已有的 menus.yml 做出的改动会被自动同步至新的文件中;
      • 例外:升级列表中的等级物品需要手动重置,因为新版本的更新向其加入了一些新条件。
    • 老的 menus.yml 会被重命名为 menus-OLD.yml 并且不应再在新版本的配置中使用。这只是一份确保数据不丢失的备份文件。
  • 键名 rows 被改为了 size。该键的取值范围与旧键相同(0-5);

  • 材料名称现在为小写名称(仍支持大写名称);

  • 行(row)与列(column)在新版本被 pos 替代,该键有两种格式可用:

    • 行列格式,该格式的写法通常为 行,列,例如参数 3,0 代表菜单里的第 4 行第 1 列。第一行/列从 0 开始计数。
    • 序号格式,该格式是为 0-53 范围的整数,代表 GUI 中格子的序号。第 0 格在菜单的左上角,从左至右序号递增,从上至下也递增。
  • 每个在模板中的内容(每个有不同材料或位置的技能/属性)都按名称被移动到了其对应的菜单子区中。

    • 诸如 materials、pos,以及每个物品内容的数据被按名移动到了对应的子区域中。
    • 下面是一个模板中的新格式内容:
    templates:
      skill:
        farming: # 农耕技能设置区域的名称
          material: diamond_hoe # 农耕技能内容的材料名称
        foraging: # 不同于农耕技能设置区域的锻造技能设置名称
          material: stone_axe
  • 物品数据设置,例如药水数据(potion_data),现在从对应区域分离并置入了物品设置(与 material、lore 等设置项同级)和模板设置下。

    • 材料(material)项设置现在只能填入物品材质,不能填入其他附加值。
    • 新版本格式下的物品数据定义示例:
    items:
      rank: # 物品名称
        material: paper # 仅允许材料名称
        potion_data: # 从原本的 material 下分离
          type: instant_heal # 部分物品数据需要额外的子参数
  • 诸如 1.12 等旧版本的用户,请继续使用 材料名:数据值 的格式。