Lenguaje de acciones

Una habilidad es una lista de pasos bajo actions:, que se ejecutan de arriba abajo. Cada paso nombra una action y lleva sus propias claves:

actions:
  - action: target_radius
    radius: 6
  - action: require
    check: '%targets_found% >= 1'
    message: '${text.no_target}'
  - action: damage
    damage: 4
  - action: play
    at: targets
    effects:
      - '[SOUND] ENTITY_PLAYER_HURT;1;1'

Claves que acepta cada paso

Un paso también puede nombrar una acción de ExyliaLib de otro plugin por su id completo. condition, permission y chance solo se aplican a los pasos propios de este plugin.

Números y variables

Las claves numéricas aceptan placeholders y fórmulas: '%stacks%', '${radius} * 2'. Los pasos dejan variables que los siguientes pueden leer:

Objetivos y el ancla

Una cadena trabaja sobre una lista de objetivos y un punto ancla.

• La lista de objetivos empieza siendo el jugador o la entidad golpeada (en HIT_PLAYER, HIT_ENTITY, PROJECTILE_HIT), el atacante (en TAKE_DAMAGE) o quien usa el ítem. Los pasos de objetivos la sustituyen.
• El ancla empieza donde cayó el proyectil o en el bloque clicado o roto; si no, en la posición de quien usa el ítem.

Un jugador solo puede elegirse como objetivo si no está en espectador, quien usa el ítem puede verlo y no está desvanecido, y WorldGuard permite el PvP tanto donde está él como donde está quien usa el ítem. Los mobs siempre son elegibles.

target_self

Quien usa el ítem.

target_victim

El jugador o la entidad golpeada, o el atacante en TAKE_DAMAGE. Vacío si no es elegible.

target_attacker

target_clear

Vacía la lista.

target_radius

Solo se toman entidades en línea de visión.

target_look

Toma la entidad a la que mira quien usa el ítem y mueve el ancla hasta ella. Si falla, el ancla va al bloque alcanzado o al final del rayo.

target_chain

Desde el objetivo actual, salta una y otra vez a la entidad elegible y visible más cercana que aún no esté en la cadena. Pone %chain_length%.

anchor

Combate

damage

El daño de este paso no vuelve a disparar los triggers de golpe del propio ítem.

heal

amount (0) medios corazones, o percent-of-max-health (0).

ignite

seconds (3). Si ya arde un fuego más largo, se conserva.

Movimiento

push y pull

launch

up (1) y forward (0, en la dirección a la que mira el objetivo).

teleport

Se conserva la orientación. forward y to_source no comprueban WorldGuard.

Efectos y estados

potion_effect

- action: potion_effect
  potions:
    - 'SPEED|2|10'                 # Velocidad II durante 10 segundos
    - 'STRENGTH|%stacks%|4|false'  # nivel desde una variable, sin partículas

NOMBRE|NIVEL|SEGUNDOS|PARTÍCULAS|ICONO|AMBIENTAL. El nivel es el que leen los jugadores (2 = II; 0 también es I). Los segundos son 10 si se omiten; infinite o -1 no acaba nunca; valen duraciones como 1m30s. También se aplica a mobs.

clear_effects

potions: una lista de nombres de efecto. Vacía, quita todos los efectos.

flag y unflag

- action: flag
  flag: NO_BUILD
  seconds: 10
  only: [COBWEB]

unflag lleva flag y lo quita. Ambos actúan solo sobre jugadores.

Ítems e inventario

repair

percent (1 = completa) del daño de cada pieza, en la armor (true) y la hand principal (true). Pone %repaired%: el Repair incluido lo sigue con un require sobre %repaired% >= 1, así que un uso sin nada dañado se devuelve.

refill

Dos formas:

- action: refill        # llenar los huecos vacíos con un ítem
  fill:
    material: POTION
    potion: {base_type: HEALING, upgraded: true}
  slots: inventory      # inventory | hotbar
  max: 0                # 0 = todos los huecos vacíos
- action: refill        # completar hasta una cantidad
  items:
    - 'ENDER_PEARL|8'
    - 'GOLDEN_APPLE|8'

Ambas ponen %filled%. La primera llena los huecos vacíos. La segunda da lo que falte para llegar a cada cantidad (16 si se omite); lo que no cabe no se entrega.

give

item — un id de ítem especial o un material — y amount (1).

cooldown

Actúa sobre los cooldowns de los objetivos.

inventory

Actúa sobre los jugadores objetivo distintos de quien usa el ítem.

damage_armor

amount por pieza o, si es 0, percent (0.25) de la durabilidad de cada pieza, al menos 1. break (true): una pieza puede romperse; false se detiene con 1 de durabilidad.

Mundo

blocks

- action: blocks
  mode: set
  material: IRON_BARS
  shape: wall
  radius: 2
  height: 4
  distance: 2
  seconds: 8

Los bloques colocados respetan WorldGuard y las comprobaciones de construcción de otros plugins, no sueltan nada, resisten explosiones y pistones, y se restauran si el servidor se apaga antes.

clear pone %cleared% y quita para siempre, sin drops, cada bloque de materials en una esfera, bloque a bloque pasando por las comprobaciones de rotura. Sin materials quita una lista de escombros incorporada: piedra labrada, piedra, pizarra profunda, tierra, grava, arena, netherrack, piedra del End, obsidiana, cristal, hielo, nieve, telarañas, andamios, escaleras de mano, tablones, magma, slime, miel y nieve en polvo. Esa lista incluye terreno natural: escribe materials cuando no sea lo que quieres.

projectile

Es solo visual: no ejecuta pasos al caer.

Avisos

play

effects: — líneas de efectos de ExyliaLib ([SOUND], [PARTICLE], [CIRCLE], [RING_PULSE], [DISPLAY], [LIGHTNING], [DELAY]...). at: self (se oye alrededor de quien usa el ítem), targets, anchor u only_self (solo lo ve y oye quien usa el ítem). radius: hasta dónde se ve. follow: true hace que el efecto se mueva con el jugador sobre el que se reproduce (cada objetivo, o quien usa el ítem), así una señal que dura se queda encima de él.

bar

- action: bar
  seconds: 5
  until-potion: BLINDNESS
  victim:
    text: '${text.blinded_bar}'
    colour: YELLOW
  self:
    text: '${text.flashed_bar}'

Una boss bar en vivo mientras dura el efecto. victim la ve cada objetivo jugador, self quien usa el ítem. Sin objetivos solo se abre self, como una barra que solo ve quien usa el ítem.

Una barra se cierra antes si todos sus objetivos mueren o se desconectan, o si quien usa el ítem se desconecta.

unbar

Cierra la barra de id (por defecto el id del ítem) para quien usa el ítem y los objetivos actuales.

flash

Funde a negro al instante la pantalla de cada objetivo jugador (la pantalla de créditos del End, que se cierra con Escape). Solo visual: la usa el Flashbang.

message

text y to: self, targets o both. %player% es quien usa el ítem. Con both, quien usa el ítem lo recibe dos veces si también es objetivo.

command

command (se sustituye %player%), as console (por defecto) o player, for self (por defecto) o targets.

Flujo

require

Detiene la cadena — y devuelve el uso y el cooldown — salvo que se cumplan todas las claves que lleva:

message se envía cuando la detiene.

set_var

name, y value (una fórmula) o text.

stack

- action: stack
  id: fury
  add: 1
  max: 5
  seconds: 4

Un contador sobre quien usa el ítem que se desvanece: add (1), hasta max (0 = sin tope), olvidado seconds (0 = nunca) después de la última suma, reset para vaciarlo. Pone %stacks%, %stack_level% (stacks − 1) y %stack_full%. Se vacía al morir y al salir.

repeat

times (1), every (10 ticks) y su propia lista actions:. La primera pasada se ejecuta al momento y el resto con el temporizador; los pasos de después de repeat no lo esperan.

stop

Termina la cadena y devuelve el uso y el cooldown.

Invocaciones

- action: summon
  seconds: '${duration}'
  max-alive: 1
  body: {type: MANNEQUIN, fallback: ALLAY, name: '%owner%''s Bard', health: 20}
  move: {mode: FOLLOW, distance: 3}
  aura:
    every: 1
    range: 20
    potions: ['STRENGTH|3|3']

body:

Sin sección body, la invocación es un señuelo invulnerable que lleva el equipo del dueño. Con ella, invulnerable vale false y equipment NONE salvo que se escriban.

move: mode STAY, FOLLOW (distance 3) o WANDER (radius 6, un sitio nuevo cada every 4 segundos).

aura: cada every (1) segundos, si el dueño está dentro de range (12), le da potions y reproduce effects.

turret (no en señuelos): dispara projectile (SNOWBALL) a speed 1.8 cada every (1) segundos al jugador enemigo más cercano dentro de range (14) — en supervivencia o aventura, visible, con PvP permitido — y a los monstruos con target-mobs: true. Cada disparo hace damage (3) con knockback (0.4) y reproduce trail, effects e impact.

effects: líneas spawn, end y swap.

Las invocaciones desaparecen cuando su dueño muere, cambia de mundo o sale, y cuando el plugin se detiene. Los mobs no atacan al dueño. Pone %summons%.

duel

Inicia un duelo entre quien usa el ítem y el primer objetivo que sea otro jugador — así que va tras un trigger de golpe o un paso de objetivos.

El otro jugador no acepta: se lo llevan. Si el duelo no puede empezar — sin rival, alguno de los dos ocupado, sin arena libre — la cadena se detiene y no se gasta nada. Ver Duelos.