Contenido generado con IA — puede contener errores.

ExyliaClasses/GuíasActualizada en v1.9.0

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.

Página 4 de 208 min de lectura
    - REGENERATION|1       - SPEED|3  - DAMAGE_RESISTANCE|2     - SPEED|3          # Velocidad III, 10 segundos, la duración por defecto- REGENERATION|2|5 # Regeneración II, 5 segundos- INVISIBILITY|1|infinite  

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:

lang/en/classes/Medic.yml
yaml
display-name: "<#63ff8a><bold>MEDIC</bold>"
permission: "NONE"
 
equipment:
  helmet: DIAMOND_HELMET
  chestplate: DIAMOND_CHESTPLATE
  leggings: DIAMOND_LEGGINGS
  boots: DIAMOND_BOOTS
 
passive-effects:
  - REGENERATION|1

Comprueba 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#

yaml
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#

yaml
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"
ClavePor defectoCuándo se dispara
time5Segundos. El mensaje de cuenta atrás se envía una vez por segundo.
sound / particleapagadoCada segundo de la cuenta atrás.
sound-completed / particle-completedapagadoEn el momento en que se activa la clase.
sound-cancel / particle-cancelapagadoCuando 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#

ClavePor defectoQué hace
display-nameel idEl 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.
permissionNONEEl permiso que necesita el jugador. NONE, vacío o ausente significa cualquiera.
equipmentningunoLa armadura que mete al jugador en la clase.
passive-effectsningunoEfectos que se mantienen mientras se lleva la clase. Mira Pasivas.
special-passivesningunoEfectos que se mantienen mientras se cumple una condición. Mira Pasivas.
warmup5 segundosLa espera antes de que se active la clase.
energyapagadaEl recurso que gastan las habilidades. Mira Energía.
abilitiesningunaObjetos de clic derecho. Mira Habilidades.
hold-effectsningunoEfectos mientras se sostiene un objeto. Mira Habilidades.
weaponsningunaUn 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.

lang/es/classes/Archer.yml
yaml
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.

  1. 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.
  2. En un warmup: si la armadura ya no encaja con la clase que se espera, el warmup se cancela y se vuelve a asignar.
  3. 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

yaml
- SPEED|3          # Velocidad III, 10 segundos, la duración por defecto
- REGENERATION|2|5 # Regeneración II, 5 segundos
- INVISIBILITY|1|infinite

El 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

yaml
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

yaml
type: "CRIT|60|0.6|0.6|0.6|1"
type: "FLAME|20|0.5"          # NOMBRE|CANTIDAD|DISPERSIÓN

La 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