Konfigurácie pluginov: YAML bez chýb

Viac ako polovica všetkých prípadov „server po úprave nenaskočí“ je pokazený YAML.

Päť pravidiel

1. Iba medzery. Tabulátory sú v YAML zakázané. Editor v paneli ich označí ako chybu.
2. Odsadenie znamená vnorenie. Posuň riadok o jednu medzeru a zmenil si štruktúru.
3. Medzera za dvojbodkou. key:value je zle, key: value je správne.
4. Úvodzovky pri špeciálnych znakoch. Každý reťazec obsahujúci :, #, &, % alebo začínajúci číslicou obal do úvodzoviek: motd: "Server: survival".
5. Zoznamy používajú pomlčku a za ňou medzeru.

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

Ako to skontrolovať

• Editor v paneli vie otvoriť .yml ako formulár: typy polí sa odvodia z hodnôt a štruktúru nemožno pokaziť — najbezpečnejšia možnosť.
• Akýkoľvek online validátor YAML.
• Log: chyba ako while scanning ... could not find expected ':' obsahuje číslo riadku — Nedá sa načítať konfigurácia.

Kódovanie

Súbory s ruským textom musia byť v UTF-8 bez BOM. Inak sa v chate zobrazia rozsypané znaky — Lokalizácia.

Záloha konfigurácie

Pred väčšou úpravou skopíruj súbor vedľa neho (config.yml.bak) — v paneli je to jediné tlačidlo „Kopírovať“. Obnoviť funkčnú konfiguráciu je jednoduchšie, než si spomínať, čo si zmenil.

Po úprave

Konfigurácia sa načíta pri štarte. Niektoré pluginy podporujú /plugin reload, ale reload pluginov na živom serveri je zdrojom ťažko vystopovateľných chýb. Reštart je spoľahlivejší.