Primeros pasos

Esta página te ayuda a entender cómo editar correctamente un archivo .yml (.yaml). Todos mis plugins usan archivos de configuración .yml, que se reiniciarán o dejarán de funcionar si los editas incorrectamente.

A continuación, encontrarás todos los tipos de entradas de configuración y cómo deben formatearse si estás modificando algún valor.

Cómo editar archivos .yml

Los archivos se almacenan en formato .yml y Notepad++ es el software de edición de archivos recomendado para trabajar con configuraciones. Por supuesto, puedes usar cualquier otro editor de texto de tu elección.

Boolean

Los valores Boolean son true o false. Así es como se ven:

value1: true
value2: false

Los Boolean solo aceptan valores true o false. Generalmente se usan para activar o desactivar características específicas.

String

Los valores String suelen ser simplemente texto normal. Se recomienda encarecidamente que crees valores String entre comillas, siguiendo este formato:

value: "String"

Si bien esto no siempre es obligatorio, es obligatorio para cualquier cadena que contenga códigos de color, especialmente si el primer carácter comienza con un código de color. Los códigos de color siguen el formato de código de color del juego lo que significa que "&aTest" daría como resultado texto verde. La disponibilidad de texto coloreado varía según la configuración. Consulta esta página para códigos de color.

Details

¿Por qué?

Las cadenas de configuración pueden aceptar caracteres especiales como &. Si estos caracteres especiales ocupan el primer carácter, como en value: "&aString", si el String no está entre comillas, el valor se borrará y la opción de configuración se restablecerá a sus valores predeterminados. Esta es una limitación del sistema de configuración que usa Spigot.

Serialized Location

Serialized Location es un tipo específico de String que se ve así:

location: world,1.0,2.0,3.0,4.0,5.0

Se usan para almacenar y configurar ubicaciones. Sigue este formato: worldName,X,Y,Z,PITCH,YAW. Pitch y yaw simplemente determinan la dirección hacia la que mira el jugador, y se implementa de la misma manera que las ubicaciones de Minecraft.

Multiplier

Los valores Multiplier multiplican los valores del plugin por ese número. Estos valores nunca deben estar entre comillas. Aquí hay un ejemplo:

damageMultiplier: 1.0

En este caso, el multiplicador de daño se multiplicaría por 1, lo que significa que no hay cambio del valor predeterminado. Si el Multiplier fuera 2.0, el valor se multiplicaría por 2.0. Si fuera 0.5, se multiplicaría por 0.5.

Para aquellos que no son buenos con las fracciones, multiplicar por 0.5 es lo mismo que dividir por 2. Los valores Multiplier siempre deben ser mayores que 0 (0.0001 es válido) y no tienden a tener un límite superior.

Integer

Los valores Integer son simplemente números enteros. Ejemplo:

value: 10

Puedes aleatorizar estos valores para scripts usando ~. Ejemplo:

value: 1~10

Lo principal sobre los valores Integer es que deben ser números enteros. Esto significa que 10.1 no es válido.

Double

Los Double son números irracionales. Ejemplo:

value: 10.01

Puedes aleatorizar estos valores para scripts usando ~. Ejemplo:

value: 1.0~10.01

Los Double también pueden ser números enteros como los integers, como 10.0 o incluso representados como 10.

Floats

Los Floats son números con puntos decimales y pueden almacenar muchos decimales. Ejemplo:

value: 10.42452

Puedes aleatorizar estos valores para scripts usando ~. Ejemplo:

value: 1.0~10.42452

Los Double también pueden ser números enteros como los integers, como 10.0 o incluso representados como 10.

String List

Los String List son listas de valores String. Estos tienden a ser los valores más difíciles de configurar, ya que requieren un formato de configuración muy específico:

valuesList:
- "value,1"
- "value,2"
- "value,3"

Al igual que con los String, se recomienda mantener los valores entre comillas. Cada String List tiene su propio formato, por lo que tendrás que encontrar el formato específico que requiere el que estás editando; sin embargo, globalmente, así es como debería verse el formato general.

Map List

Los 'Map List' son listas de valores 'Map'. Solo se usan en scripting elite y requieren este formato de configuración:

parentMap:
- Map1:
  key: value
- Map2:
  key: value
  keyForList:
    - "value1"
    - "value2"

Como puedes ver, los Map Lists pueden contener cualquier tipo de formato dentro de ellos, pero si los estás usando en scripting necesitarás consultar la documentación para ver cuáles son las claves y valores válidos para los diferentes mapas.

Color Codes

También puedes asignar colores o hacer el texto en negrita usando los siguientes modificadores:

Código	Color	Ejemplo
&4	Rojo oscuro	&4Ejemplo rojo oscuro.
&c	Rojo	&cEjemplo rojo.
&6	Naranja	&6Ejemplo naranja.
&e	Amarillo	&eEjemplo amarillo.
&2	Verde oscuro	&2Ejemplo verde oscuro.
&a	Verde	&aEjemplo verde.
&b	Aqua	&bEjemplo aqua.
&3	Aqua oscuro	&3Ejemplo aqua oscuro.
&1	Azul oscuro	&1Ejemplo azul oscuro.
&9	Azul	&9Ejemplo azul.
&d	Púrpura claro	&dEjemplo púrpura claro.
&5	Púrpura oscuro	&5Ejemplo púrpura oscuro.
&f	Blanco	&fEjemplo blanco.
&7	Gris	&7Ejemplo gris.
&8	Gris oscuro	&8Ejemplo gris oscuro.
&0	Negro	&0Ejemplo negro.
&r	Reiniciar color	&rEjemplo de reinicio.
&i	Negrita	&iEjemplo negrita.
&o	Cursiva	&oEjemplo cursiva.
&n	Subrayado	&nEjemplo subrayado.
&m	Tachado	&mEjemplo tachado.
&k	Aleatorio	&k &fejemplo.

Como puedes ver en los ejemplos, los modificadores siguen la sintaxis regular de Minecraft excepto que el § se reemplaza con un & cuando se usa con EliteMobs. Puedes usar esto para modificar la mayoría del texto de EliteMobs como nombres de mobs, texto de misiones, nombres de mazmorras, etc.

Ten en cuenta que cuando funciona correctamente, los modificadores en sí no se mostrarán en tu texto. Solo se muestran aquí con fines demostrativos.

También es posible combinar colores y otros modificadores de texto. Por ejemplo, puedes hacer:

&a&oPara obtener texto verde en cursiva.

Si quisiéramos que nuestro mob personalizado tenga un nombre colorido elegante, haríamos lo siguiente:

name: $normalBossLevel &aScary &dDragon

Material

Los valores Material son simplemente Materials que puedes encontrar en MineCraft, como IRON_CHESTPLATE. Para una lista de Material válidos, consulta esta página.

helmet: IRON_HELMET

Los Material se usan como valores en varias configuraciones como equipamiento para mobs, botín, recompensas de misiones, etc.

Filename

Los valores Filename son simplemente archivos de configuración .yml que están formateados para usarse con los plugins de MagmaGuy. Estos podrían ser cualquier cosa, desde items hasta misiones.

uniqueLootList:
  - filename: magmaguys_toothpick.yml

Recortar Mundos

A veces, es posible que necesites reducir el tamaño de tu mundo de Minecraft para hacerlo más ligero y, en consecuencia, más fácil de distribuir. Esto se puede lograr mediante el uso del plugin WorldBorder. A pesar de que el plugin figura como compatible solo con MineCraft hasta la versión 1.19, funciona sin problemas en la última versión de MineCraft al 25 de enero de 2024.

Details

Consejo

Si estás haciendo esto por primera vez, podría ser una buena idea crear una copia de seguridad de tu mundo por si algo sale mal.

Una vez instalado el plugin, navega al centro del mundo o al área específica que deseas recortar. Luego, ejecuta el comando /wb set x, donde x representa el tamaño aproximado del radio que deseas para tu área.

Details

Consejo

Si /wb no funciona para ti, intenta /worldborder:wb.

Después de ejecutar este comando, vuela hasta los bordes de tu mundo para verificar que el borde del mundo se haya establecido correctamente y cubra el tamaño deseado. Reconocerás que has alcanzado el borde del mundo cuando seas empujado hacia atrás, acompañado de un mensaje en el chat.

En la imagen de arriba, nuestro objetivo es recortar el mundo alrededor de los bloques morados, dejando solo algunos chunks a su alrededor. Para lograr esto, nos paramos en el medio del área morada en los cuadrados rojos y ejecutamos /wb set 50, estableciendo el borde del mundo justo más allá del área morada.

A continuación, usamos el comando /wb trim [freq] [pad], con la frecuencia establecida en 200 y el pad en 20. El pad determina cuántos chunks deben dejarse alrededor del borde del mundo (el área morada), y la frecuencia determina cuántos chunks deben procesarse por segundo. Después de ejecutar /wb trim 200 20, se nos pedirá que confirmemos ejecutando /wb trim confirm. Confirmamos la acción y, después de un tiempo, nuestro mundo se recortará, reduciendo su tamaño y haciéndolo más conveniente para distribuir.

Ahora puedes eliminar el borde del mundo usando /wb clear all o simplemente dejarlo si lo deseas.

Recortar la carpeta del mundo

Hay varios archivos y carpetas ubicados en la carpeta de tu mundo que podemos descartar ya que los plugins no los usan todos. Esto reducirá el tamaño de tu mundo y facilitará su distribución.

Para un entorno de mundo NORMAL:

Para preparar tu mundo, conserva los siguientes archivos y carpetas:

1. Carpeta region
2. raids.dat de dentro de la carpeta data (asegúrate de que esté colocado dentro de la carpeta data al copiar)
3. Archivo level.dat

Puedes eliminar de forma segura todos los demás archivos y carpetas ubicados en la carpeta del mundo. Esto configurará tu mundo correctamente para el entorno NORMAL.

Para entornos de mundo NETHER y THE_END:

Para preparar tu mundo, conserva los siguientes archivos y carpetas:

1. Carpeta region dentro de la carpeta DIM-1 (asegúrate de que esté colocada dentro de la carpeta DIM-1 al copiar)
2. raids.dat de dentro de la carpeta data (asegúrate de que esté colocado dentro de la carpeta data al copiar)
3. Archivo level.dat

Puedes eliminar de forma segura todos los demás archivos y carpetas ubicados en la carpeta del mundo. Esto configurará tu mundo correctamente para los entornos NETHER y THE_END.