文字与多行
固定文字、变量、PlaceholderAPI 和动态多行
本页字段写在布局（Layout）的文字元素内。先登记字体，再选择文字来源。
单行文字
value: "&f欢迎来到服务器"多行文字
固定列表最直接：
description:
list:
- "&f第一行"
- "&7第二行"
offset:
y: -12offset.y: -12 让后一行向下移动 12px。每行单独对齐和测量背景。list 优先于 lines，lines 优先于单行 value；没有 value 时，单行文字尝试读取与元素 ID 同名的布局变量。
| 字段 | 省略值 | 作用 |
|---|---|---|
value | 无 | 单行内容；无有效 value 时尝试同名元素变量 |
list | 无 | 固定多行，优先于 lines 和 value |
offset.y | 0 | 行间偏移，GUI 像素；不写时会重叠 |
offset.x | 0 | 当前多行路径不使用，不建议配置 |
lines.content | 无 | 返回列表或数组的 Kether 表达式 |
lines.line | 预留 12 行 | 打包时预计的最大行数 |
players:
lines:
content: "get player_list"
line: 10
offset:
y: -12这不是自动读取所有在线玩家的语句。只有调用方或脚本确实提供 player_list 时才有内容。脚本返回 Iterable 或数组时逐项渲染；lines.line 用于预留位置，不是运行时截断数量。
若实际行数超过预留位置，可能缺少对应字体定位。增加行数后重新打包。
颜色、字体和阴影
&f 是白色，&7 是灰色，&e 是黄色。字体用 font 或文件顶部 defaults.font 指定。Xerr 定位渲染处理文字阴影，用户不需要在 YAML 中添加 shadow_color。
如何生效
- 修改现有内容、变量表达式: 重载。
- 改字体、字号、y、锚点、多行预留数量: 打包。
- 刷新时间在显示绑定设置，不是在普通文字元素上随意添加
refresh。