Хостинг · Плагины

Конфиги плагинов: YAML без ошибок

Правила синтаксиса YAML, из-за которых сервер не стартует: отступы, табы, кавычки, двоеточия и как проверить файл до запуска.

Обновлено 13 августа 2026 г.

Больше половины случаев «сервер не запускается после правки» — сломанный YAML.

Пять правил

  1. Только пробелы. Табуляция в YAML запрещена. Редактор панели показывает их как ошибку.
  2. Отступ значит вложенность. Сдвинули строку на пробел — изменили структуру.
  3. После двоеточия — пробел. key:value неверно, key: value верно.
  4. Кавычки для спецсимволов. Строку с :, #, &, % или начинающуюся с цифры берите в кавычки: motd: "Сервер: выживание".
  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. Иначе в чате кракозябры — Локализация.

Резервная копия конфига

Перед крупной правкой копируйте файл рядом (config.yml.bak) — в панели это одна кнопка «Копировать». Восстановить рабочий конфиг проще, чем вспоминать, что вы поменяли.

После правки

Конфиг читается при старте. Некоторые плагины умеют /plugin reload, но перезагрузка плагинов на живом сервере — источник трудноуловимых ошибок. Надёжнее перезапуск.