普通面板
查阅固定图标、尺寸、自动起点和多区域组合。
普通面板放置固定图标，不开放真实物品存取。没有 pages、generator、scroll、crafting 专用键时就是普通面板。
面板字段
字段位于 panels 的某一项，也可位于固定分页的某一页。
| 字段 | 类型 | 必填 | 省略行为 | 说明 |
|---|---|---|---|---|
layout | 文字列表 | 否 | 无字符位置与布局尺寸 | 每行对应一行位置，图标 ID 对应字符或反引号分组 |
icons（icon、item、items） | 图标映射 | 是 | 缺少整个字段不能加载普通面板 | 每个键定义一个图标，字段见图标配置 |
scale | 两项整数列表 | 否 | 优先使用 layout 尺寸；两者都没有时宽 9，顶层高度采用窗口行数 | 宽度、高度；嵌套面板应提供布局或明确尺寸 |
locate | 两项整数列表 | 否 | 在父容器中选最靠上的未占用起点；位于固定分页内时为 0x0 | 横向起点、纵向起点；自动放置不保证整个矩形没有重叠 |
既没有匹配布局位置，也没有显式 slot 的图标不会自动占据某个空格。重复图标位置、空白和坐标格式见布局参考。
组合区域
下面的片段将前两行作为内容区，最后一行作为导航区。保留 rows: 3，不要依靠两个面板各自的高度推导总行数。
内容区 · locate 0,0
导航区 · locate 0,2
窗口槽位 22窗口坐标 4x2面板局部坐标 4x0字符 C
内容区和导航区属于同一窗口，各自使用局部坐标。
menu:
title: '&8两个区域'
rows: 3
panels:
- locate:
- 0
- 0
layout:
- '#########'
- '# A #'
icons:
'#':
material: GRAY_STAINED_GLASS_PANE
name: ' '
A:
material: PAPER
name: '&f内容区'
- locate:
- 0
- 2
layout:
- ' C '
icons:
C:
material: BARRIER
name: '&c关闭'
action: 'menu close'图示为配置效果示意。纸张在窗口槽位 13；底部屏障在窗口槽位 22，但在导航面板内是局部槽位 4。点击屏障执行 menu close，不关闭或重建某个单独面板。
两个顶层面板的索引依次为 0、1。不要用重叠区域制造层叠按钮：显示覆盖与点击归属可能不同；明确分配互不重叠的矩形区域。
从字符布局改用槽位、逐步拆分区域的操作见布局教程。
Last updated on