菜单格式变动
自 Beta 1.3.0 以来,插件菜单出现的改动一览。
这是一份自 Beta 1.3.0 以来的插件菜单配置改动一览。已存在的配置文件将会自动升级,但更新后的改动必须以新格式为基础进行修改。
改动一览
之前的 menus.yml 被分成了多个单独的菜单配置文件,并存放在插件的菜单文件夹中;
- 对已有的 menus.yml 做出的改动会被自动同步至新的文件中;
- 例外:升级列表中的等级物品需要手动重置,因为新版本的更新向其加入了一些新条件。
- 老的 menus.yml 会被重命名为 menus-OLD.yml 并且不应再在新版本的配置中使用。这只是一份确保数据不丢失的备份文件。
- 对已有的 menus.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 等旧版本的用户,请继续使用 材料名:数据值 的格式。