Edita o añade una clase
Cambia la armadura, los efectos y el permiso de una clase, o añade una nueva, con todas las claves de un archivo de clase.
Al final de esta página tienes una clase tuya, o una existente que pide otra armadura, otro permiso u otro warmup. Una clase es un archivo .yml, y no hay ningún menú para construirla.
Antes de empezar#
ExyliaClasses y ExyliaLib están instalados y el servidor ha arrancado una vez, así que las seis clases por defecto existen. Mira Instalar ExyliaClasses. Si quieres ver una clase funcionando antes, sigue Tu primera clase.
Pasos#
Abre la carpeta de clases
Ve a plugins/ExyliaClasses/lang/<idioma>/classes/. La carpeta es por idioma: los archivos vienen en en, es, pt, fr, ru y tr, y los nombres de la clase, sus habilidades y su energía están traducidos en cada uno. Un servidor que tenía sus archivos en classes/ los conserva como lang/custom/classes/, con sus cambios.
Copia o edita un archivo
Para cambiar una clase, abre su archivo (Archer.yml). Para añadir una, copia un archivo y renómbralo. El nombre del archivo en minúsculas es el id de la clase: Medic.yml es la clase medic.
Pon la armadura
En equipment, escribe las cuatro piezas que pide la clase (helmet, chestplate, leggings, boots). Solo se comprueban los huecos que escribas. Da a cada clase un set de armadura que no use ninguna otra.
Decide quién puede usarla
permission: "NONE" significa que cualquiera. Cualquier otro valor es un permiso que el jugador necesita, por ejemplo exyliaclasses.class.medic.
Añade lo que hace la clase
Añade passive-effects, y después abilities, hold-effects, weapons o energy según necesites. Cada uno tiene su guía, enlazada en la tabla de abajo.
Recarga
Ejecuta /classesadmin reload. La recarga también vuelve a comprobar la armadura de cada jugador conectado contra los archivos nuevos.
Un archivo mínimo:
display-name: "<#63ff8a><bold>MEDIC</bold>"
permission: "NONE"
equipment:
helmet: DIAMOND_HELMET
chestplate: DIAMOND_CHESTPLATE
leggings: DIAMOND_LEGGINGS
boots: DIAMOND_BOOTS
passive-effects:
- REGENERATION|1Comprueba que funciona#
Ponte la armadura completa. Tras el warmup (cinco segundos por defecto) el chat dice que ya eres de la clase y los efectos aparecen en tus iconos de estado. Quítate una pieza: el chat dice que has salido de la clase y los efectos se acaban. Si no pasa nada, busca en la consola una línea Invalid material y mira Problemas comunes.
Ir más lejos#
Editar en el juego o en la web#
Quien tenga exyliaclasses.admin.settings también puede editar cada archivo de clase en el juego y en el editor web de ExyliaLib (mira Editar menús). Una clase que perdería parte de su definición, como un material desconocido, se rechaza entera en vez de guardarse. Se pueden editar los archivos presentes al arrancar; uno añadido después espera a un reinicio.
Bloquear una clase con un permiso#
permission: "exyliaclasses.class.rogue"Un jugador con la armadura puesta pero sin el permiso recibe el mensaje no-permission y no hay warmup: la armadura simplemente no hace nada. El permiso lo inventas tú; el plugin no registra una lista. Los archivos que vienen de serie usan exyliaclasses.class.<id>. Cualquier valor distinto de NONE, vacío o ausente se trata como un permiso real.
Cambiar el warmup#
warmup:
time: 5
sound:
enabled: true
type: "BLOCK_AMETHYST_BLOCK_PLACE|1|1"
particle:
enabled: true
type: "BUBBLE_POP|100|1.5|1.5|1.5|3"
sound-completed:
enabled: true
type: "BLOCK_PISTON_EXTEND|1|1"
particle-completed:
enabled: true
type: "REVERSE_PORTAL|100|1.5|1.5|1.5|3"
sound-cancel:
enabled: true
type: "BLOCK_ANVIL_PLACE|1|1"
particle-cancel:
enabled: true
type: "DRIP_LAVA|100|1.5|1.5|1.5|3"| Clave | Por defecto | Cuándo se dispara |
|---|---|---|
time | 5 | Segundos. El mensaje de cuenta atrás se envía una vez por segundo. |
sound / particle | apagado | Cada segundo de la cuenta atrás. |
sound-completed / particle-completed | apagado | En el momento en que se activa la clase. |
sound-cancel / particle-cancel | apagado | Cuando un cambio de armadura cancela el warmup. |
Cada uno de esos seis bloques necesita enabled: true para hacer algo; enabled: false o un bloque ausente es silencio. Los jugadores con un cliente compatible también ven un temporizador de cooldown del warmup, dibujado con la pechera de la clase como icono, o con una brújula si la clase no pide pechera.
Los mensajes están en messages.yml; mira Mensajes e idiomas. Los nombres de clase, de habilidad y los colores de marca aceptan las etiquetas de Colores: <#c8c8c8>, <bold>, códigos & clásicos y tokens de paleta como {primary}.
Cuándo se pierde la clase#
Una clase se pierde por completo al morir y al salir, junto con la barra de energía y las marcas. Los cooldowns de habilidad no se reinician; mira Habilidades.
Las claves de un archivo de clase#
| Clave | Por defecto | Qué hace |
|---|---|---|
display-name | el id | El nombre en todos los mensajes, y lo que %exyliaclasses_classes_class% devuelve a un scoreboard o a un plugin de tab. Funcionan las etiquetas de color y los tokens de paleta. |
permission | NONE | El permiso que necesita el jugador. NONE, vacío o ausente significa cualquiera. |
equipment | ninguno | La armadura que mete al jugador en la clase. |
passive-effects | ninguno | Efectos que se mantienen mientras se lleva la clase. Mira Pasivas. |
special-passives | ninguno | Efectos que se mantienen mientras se cumple una condición. Mira Pasivas. |
warmup | 5 segundos | La espera antes de que se active la clase. |
energy | apagada | El recurso que gastan las habilidades. Mira Energía. |
abilities | ninguna | Objetos de clic derecho. Mira Habilidades. |
hold-effects | ninguno | Efectos mientras se sostiene un objeto. Mira Habilidades. |
weapons | ninguna | Un arma de marca o de puñalada. Mira Armas. |
El archivo del Archer, recortado
El Archer que viene con el plugin también tiene habilidades, sonidos y partículas de warmup; aquí se quitan para mostrar el archivo funcional más pequeño.
display-name: "<#c8c8c8><bold>ARCHER</bold>"
permission: "exyliaclasses.class.archer"
equipment:
helmet: LEATHER_HELMET
chestplate: LEATHER_CHESTPLATE
leggings: LEATHER_LEGGINGS
boots: LEATHER_BOOTS
passive-effects:
- SPEED|3
- DAMAGE_RESISTANCE|2
special-passives: []
warmup:
time: 5
energy:
enabled: false
abilities: {}
hold-effects: {}
weapons: {}Equipamiento y cómo se asigna la clase
Solo existen cuatro huecos: helmet (cabeza), chestplate (pecho), leggings (piernas) y boots (pies). Un material desconocido se registra en la consola y ese hueco se ignora, lo que hace la clase más fácil de alcanzar sin avisar: revisa la consola tras editar.
Solo se compara el material. Encantamientos, nombres, adornos, durabilidad y datos personalizados no importan: una pechera de netherita con Protección IV y una nueva son la misma pechera para este plugin.
La armadura se vuelve a comprobar cuando un jugador entra (dos ticks después, para que otros plugins le hayan dado su equipo), cuando reaparece, cuando cambia una pieza de armadura, y para todos los conectados al arrancar o recargar el plugin.
- Ya en una clase: si la armadura sigue encajando, no pasa nada. Si no, se quita la clase y se vuelve a asignar desde cero, así que cambiar un set de cuero completo por uno de oro va directo de Archer a un warmup de Bard.
- En un warmup: si la armadura ya no encaja con la clase que se espera, el warmup se cancela y se vuelve a asignar.
- Si no: gana la primera clase cuyo equipamiento encaja y empieza su warmup.
"La primera clase que encaja" es la primera de un mapa sin orden, no la primera por alfabeto ni por nombre de archivo. Dos clases con la misma armadura es una moneda al aire que puede caer distinto tras una recarga.
Tiempos del warmup
El primer mensaje de la cuenta atrás sale un segundo después de ponerte la armadura y muestra time, y la clase se activa un segundo después del mensaje que muestra 1. Un warmup de time: 5 termina por tanto a los seis segundos, y el temporizador de cooldown del cliente, fijado exactamente a time, se vacía un segundo antes.
Notación: efectos, sonidos y partículas
Tres notaciones compactas recorren todos los archivos de clase. Las tres se separan por |, así que una clave con namespace como minecraft:flame es segura.
Efectos, NOMBRE|NIVEL|SEGUNDOS
- SPEED|3 # Velocidad III, 10 segundos, la duración por defecto
- REGENERATION|2|5 # Regeneración II, 5 segundos
- INVISIBILITY|1|infiniteEl nivel es el que lee el jugador: SPEED|2 es Velocidad II. Sin nivel es I. Sin duración son diez segundos. infinite o -1 significa que no caduca solo. passive-effects y special-passives se aplican siempre como infinitos, diga lo que diga la línea, porque el plugin los retira él mismo cuando se quita la clase. Una línea mal escrita se salta en vez de hacer fallar el archivo.
Sonidos, NOMBRE|VOLUMEN|TONO
type: "ENTITY_PLAYER_LEVELUP|1|1.5"Ambos números son opcionales y valen 1 por defecto.
Partículas, NOMBRE|CANTIDAD|DX|DY|DZ|VELOCIDAD
type: "CRIT|60|0.6|0.6|0.6|1"
type: "FLAME|20|0.5" # NOMBRE|CANTIDAD|DISPERSIÓNLa forma de seis campos da una dispersión por eje. También se acepta la forma corta NOMBRE|CANTIDAD|DISPERSIÓN|VELOCIDAD.
¿Falta algo en esta página? Dínoslo en Discord