Displays y NPCs

Tres módulos con la misma forma: ninguno crea una entidad real, los tres se dibujan directo al cliente y los tres son dueños de la vida de lo que muestran.

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

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.

Dibujar un display desde una secuencia

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

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'

Cómo se mueve

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 en dos quintos — es un hash de la posición de cada punto, no un número al azar, así que sale igual cada vez. spin:0.5,2,1 voltea en tres ejes, porque nada lanzado en el mundo gira sobre exactamente uno.

Hacer que un movimiento aterrice

Vale la pena poner light:15 en casi todos los efectos: 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

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)
        .build();
 
displays.show(blade, thrown, where, observers);

NPCs

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, girado hacia quien lo hizo, con contorno.
  - '[NPC] {victim};pose:standing;life:3;glow:{error};face:true'

spin: es el que se usa cuando un cuerpo no debe asentarse: turn: es un giro repartido en el movimiento y luego se acaba; 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, así que crece el modelo entero — 0.4 es un muñeco y 2.5 es algo para lo que la sala se queda pequeña; necesita un cliente 1.20.5, y uno más viejo ve un cuerpo de tamaño normal.

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());

Un cuerpo se lee mejor a la mitad de la gravedad vanilla: uno real pesa más de lo que el ojo espera y va más lento de lo que dice el número. pose:lying es la pose de un jugador durmiendo, que es la única forma de dejar un cuerpo en el suelo sin un modelo propio; pose:standing con face:true es otro efecto completamente distinto: alguien que se ha parado y te está mirando.

Ragdolls

Un cuerpo que se deshace. El jugador se corta en sus seis partes — cabeza, torso, dos brazos, dos piernas —, cada una con los colores de su propia skin, y esas partes se mueven como una sola coreografía: lanzadas, abiertas, girando, aplastadas, deletreadas en letras o llevadas enteras.

effects:
  # Reventado. Las piezas salen hacia fuera, caen, rebotan y se quedan.
  - '[RAGDOLL] {victim};intact:0.3;life:2.6;speed:4.2;up:6.4;spin:2.2;detail:2;light:15'
  # Levantado, abierto y llevado hacia arriba. No queda nada en el suelo.
  - '[RAGDOLL] {victim};pose:vortex;rise:3.0;open:0.7;turns:1.8;life:3.0;detail:2;glow:{highlight}'

La cabeza acepta {victim}, {killer} o una textura en base64, igual que [NPC]. Si lo que murió no era un jugador, la línea lo dice una vez y no dibuja nada.

Las poses

Sus parámetros

PluginRagdolls ragdolls = Ragdolls.of(this);
 
ragdolls.show(RagdollModel.of(victim).detail(2).light(15),
        RagdollMotion.builder().pose(RagdollPose.VORTEX).rise(3.0).build(),
        victim.getLocation(), observers);

Skins reales: mineskin-key

De serie, la cabeza de un ragdoll lleva la cara real del jugador, pero el resto del cuerpo se dibuja con bloques: cada pieza toma el bloque de color más parecido a esa parte de la skin. Por eso una ropa oscura se ve como un cuerpo negro hecho de bloques. Para que todo el cuerpo lleve la skin real, ExyliaLib necesita una clave de la API de MineSkin, puesta en el plugins/ExyliaLib/config.yml de la propia ExyliaLib:

mineskin-key: 'tu-clave'
ragdoll-skin-quality: normal

• Se hace una vez por skin. Una skin se prepara cuando entra su dueño, se sube en segundo plano y se guarda en la base de datos del plugin que muestra los cuerpos (su database.yml, tabla exylia_ragdoll_skins). Ese servidor, o una network que comparta esa base de datos, no la vuelve a subir nunca.
• Los límites del plan gratuito. El plan gratuito de MineSkin permite 20 subidas por minuto y 100 por hora. Pasada la hora, las subidas esperan a que se reinicie y la consola dice cuándo vuelven a empezar.
• Nunca se espera. Una pieza cuya textura aún no ha llegado se dibuja con bloques hasta que llega.
• Se aplica en caliente. /exylialib reload lee las dos claves, y un cambio de clave o de calidad vuelve a preparar las skins de todos los conectados.

Lo que garantizan los tres

El techo de lo que pueden costar los displays

plugins/ExyliaLib/displays.yml tiene dos 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ó.

max-viewer-displays: 20000
max-per-effect: 128

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:

Se registran desde el onLoad de la propia librería, porque WorldGuard cierra su registro en cuanto arranca. En un servidor sin WorldGuard cada flag permite, y una flag no registrada, un mundo que no existe o un registro que se negó responden igual: una puerta que no se puede preguntar nunca quita nada.