Contenido generado con IA — puede contener errores.

ExyliaLib/Visuales

Displays y NPCs

Objetos sólidos, efectos con línea de tiempo y cuerpos con forma de jugador, enviados por paquetes y animados por el cliente.

Página 32 de 5423 min de lectura
  # Doce espadas que caen del cielo en anillo, girando al venir.  - '[CIRCLE] NETHERITE_SWORD;as:item;radius:2.6;points:12;from:0,9,0;to:0,0,0;spin:2;axis:x;life:0.9;face_out:true;light:15'  # El suelo cediendo: un anillo de bloques, aplastado, creciendo hacia fuera.  - '[CIRCLE] CRYING_OBSIDIAN;as:block;radius:0.3;points:20;size:0.1;size_to:1.4;to:0,0.2,0;life:0.5;light:15'  # Un objeto lanzado hacia arriba, volteando, que vuelve a caer.  - '[DISPLAY] TRIDENT;from:0,0.5,0;to:0,4,0;gravity:14;spin:3;axis:z;life:1.4;size:1.5'  # Una línea de texto que va con quien la lanzó, sobre un panel oscuro.  - '[DISPLAY] {primary}&lCRÍTICO;as:text;rise:0.6;life:1.2;ease:back_out;follow:true;background:#000000;background_alpha:96'   # La víctima, boca abajo, con lo que llevaba al morir, durante cuatro segundos.  - '[NPC] {victim};pose:lying;life:4;equip:true'  # De pie, girada hacia quien lo hizo, con contorno.  - '[NPC] {victim};pose:standing;life:3;glow:{error};face:true'    - 'right:[SOUND] UI_BUTTON_CLICK;0.6;1.4'  - 'right:menu open guide'  - 'shift_left:console: warp %player_name% spawn'  - 'left:[MESSAGE] {error}Oye, que duele.' 

Ninguno de estos crea una entidad real. Todo se dibuja directo al cliente, y cada módulo es dueño de la vida de lo que muestra.

MóduloPunto de entradaQué dibuja
DisplaysDisplays.of(plugin)Displays de objeto, bloque, cabeza y texto que se mueven, giran y caen.
VfxVfx.at(location)Una línea de tiempo de displays, rayos, sonidos, partículas y sacudidas, con avisos en el suelo y números flotantes.
NPCsNpcs.of(plugin)Cuerpos con forma de jugador: un cadáver, una estatua, un doble, o un NPC colocado al que la gente hace clic.
RagdollsRagdolls.of(plugin)Un cuerpo cortado en sus partes y coreografiado. Ver Ragdolls.

Los hologramas y los modelos que llevan los mobs se construyen sobre los mismos displays y tienen su propia página.

Todos necesitan PacketEvents. Sin él el módulo lo dice una vez y no dibuja nada.

Casi nadie toca la API

A los displays, los NPCs y los ragdolls se llega desde una línea de secuencia, que es como los usa cada plugin cosmético del ecosistema. La API es para lo que la configuración no puede describir.

Por qué anima el cliente#

A un display se le dice una pose y cuánto tiempo tiene para llegar, y él dibuja cada frame intermedio al framerate de quien mira. Una animación de dos segundos son unos seis paquetes por espectador, y sigue fluida en un servidor a quince ticks por segundo, porque la fluidez nunca dependió del tick.

Mover algo reenviando su posición cada tick es una animación de veinte fotogramas por segundo que empeora bajo carga — que es a lo que se parece una estela de partículas fingiendo ser un objeto.

Los displays no sustituyen a las partículas

Los displays dan peso, silueta y sombra. Las partículas dan luz, humo y ambiente. Los efectos que parecen caros son las dos cosas.

Dibujar un display desde una secuencia#

Cualquier línea de forma pasa a ser una línea de display diciendo con qué se dibuja:

yaml
effects:
  # Doce espadas que caen del cielo en anillo, girando al venir.
  - '[CIRCLE] NETHERITE_SWORD;as:item;radius:2.6;points:12;from:0,9,0;to:0,0,0;spin:2;axis:x;life:0.9;face_out:true;light:15'
  # El suelo cediendo: un anillo de bloques, aplastado, creciendo hacia fuera.
  - '[CIRCLE] CRYING_OBSIDIAN;as:block;radius:0.3;points:20;size:0.1;size_to:1.4;to:0,0.2,0;life:0.5;light:15'
  # Un objeto lanzado hacia arriba, volteando, que vuelve a caer.
  - '[DISPLAY] TRIDENT;from:0,0.5,0;to:0,4,0;gravity:14;spin:3;axis:z;life:1.4;size:1.5'
  # Una línea de texto que va con quien la lanzó, sobre un panel oscuro.
  - '[DISPLAY] {primary}&lCRÍTICO;as:text;rise:0.6;life:1.2;ease:back_out;follow:true;background:#000000;background_alpha:96'

as: dice qué es la primera palabra de la línea:

as:La primera palabra es
itemUn material, o {item:nombre} para un objeto que el plugin entrega al reproducirla. La de por defecto en [DISPLAY].
blockUn material o un estado de bloque completo: oak_stairs[facing=north].
headUna textura, {victim} o {killer}.
textUna línea de texto; los %placeholders% se rellenan en cada reproducción.

Cómo se mueve#

ParámetroQué hacePor defecto
life:Segundos que existe; 1500ms también vale.1
from:x,y,zDónde empieza, relativo a su punto.0,0,0
to:x,y,zDónde termina.0,0,0
rise:Atajo de to:0,n,0.
gravity:Bloques por segundo al cuadrado, sumados a la línea.0; lo vanilla ronda 32
ease:La curva, abajo. Un nombre desconocido es lineal.linear
spin:Vueltas en toda su vida; x,y,z voltea en tres ejes.0
axis:Alrededor de qué eje gira un spin de un solo número.y
orbit:Vueltas que da cada punto alrededor del ancla.0
vary:Cuánto difieren de tamaño las piezas, como fracción.0
size:Un número, o x,y,z para una placa, un pilar o una hoja.1
size_to:El tamaño con el que acaba.el de size
tilt: roll: turn:Una rotación fija, en grados.0
face_out:Cada punto mira hacia fuera del centro.false
pull:Cuánto viaja cada punto hacia el centro; negativo lo lanza hacia fuera.0
follow:true lo sienta sobre quien lanzó la secuencia, así va donde vaya; victim sobre la víctima.se queda quieto
glow:Color del contorno: un nombre, #rrggbb o un token {palette}.ninguno
light:Nivel de luz fijo, de 0 a 15.la luz de donde está
model:Custom model data, para objetos y cabezas.ninguno
billboard:FIXED, VERTICAL, HORIZONTAL, CENTER.FIXED, CENTER para texto
hold:Contexto del item display, de 0 a 8: 0 el modelo, 5 cabeza, 7 tirado, 8 marco.0

orbit: es el movimiento que una línea recta no puede expresar y el que separa una forma que aparece de una forma que está viva. vary:0.4 da a las piezas tamaños que difieren hasta dos quintos — un hash de la posición de cada punto, no un número aleatorio, así que es igual en cada reproducción. spin:0.5,2,1 voltea en tres ejes, porque nada que se lanza en el mundo gira sobre uno solo.

Curvas#

linear, in, out e in_out son las curvas simples. back se pasa y vuelve, anticipate retrocede antes de salir, elastic rebota como un muelle, bounce aterriza y bota, snap salta directo al final, smooth pasa por cada pose sin esquinas y hold se queda quieto hasta el final. Las familias sine, quad, cubic, quart, quint, expo, circ, back, elastic y bounce aceptan _in, _out o _in_out: back_out, quart_in_out. También se lee easeOutQuart.

Líneas de texto#

ParámetroQué hacePor defecto
background:Color del panel, o none.sin panel
background_alpha:El alfa del panel, de 0 a 255.64
opacity:Opacidad del texto, de 0 a 255.opaco
see_through:Se ve a través de las paredes.true
text_shadow:Sombra como la del chat.false
align:left, center o right.center
line_width:Ancho de ajuste, en píxeles.200
view_range:Un múltiplo de la distancia de entidades del cliente. Cualquier tipo de línea.1
cull:Caja de culling, cull:4 o cull:4,3, para una pieza ancha que desaparece en el borde de la pantalla. Cualquier tipo de línea.la del cliente
Los text displays no dibujan panel

Un text display no tiene fondo salvo que se ponga uno. Antes de la 1.311 conservaba el panel gris del cliente; un efecto que dependía de él ahora quiere background:#000000;background_alpha:64.

Hacer que un movimiento aterrice#

ease:in para un golpe

Retiene el movimiento y lo gasta tarde: una preparación y un impacto, con los mismos dos números. back_out es lo contrario: llega pronto, se pasa y se asienta.

gravity: solo para escombros

Se suma a la línea en vez de sustituirla, así que from:0,9,0;to:0,1,0;gravity:40 baja ocho bloques y luego cae doce más, atravesando el suelo. La mitad de gravity por la vida al cuadrado es lo que cae: un segundo en el aire pide unos 5.

size: para el peso

size:3,0.15,3 es un bloque aplastado en placa. Creciendo desde nada es una onda expansiva; estirado al revés es un pilar o una hoja.

size_to: para la llegada

Unos puntos más grande al impactar, o más pequeño en una preparación. Es la diferencia entre un objeto que llega y un objeto que se coloca.

Una hoja se apunta con roll:, no con tilt:

Un modelo de objeto es una placa plana en su propio plano XY, mirando al sur, con la punta de una espada arriba a la derecha. roll:135 la pone con la punta abajo, roll:315 con la punta arriba, roll:225 de punta según su cara. El giro va al revés que la regla de la mano derecha, así que una hoja que sale horizontal pide sumar o restar 90. face_out: y turn: se aplican después de roll: y tilt:, que es el orden que necesita un anillo. Un display de bloque es un cubo y no necesita nada de esto.

light:15 merece la pena en casi cualquier efecto: un display iluminado por el mundo es negro de noche, y un efecto que desaparece al anochecer es un efecto que los jugadores reportan como roto.

La API de displays#

java
PluginDisplays displays = Displays.of(this);
 
DisplayModel blade = DisplayModel.item(new ItemStack(Material.NETHERITE_SWORD))
        .glow(0xFF6B9D)
        .light(15);
 
DisplayMotion thrown = DisplayMotion.builder()
        .life(1200)
        .from(0, 7, 0).to(0, 0, 0)
        .spin(Rotation.Axis.Z, 3)
        .ease(DisplayMotion.Easing.BACK_OUT)
        .build();
 
displays.show(blade, thrown, where, observers);
PluginDisplaysQué hace
show(model, motion, at, viewers)Muestra un display a una lista fija; se quita solo al acabar el movimiento. Devuelve un DisplayHandle, o null si nadie puede verlo o falta PacketEvents.
show(model, motion, at, radius)Un público seguido: quién está en rango se vuelve a leer cada medio segundo, y a quien se acerca se le manda a medio vuelo.
show(model, motion, at, radius, who)Seguido, con un filtro.
rideOn(model, motion, entity, viewers)Sentado sobre una entidad; el cliente lo lleva.
removeAll() / active() / isSupported()Todo lo que muestra este plugin, cuántos, si se puede.

DisplayModel es item, block, text(component) o text(player -> component) para una línea distinta por espectador, y luego glow, light, billboard, held, y para texto background, opacity, seeThrough, textShadow, align y lineWidth. shadow(radius, strength) da a cualquier display una sombra en el suelo, y solo existe en la API.

Movimientos#

DisplayMotionQué es
builder()life, from, to, scale, rotation, spin, gravity, ease, y easePosition, easeRotation, easeScale para una curva cada uno; turnTo(rotation) gira hacia una pose mientras avanza.
chain(a, b, c…)Movimientos seguidos, cada uno con su curva: subir, quedarse, caer.
between(from, to, millis, easing)Un deslizamiento entre dos keyframes, por el camino corto.
spline(keyframes, life)Una curva suave que pasa por cada keyframe.
of(keyframes, life) / still(life)Poses exactas, o ninguna.
looping(cycle, accel, maxSpeed)Se repite, opcionalmente acelerando en cada ciclo.

Cambiar un display mientras se reproduce#

Cada llamada sobre un DisplayHandle es segura desde cualquier hilo.

DisplayHandleQué hace
showing(item), text(…), glow(rgb), light(level), restyle(model)Cambia cómo se ve; el movimiento sigue intacto.
pose()Dónde está en pantalla ahora.
then(motion)Reproduce un movimiento nuevo desde ahí.
moveTo(keyframe, millis, easing)Se desliza a una pose, conservando la vida más larga que le quedara.
speedUp(factor)Reproduce el resto más rápido.
settle(millis)Vuelve suavemente a donde empezó y se va.
remove() / isShowing()Vida.
java
DisplayHandle reel = displays.show(DisplayModel.item(icon),
        DisplayMotion.builder().life(10_000).spin(Rotation.Axis.Z, 40).build(), at, 24);
 
reel.showing(nextIcon);       // cambia el objeto, el giro sigue
reel.speedUp(2.0);            // el rodillo frena porque se le dice que acabe antes

Vfx, avisos en el suelo e indicadores#

Un Vfx es un efecto escrito como línea de tiempo: qué pasa en qué milisegundo, reproducido como una unidad y cancelado como una unidad. Es como se construye en código el golpe de un jefe, la apertura de una caja o un sorteo.

java
Vfx slam = Vfx.at(centre).track(48);
Telegraphs.circle(slam, 0, centre, 5, 900, 0xFF9500);       // se llena en 0,9 s: el margen para esquivar
 
DisplayMotion rubble = DisplayMotion.chain(
        DisplayMotion.builder().life(150).to(0, 0.6, 0).ease(DisplayMotion.Easing.OUT).build(),
        DisplayMotion.builder().life(300).from(0, 0.6, 0).to(0, -0.2, 0).ease(DisplayMotion.Easing.BOUNCE_OUT).build());
 
slam.sound(900, Sound.ENTITY_GENERIC_EXPLODE, 0.8f, 0.6f)
    .display(900, DisplayModel.block(Material.DEEPSLATE.createBlockData()).light(15), rubble, centre)
    .shake(900, 10, 2, 50);
 
VfxRun run = slam.play(plugin);
run.cancel();                 // el lanzador murió preparando el golpe
VfxQué hace
at(location)Empieza uno.
viewers(players) / nearby(radius) / track(radius)Quién lo ve: una lista, todos los que estén en rango al construirlo, o todos los que estén en rango mientras se reproduce.
lod(true)Menos detalle; se activa solo a partir de quince espectadores.
display(at, model, motion) / ride(at, model, motion, entity)Un display.
beam(at, from, to, model, thickness, life)Un rayo entre dos puntos.
sound, particle, fireworkLo que dicen; el cohete es un paquete, no una entidad.
lines(at, sequence, target)Reproduce una secuencia compilada.
shake(at, radius, times, every)Sacude la cámara de los jugadores en rango.
call(at, runnable)Ejecuta código en ese momento.
play(plugin)Lo reproduce y devuelve un VfxRun: cancel(), speedUp(factor), isDone(), viewers().

El efecto entero cuenta contra max-per-effect; lo que se pasa se descarta y se cuenta en dropped().

Los avisos en el suelo muestran dónde va a caer algo. Son placas de cristal tumbadas en el suelo, iluminadas, y su relleno hace de temporizador:

TelegraphsForma
circle(vfx, at, centre, radius, fillMillis, rgb)Un disco que se llena hacia fuera.
ring(…)Un anillo que se cierra hacia dentro.
cone(vfx, at, apex, yaw, radius, degrees, fillMillis, rgb)Un cono, para un tajo.
line(vfx, at, from, to, width, fillMillis, rgb)Una franja, para una embestida o una grieta.
cross(vfx, at, centre, length, fillMillis, rgb)Una cruz.

Los indicadores flotantes son los números que saltan de algo golpeado:

java
Indicators numbers = Indicators.of(plugin).range(32);
numbers.damage(entity, finalDamage, critical);
numbers.heal(player, 4);
numbers.text(entity, Text.component("{warning}Bloqueado"));

Los golpes del mismo tipo en menos de 0,3 s se juntan en un solo número sumado, como mucho flotan cuatro sobre una entidad, y el rango por defecto es de 24 bloques. El daño se dibuja en {error}, un crítico en {warning} con un ✦, y una curación en {success} como +4 ❤. Se llaman desde el hilo de la propia entidad.

NPCs#

Desde una secuencia#

yaml
effects:
  # La víctima, boca abajo, con lo que llevaba al morir, durante cuatro segundos.
  - '[NPC] {victim};pose:lying;life:4;equip:true'
  # De pie, girada hacia quien lo hizo, con contorno.
  - '[NPC] {victim};pose:standing;life:3;glow:{error};face:true'
ParámetroQué hacePor defecto
pose:lying, standing, crawling, sneaking o spinning. Una pose desconocida queda de pie.lying
life:Segundos que se queda, de 0.2 a 120.5
equip:Lleva la armadura y el arma que tiene puestas.true
glow:Color del contorno.ninguno
y:Altura sobre el ancla.0
face:Se gira hacia quien lanzó la secuencia.true
from:x,y,z / to:x,y,zDónde aparece y dónde termina.0,0,0
over:Segundos que tarda el movimiento.0.7
move_after:Segundos antes de que empiece el movimiento o el respingo.0
ease:out, in, in_out o linear.out
gravity:Bloques por segundo al cuadrado, sumados a la línea.0
turn:Grados que gira sobre sí mismo durante el movimiento.0
pose_to: / after:Una segunda pose, y cuánto antes de ella.ninguna / 0.4
hurt:Da un respingo en rojo al aparecer.false
spin:Grados por segundo que sigue girando, toda su vida.0
bob: / bob_every:Bloques que sube y baja en bucle, y cuánto tarda una subida y bajada.0 / 1.6
swing:Segundos entre golpes de brazo.0
scale:A qué tamaño se dibuja, 1 tamaño jugador.1
hold: / offhand:Un material en cada mano.lo suyo
pitch:Inclinación de la cabeza en grados, negativo hacia arriba.0

spin: es el que hay que usar cuando un cuerpo no debe asentarse: turn: es un giro repartido en el movimiento y luego terminado, spin: no para nunca. Un cuerpo atrapado en un vórtice es spin:220, uno colgando en la luz es bob:0.3;spin:40, y uno que sigue golpeando a lo que lo mató es swing:0.5;hold:NETHERITE_SWORD. scale: es el atributo de escala del propio cliente (de 0.0625 a 16), así que crece el modelo entero; necesita un cliente 1.20.5, y uno más viejo ve un cuerpo de tamaño jugador.

Un cuerpo se lee mejor con más o menos la mitad de la gravedad vanilla. pose:lying es la pose en la que se dibuja a un jugador durmiendo, que es la única forma de poner un cuerpo en el suelo sin un modelo propio.

Por qué un NPC no acepta un nombre de jugador

{victim} y {killer} leen la textura de la conexión que el servidor ya tiene — sin consulta, sin espera, sin fallo a medias. Un nombre sería una petición a Mojang, y un efecto no puede esperarla, así que la línea lo rechaza. Una textura en base64 se acepta, pero no lleva firma, y un cliente moderno dibuja una textura sin firmar como la skin por defecto.

Desde código#

java
PluginNpcs npcs = Npcs.of(this);
 
NpcHandle body = npcs.show(NpcModel.of(victim)
                .wearing(victim)
                .pose(NpcPose.LYING)
                .glow(0xA33B53),
        victim.getLocation(), 4000, observers);
 
body.lookAt(killer.getLocation());

NpcModel es of(player), of(name, texture, signature) u of(name) para la skin por defecto, y luego pose, glow, wearing, holding, offHand y scale. Un NpcMotion pasado a show describe el mismo movimiento que la línea. El NpcHandle puede look, lookAt, pose, moveTo (un salto corto se desliza, uno largo salta), teleportTo, using(true) para levantar un arco o un escudo, equip, swing, hurt y remove.

Un NPC siempre tiene identidad propia

Se anuncia bajo un UUID propio, nunca el del portador: una segunda entrada bajo el id de un jugador real le quita su propia skin de su propio cuerpo hasta que se reconecte. También se anuncia sin listar, así que nunca aparece en el tab junto a jugadores reales.

NPCs colocados#

Un NPC colocado se queda donde se pone hasta que se quita: un tendero, alguien que da misiones, un guía del lobby. Se dibuja para cada jugador en rango y se quita cuando se alejan.

java
PlacedNpc guide = npcs.place("guide", NpcSpec.builder()
        .skin(NpcSkin.player("Notch"))
        .look(NpcLook.EACH_VIEWER)
        .lookRange(10)
        .equip(EquipmentSlot.HAND, new ItemStack(Material.COMPASS))
        .animations(animations)                  // leídas de la config, abajo
        .build(), location);
 
guide.visibleIf(player -> player.hasPermission("lobby.guide"));
guide.onClick((player, click) -> menus.open(player, "guide"));
NpcSpecQué hacePor defecto
skinNpcSkin.none(), player(name), texture(value, signature), o mirror(): cada espectador ve su propia skin.ninguna
poseSTANDING, SNEAKING, LYING…STANDING
scaleDe 0.0625 a 16.1
glowContorno, dibujado en el más cercano de los dieciséis colores de equipo.ninguno
equip(slot, item)Lo que lleva puesto y en las manos.nada
lookFIXED mira hacia donde apunta su ubicación; NEAREST gira una cabeza hacia el jugador más cercano; EACH_VIEWER se gira hacia cada jugador en su propia pantalla.FIXED
lookRangeCuánto tiene que acercarse un jugador para que lo mire.8
viewDistanceBloques; más allá no se dibuja.48
sittingSe sienta en un asiento invisible, con las caderas en la ubicación.false
animationsAnimaciones de clic, de espera y de saludo.ninguna
  • Rango. Quién lo ve se calcula fuera del hilo principal cuatro veces por segundo. visibleIf se comprueba en cada pasada y solo debe leer memoria.
  • Skins. player(name) lee la skin de un jugador conectado de su conexión, y si no se la pide a Mojang fuera del hilo principal, una vez por arranque. El NPC lleva la skin por defecto hasta que llega y entonces se redibuja. Una texture sin su firma se dibuja como la skin por defecto.
  • La cabeza. Sin nadie en rango, una cabeza girada vuelve a su sitio en más o menos un segundo.
  • Sin nombre ni entrada en el tab. El nametag siempre está oculto y la colisión desactivada. Una vez dibujado sale de la lista de jugadores, así que los comandos dejan de autocompletarlo.
  • Clics. Solo puede hacerle clic un jugador que lo tenga dibujado, y un segundo clic en menos de 200 ms se descarta. onClick se ejecuta en el hilo de ese jugador con un Click.

PlacedNpc también tiene moveTo, update(spec), swing, hurt, play(animation), perform(performance), isViewing, viewerCount y remove; npcs.placed(id), allPlaced() y unplace(id) los encuentran.

Animaciones#

NpcAnimations es una sección de configuración, así que los dueños del servidor las ponen por NPC:

yaml
animations:
  left-click: 'flinch'
  right-click: 'wave'
  idle: 'nod'
  idle-every: 20s
  greet: 'wave'
  greet-range: 4.0
  greet-cooldown: 30s
  perform-range: 24.0
ClaveCuándo se reproducePor defecto
left-click / right-clickAl hacer clic, para todos los que lo ven, antes del manejador del clic.ninguna
idle / idle-everyCon un temporizador, solo mientras alguien lo ve. 0 nunca.ninguna / 20s
greetPara un jugador que se acerca, y solo lo ve ese jugador.ninguna
greet-range / greet-cooldownCuánto acercarse, y cuánto hasta saludar otra vez al mismo jugador.4 / 30s
perform-rangeCuánto tiene que acercarse un jugador para que se le muestre una actuación.24

Un valor es un preset — wave, wave-offhand, nod, bow, flinch, punch, cheer — o movimientos separados por comas, con esperas entre ellos: swing, 250ms, offhand, 1s, crouch, 500ms, stand. Los movimientos son swing, offhand, hurt, crouch y stand; una animación que se agachó siempre acaba de pie. Son paquetes vanilla y no necesitan resource pack.

Actuaciones de ragdoll#

Un valor con : es una actuación: el NPC se oculta y un ragdoll con su skin baila en su lugar, y luego el NPC vuelve. Conserva su hitbox todo el rato, así que se le puede seguir haciendo clic.

ValorQué se reproduce
anim:waveplugins/<TuPlugin>/animations/wave.json.
emote:<id>Un emote que el plugin resuelve con npcs.emotes(id -> …).
follow:1;keys:…Opciones de [RAGDOLL] que acaban en keys:.

Las opciones no escritas son intact:0;follow:1;breathe:1. Se reproduce una actuación a la vez; un bucle para a los ocho segundos salvo que se diga otra cosa. Una actuación se salta mientras el NPC está sentado, cuando no hay nadie dentro de perform-range o cuando su emote no existe. Mover o cambiar el NPC la termina.

Clics como configuración: Interactions#

Los NPCs colocados y los hologramas entregan un clic como un Click — LEFT, RIGHT, SHIFT_LEFT o SHIFT_RIGHT. Interactions convierte una lista de líneas de configuración en lo que hace ese clic:

java
Interaction onGuide = Interactions.compile(this, config.guideClick(), "npc guide");
guide.onClick((player, click) -> onGuide.run(player, click, Map.of("npc", "guide")));
yaml
guide-click:
  - 'right:[SOUND] UI_BUTTON_CLICK;0.6;1.4'
  - 'right:menu open guide'
  - 'shift_left:console: warp %player_name% spawn'
  - 'left:[MESSAGE] {error}Oye, que duele.'

Una línea puede empezar con un filtro — left:, right:, shift_left:, shift_right:, shift:, any:, o varios como left,right: — y sin filtro vale para cualquier clic. Luego [DELAY] 1s, [SERVER] nombre, [TELEPORT] world;x;y;z, [ACTION] ns:id, [MONEY] take|give <cantidad> [moneda] (un cobro que no pueden pagar corta las líneas siguientes), [BROADCAST] <texto>, [CHANCE] 30 (las líneas siguientes corren el 30% de las veces), [URL] https://example.net;Título (un diálogo nativo de abrir o copiar, que vale con una pantalla abierta), [HUD] <texto>;group:kill y [MOMENT] <texto> (un aviso y un gran momento en el HUD), cualquier otro [TOKEN] reproducido como línea de secuencia para quien hizo clic, o un comando: suelto o player: como el jugador, console:, player-proxy: o console-proxy:. Los %placeholders% se resuelven para quien hizo clic, primero desde el mapa data. Un paso rechazado corta las líneas que vienen detrás. Interactions.token(plugin, name, token) añade un token propio del plugin.

Ragdolls#

Un cuerpo cortado en sus seis partes y movido como coreografía: lanzado, abierto, deletreado en letras, bailado fotograma a fotograma o importado de Blockbench y Emotecraft. Tienen su propia página: Ragdolls.

Skins reales: ragdoll-skin-quality#

Los ragdolls llevan la skin real del jugador a través de Exylia Skins, sin clave ni cuenta. El ajuste y cómo funciona están en la página de Ragdolls.

Lo que garantizan#

Nada que el servidor cargueNo son entidades: ni se tickean, ni se guardan, ni están en ningún chunk, ni tienen hitbox. Dos jugadores juntos pueden ver cosas distintas.
Nada se puede quedar atrásNada más los limpiaría, así que el módulo es dueño de su vida: se van al acabar el movimiento o la vida, al desactivar el plugin o al parar el servidor.
Un temporizador, no uno por objetoTodos los displays del servidor se mueven desde un único driver asíncrono.
El giro se trocea por tiEl cliente gira por el arco más corto, así que los giros se parten en sextos de vuelta; spin:3 sale bien sin que nadie lo sepa.
Trabajo con techoUn movimiento corto se limita a cuarenta y ocho poses, y uno largo a una pose por tick hasta 256, en vez de mandar lo que pida el archivo.
PacketEvents o nadaNo hay respaldo que valga la pena fingir.

El techo de lo que pueden costar los displays#

plugins/ExyliaLib/displays.yml tiene tres números para todo el servidor, porque lo que se le puede mandar a un cliente es un hecho del servidor y no del plugin que lo mandó.

plugins/ExyliaLib/displays.yml
yaml
max-viewer-displays: 20000
max-per-effect: 128
max-model-parts: 30000
ClaveQué limita
max-viewer-displaysPares display-espectador a la vez: un display que ven treinta jugadores cuenta como treinta. Los efectos que se pasarían se descartan antes de construir sus paquetes, así que una arena llena pierde la cola de un efecto y no su tick rate. La consola lo dice como mucho una vez por minuto. 0 quita el techo.
max-per-effectCuántos displays puede dibujar una sola forma o un Vfx — un points:900 escrito a mano se caza al cargar y no en el cable.
max-model-partsCubos de modelo por espectadores. Pasados tres cuartos, los modelos se dibujan con menos detalle; no se rechaza nada. 0 quita el techo.

El presupuesto cuenta espectadores porque es el número que llega a la red: doscientos displays en una esquina vacía no son nada, y esos mismos doscientos con treinta jugadores alrededor son seis mil entidades en clientes que además tienen una pelea que renderizar. /exylialib reload recoge un cambio; no hace falta reiniciar.

Flags de región#

Flags de WorldGuard que registra la librería, para que una región pueda rechazar efectos sin que ningún plugin dependa de WorldGuard:

FlagNegarla impide
kill-effectsQue suenen efectos de muerte donde alguien murió dentro de la región.
hit-effectsQue suenen efectos de golpe por un impacto dado dentro de la región.
arrows-effectsLos efectos de lanzamiento, estela e impacto de flechas dentro de la región.

Se registran desde el onLoad de la propia librería, porque WorldGuard bloquea su registro en el instante en que se activa. En un servidor sin WorldGuard toda flag permite, y una flag sin registrar, un mundo que falta o un registro rechazado responden igual: una puerta a la que no se puede preguntar nunca retiene nada.

¿Falta algo en esta página? Dínoslo en Discord