Cómo funciona un archivo YML

🤔 ¿Qué es un archivo YAML?

Un archivo YAML (o YML) es como una lista de configuraciones muy organizada, similar a hacer una lista de compras pero con un formato específico. Se usa mucho en configuraciones de juegos y programas.

📝 Reglas Básicas

1. Los espacios al inicio de cada línea son MUY importantes (esto es la indentación)

   • La indentación es simplemente los espacios que ponemos al inicio de cada línea
   • Es como cuando haces una lista con subpuntos:

     • Frutas
       • Manzanas
       • Peras
     • Verduras
       • Lechuga
       • Tomates

   • En YAML, estos espacios indican qué configuraciones pertenecen a otras
   • Debes usar 2 spacios por cada “nivel” (¡no uses la tecla Tab!)
   • Todo lo que esté relacionado debe tener la misma cantidad de espacios

   Ejemplo visual de indentación:

   # Sin espacios (nivel principal)
   servidor:
     # 2 espacios (pertenece a "servidor")
     nombre: Mi Servidor
     configuracion:
       # 4 espacios (pertenece a "configuracion")
       pvp: true
       dificultad: normal

2. Los dos puntos (:) son importantes

   • Se usan para asignar valores
   • Ejemplo: nombre: valor

🎮 Ejemplos Prácticos

Ejemplo Simple de Espacios (Indentación)

# Nivel principal (sin espacios)
servidor:
  # Un grupo de configuraciones del servidor (2 espacios)
  nombre: Mi Servidor de Minecraft
  puerto: 25565
  configuracion-avanzada:
    # Configuraciones dentro del grupo anterior (4 espacios)
    permitir-nether: true
    permitir-end: true

Ejemplo con Listas

whitelist:
  - Steve    # Cada elemento de la lista lleva 2 espacios y un guion
  - Alex
  - Notch

✅ Consejos para Editar

1. Considera una copia de seguridad

   • Considera guardar una copia del archivo original antes de editarlo

2. Mantén los espacios al inicio de cada línea

   • Si una configuración está dentro de otra, debe tener más espacios
   • Usa el mismo número de espacios para cosas que están al mismo nivel
   • Piensa en ello como una lista con viñetas anidadas

3. Valores comunes

   • Texto: Puede ir con o sin comillas
     • nombre: Mi Servidor
     • nombre: "Mi Servidor"
   • Números: Van sin comillas
     • puerto: 25565
   • Verdadero/Falso:
     • pvp: true
     • pvp: false

❌ Errores Comunes a Evitar

1. NO uses la tecla Tab, usa la barra espaciadora

   # MAL (usando Tab ➡️)
   servidor:
   ➡️nombre: "Mi Servidor"
   
   # BIEN (usando espacios)
   servidor:
     nombre: "Mi Servidor"

2. NO olvides los espacios después de los dos puntos

   # MAL
   nombre:"Mi Servidor"
   
   # BIEN
   nombre: "Mi Servidor"

3. NO pongas espacios diferentes

   # MAL (espacios irregulares)
   servidor:
   nombre: "Mi Servidor"
      puerto: 25565
   
   # BIEN (espacios consistentes)
   servidor:
     nombre: "Mi Servidor"
     puerto: 25565

4. Algunos caracteres causan errores al inicio de las líneas

   # MAL (caracter inválido)
   servidor:
   nombre: &a&lMi Servidor
   puerto: 25565
   
   # BIEN (con comillas)
   servidor:
     nombre: "&a&lMi Servidor"
     puerto: 25565

🔍 ¿Cómo verificar si tu archivo está bien?

• Usa un validador de YAML en línea
• Si tienes errores, revisa los logs buscando errores de sintaxis, por ejemplo

  Error parsing config.yml: line 2, column 30

• Compara tu archivo con una copia de respaldo que funcione

📌 Recuerda

• La indentación (espacios al inicio) es como hacer una lista ordenada: si algo pertenece a un grupo, va con más espacios (2 espacios, 4 espacios, 6 espacios, etc)
• Recuerda cerrar las comillas, no usar comas y revisa tus logs.

Esta guia fue generada con ayuda de IA.