Casi toda configuración de plugin es YAML, y YAML decide qué pertenece a qué únicamente por la indentación. Un espacio en el sitio equivocado convierte un archivo que funcionaba en uno que el servidor se niega a leer.
Las reglas que causan los problemas
- Solo espacios. Un tabulador en cualquier parte de un archivo YAML es un error de sintaxis, y la mayoría de editores mete tabuladores por defecto.
- La indentación es significado. Dos espacios más adentro significa «dentro de lo de arriba».
- Un valor con dos puntos dentro necesita comillas:
message: "Tiempo: 5s", nomessage: Tiempo: 5s. yes,no,onyoffse leen como verdadero y falso. Si quieres la palabra, entrecomíllala.- Los códigos de color con
&van bien, pero un valor que empieza por&a secas es un ancla. Entrecomilla esos también.
Editar con red
- Copia el archivo antes de tocarlo
En el gestor de archivos, duplica
config.ymlaconfig.yml.bak. Treinta segundos de seguro contra una hora adivinando qué cambiaste. - Cambia una cosa cada vez
Cinco ediciones a la vez son cinco sospechosos cuando se rompa. Una edición, reinicio, comprobar: parece más lento y no lo es.
- Reinicia, no recargues
Las configuraciones se leen al arrancar.
reloadfunciona casi siempre y de vez en cuando deja el plugin en un estado que nadie puede depurar. - Mira la consola mientras sube
Un error de YAML nombra la línea. Suele estar una o dos líneas por encima de lo que dice, porque ahí es donde se rompió la estructura de verdad.
El servidor tiene su propia copia en memoria y la vuelve a escribir al apagarse. Editar server.properties o la configuración de un plugin en un servidor encendido significa que tu cambio se sobrescribe cuando pare. Para primero, edita y luego arranca.
Si la consola se queja y no ves por qué, un comprobador de YAML en línea señala el carácter exacto. Es más rápido que mirar fijamente, y te enseña el patrón para la próxima.
El servidor arranca sin errores de configuración en la consola, y el ajuste que cambiaste se comporta distinto en el juego.