面板类型
区分固定分类、数据分页、滚动列表和真实物品交互。
面板把窗口划成内容区、导航区等区域。一个菜单可以组合多个面板，每个面板使用自己的局部坐标。
| 要显示的内容 | 面板 | 选择它的配置键 |
|---|---|---|
| 固定按钮、装饰与导航 | 普通面板 | 不设置下面四种专用键，使用 icons |
| 苹果类、钻石类等事先写好的分类或选项卡 | 固定翻页面板 | pages |
| 在线玩家、目录等按数据条目自动分页的列表 | 生成器面板 | generator |
| 横向或纵向滑动一组组图标 | 滚动面板 | scroll |
| 玩家放入和取出真实物品 | 物品交互面板 | crafting |
pages 不会根据条目数量自动拆页；generator 才会按未占用格子的数量自动分页。两者都能使用 page 操作，但内容来源不同。操作教程见分类切换与列表分页。
菜单中的面板节点
| 字段 | 类型 | 必填 | 省略行为 | 说明 |
|---|---|---|---|---|
panels（panel、pane、panes） | 面板列表或单个面板对象 | 是，除面板简写外 | 没有显式面板节点时，文件顶层含 layout、scale 或 rows 可组成一个简写面板 | 列表顺序决定顶层面板索引；组合面板使用列表写法 |
面板简写只收集文件顶层的 layout、locate、scale、pages、generator、scroll、crafting 和 icons（包括 icon、item、items）。组合菜单使用 menu 加 panels，不要混用顶层简写与多个面板节点。
类型选择与组合
面板不通过 type: standard 或 type: generator 选择类型。它由是否存在专用键决定：优先检查 pages，再检查 generator、scroll、crafting，都没有才是普通面板。
同一面板只使用一种内容组织方式。把 generator 和 scroll 并排写在同一对象中不会得到“滚动生成器”，排在后面的类型不会生效。菜单 YAML 没有单独可选的自由画布、面板组或滚动生成器类型。
- 同时显示内容区与导航区：作为
panels中的两个面板，见普通面板组合。 - 在多套事先写好的内容间切换：用
pages，每一项仍是一个面板。 - 每一分类都显示数据列表：可将生成器作为
pages的某一页。 - 真实物品存取使用独立的顶层
crafting，不要把嵌套页当成同样可靠的存储容器。
尺寸与坐标
scale 是宽度、高度，locate 是相对于父容器的横向、纵向起点，均使用两项整数列表。每个图标的 slot 则相对于所在面板。
普通面板、生成器可由 layout 推导尺寸；滚动、物品交互面板必须有 layout；固定翻页面板必须显式填写 scale。完整规则见布局字段，实际放置步骤见布局教程。
Last updated on