插件配置：无错误的 YAML

超过一半的“编辑后服务器无法启动”案例都是 YAML 格式损坏导致的。

五条规则

1. 只能用空格。 YAML 中禁止使用制表符。控制面板编辑器会将其标记为错误。
2. 缩进代表层级。 将一行移动一个空格，结构就变了。
3. 冒号后要加空格。 key:value 是错误的，key: value 才是正确的。
4. 特殊字符要加引号。 任何包含 :、#、&、% 或以数字开头的字符串都要用引号括起来：motd: "Server: survival"。
5. 列表使用连字符加空格。

kits:
  start:
    delay: -1
    items:
      - "stone_sword 1"
      - "bread 16"

如何检查

• 控制面板编辑器可以将 .yml 以表单形式打开：字段类型根据值自动推断，结构不会被破坏——这是最安全的方式。
• 任意在线 YAML 校验工具。
• 日志：类似 while scanning ... could not find expected ':' 的错误会包含行号——无法加载配置。

编码

包含俄文的文件必须使用无 BOM 的 UTF-8 编码。否则聊天中会出现乱码——本地化。

配置备份

在进行重大修改之前，将文件复制一份放在旁边（config.yml.bak）——在控制面板中只需点击一次“复制”按钮。恢复可用的配置比努力回忆自己改了什么要容易得多。

编辑之后

配置在启动时读取。部分插件支持 /plugin reload，但在运行中的服务器上重载插件是难以排查的错误的来源。重启更可靠。