猹引擎 ​

YAML语法 ​

本页用于帮助策划和运维快速读写配置。
掌握这些基础语法后，大部分配置都可以独立维护。

基础规则 ​

1. 缩进使用空格，不使用制表符。
2. 同级字段保持对齐，结构更清晰。
3. 含特殊符号或中文长句时使用引号。
4. 列表项统一使用 - 开头。

最小示例 ​

活动页面:
  html: "activity-main.html"
  center: true
  x: 0
  y: 0
  width: 960
  height: 540

列表示例 ​

活动守卫:
  model: "活动守卫/活动守卫.geo.json"
  animation: "活动守卫/活动守卫.animation.json"
  texture: "活动守卫/活动守卫.png"
  match:
    - "name#equal#活动守卫"
    - "name#contains#守卫"

常见错误 ​

错误一：缩进层级错位 ​

结果是配置无法被正确读取。
修改后先做一次结构检查再上线。

错误二：列表写成普通文本 ​

结果是多条规则只会识别一条。
每条规则独立一行并以 - 开头。

错误三：字段名临时改动 ​

结果是历史模板无法复用。
字段名保持稳定，新增字段走增量扩展。

编辑流程 ​

1. 先复制可用模板，再按业务改值。
2. 一次只改一个模块，方便定位问题。
3. 每次改动保留上一版备份文件。