Konfiguracije pluginova: YAML bez grešaka

Više od polovine svih slučajeva "server neće da se pokrene posle izmene" je pokvaren YAML.

Pet pravila

1. Samo razmaci. Tabulatori su zabranjeni u YAML-u. Panel editor ih označava kao grešku.
2. Uvlačenje znači ugnježđavanje. Pomeri liniju za jedan razmak i promenio si strukturu.
3. Razmak posle dvotačke. key:value je pogrešno, key: value je ispravno.
4. Navodnici za specijalne znakove. Stavi pod navodnike svaki string koji sadrži :, #, &, % ili počinje cifrom: motd: "Server: survival".
5. Liste koriste crticu praćenu razmakom.

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

Kako da proveriš

• Panel editor može da otvori .yml kao formu: tipovi polja se izvode iz vrednosti, a struktura ne može da se pokvari — najsigurnija opcija.
• Bilo koji onlajn YAML validator.
• Log: greška poput while scanning ... could not find expected ':' sadrži broj linije — Cannot load configuration.

Kodiranje

Fajlovi sa ruskim tekstom moraju biti UTF-8 bez BOM-a. U suprotnom dobijaš izobličene znakove u četu — Localization.

Rezervna kopija konfiguracije

Pre veće izmene, kopiraj fajl pored njega (config.yml.bak) — u panelu je to jedno dugme "Copy". Vraćanje ispravne konfiguracije je lakše nego pokušavanje da se setiš šta si menjao.

Posle izmene

Konfiguracija se čita pri pokretanju. Neki pluginovi podržavaju /plugin reload, ali reload pluginova na serveru koji radi je izvor grešaka koje je teško ući u trag. Restart je pouzdaniji.