Panel et fichiersPresque toute configuration d'extension est du YAML, et YAML décide de ce qui appartient à quoi uniquement par l'indentation. Un espace au mauvais endroit transforme un fichier qui marchait en un fichier que le serveur refuse de lire.
Les règles à l'origine des problèmes
- Des espaces uniquement. Une tabulation quelque part dans un fichier YAML est une erreur de syntaxe, et la plupart des éditeurs en insèrent par défaut.
- L'indentation est du sens. Deux espaces plus loin signifie « à l'intérieur de ce qui est au-dessus ».
- Une valeur contenant un deux-points exige des guillemets :
message: "Temps : 5s", pasmessage: Temps : 5s. yes,no,onetoffsont lus comme vrai et faux. Si vous voulez le mot, mettez-le entre guillemets.- Les codes couleur commençant par
&passent très bien, mais une valeur commençant par&seul est une ancre. Mettez-les aussi entre guillemets.
Éditer avec un filet
- Copiez le fichier avant d'y toucher
Dans le gestionnaire de fichiers, dupliquez
config.ymlenconfig.yml.bak. Trente secondes d'assurance contre une heure à deviner ce que vous avez changé. - Changez une chose à la fois
Cinq modifications d'un coup, c'est cinq suspects quand ça casse. Une modification, redémarrage, vérification : cela paraît plus lent et ne l'est pas.
- Redémarrez, ne rechargez pas
Les configurations sont lues au démarrage.
reloadmarche presque toujours et laisse parfois l'extension dans un état que personne ne peut déboguer. - Regardez la console pendant la remontée
Une erreur YAML nomme la ligne. Elle se trouve généralement une ou deux lignes plus haut, car c'est là que la structure a réellement cassé.
Le serveur garde sa propre copie en mémoire et la réécrit à l'extinction. Éditer server.properties ou la configuration d'une extension sur un serveur allumé signifie que votre changement sera écrasé à l'arrêt. Arrêtez d'abord, éditez, puis démarrez.
Si la console se plaint sans que vous voyiez pourquoi, un vérificateur YAML en ligne pointe le caractère exact. C'est plus rapide que de fixer l'écran, et cela vous apprend le motif pour la fois suivante.
Le serveur démarre sans erreur de configuration dans la console, et le réglage modifié se comporte différemment en jeu.