Configurations de plugins : du YAML sans erreurs

Plus de la moitié des cas de « le serveur ne démarre pas après une modification » sont dus à un YAML cassé.

Cinq règles

1. Uniquement des espaces. Les tabulations sont interdites en YAML. L'éditeur du panneau les signale comme une erreur.
2. L'indentation, c'est l'imbrication. Décalez une ligne d'un espace et vous avez modifié la structure.
3. Un espace après les deux-points. key:value est incorrect, key: value est correct.
4. Des guillemets pour les caractères spéciaux. Entourez de guillemets toute chaîne contenant :, #, &, % ou commençant par un chiffre : motd: "Server: survival".
5. Les listes utilisent un tiret suivi d'un espace.

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

Comment vérifier

• L'éditeur du panneau peut ouvrir les .yml sous forme de formulaire : les types de champs sont déduits des valeurs et la structure ne peut pas être cassée — l'option la plus sûre.
• N'importe quel validateur YAML en ligne.
• Le journal : une erreur du type while scanning ... could not find expected ':' indique le numéro de ligne — Impossible de charger la configuration.

Encodage

Les fichiers contenant du texte en russe doivent être en UTF-8 sans BOM. Sinon, vous obtenez des caractères illisibles dans le chat — Localisation.

Sauvegarde de la configuration

Avant une modification importante, copiez le fichier à côté (config.yml.bak) — dans le panneau, cela se fait avec un simple bouton « Copier ». Restaurer une configuration fonctionnelle est plus simple que d'essayer de se rappeler ce que vous avez changé.

Après modification

La configuration est lue au démarrage. Certains plugins prennent en charge /plugin reload, mais recharger des plugins sur un serveur en cours d'exécution est une source d'erreurs difficiles à tracer. Un redémarrage est plus fiable.