Конфіги плагінів: 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 ':' містить номер рядка — Cannot load configuration.

Кодування

Файли з українським текстом мають бути в UTF-8 без BOM. Інакше в чаті з'являться криві символи — Localization.

Резервна копія конфігурації

Перед великим редагуванням скопіюйте файл поруч (config.yml.bak) — у панелі це одна кнопка «Copy». Відновити робочу конфігурацію простіше, ніж намагатися згадати, що ви змінили.

Після редагування

Конфігурація зчитується під час запуску. Деякі плагіни підтримують /plugin reload, але перезавантаження плагінів на живому сервері — джерело помилок, які важко відстежити. Перезапуск надійніший.