Panel y archivos

Editar archivos de configuración sin corromperlos

Revisado el 6 de septiembre de 2026 2 min de lectura

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", no message: Tiempo: 5s.
  • yes, no, on y off se 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

  1. Copia el archivo antes de tocarlo

    En el gestor de archivos, duplica config.yml a config.yml.bak. Treinta segundos de seguro contra una hora adivinando qué cambiaste.

  2. 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.

  3. Reinicia, no recargues

    Las configuraciones se leen al arrancar. reload funciona casi siempre y de vez en cuando deja el plugin en un estado que nadie puede depurar.

  4. 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.

No edites archivos con el servidor encendido

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.

Pégalo en un validador de YAML cuando te atasques

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.

Cómo saber que ya está

El servidor arranca sin errores de configuración en la consola, y el ajuste que cambiaste se comporta distinto en el juego.