Ragdolls

Un cuerpo que se deshace, o que se mueve como uno. El jugador se corta en sus seis partes (cabeza, torso, dos brazos, dos piernas), cada una con su propia skin, y esas partes se mueven como una sola coreografía. Puede ser lanzado, abierto, deletreado en letras o llevado, o bailado fotograma a fotograma.

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}'
  # Un saludo importado de Blockbench, con el retraso y la respiración de un cuerpo.
  - '[RAGDOLL] {victim};anim:wave;follow:1;breathe:1;rig:tophat'

Los ragdolls necesitan PacketEvents, como cualquier display.

A quién lleva

Si no hay ningún jugador que llevar, la línea lo dice una vez y no dibuja nada. Un plugin puede darle a la línea un cuerpo propio con SequenceTarget.wearing(model).

Las poses

Una pose desconocida reproduce burst.

Sus parámetros

Un life: escrito siempre gana. Sin él, un cuerpo en bucle dura cinco minutos como red de seguridad, y uno coreografiado dura su tiempo entero, sus fotogramas y su final.

Coreografía: keys:

keys: es un baile escrito fotograma a fotograma, separados por |. Cada fotograma empieza con los segundos que tarda en llegar a él, y luego una palabra de pose o canales:

effects:
  - '[RAGDOLL] {victim};keys:0.25 crouch ease=anticipate | 0.35 stand up=1.6 flip=~-360 elbows=60 ease=out | 0.3 up=0 plant=1 knees=40 ease=bounce | 0.3 stand;then:dissolve;follow:1'

~ hace un valor relativo: flip=~-360 es una voltereta más. Las palabras de pose son stand, tpose, star, cheer, reach, zombie, hug, crouch, sit, kneel, lie, prone, bow, pray, dab, superman, splits, float, limp, fetal, swoon, heart y arabesque; una palabra de pose deshace todos los dobleces. Un giro de más de 160° por tick se avisa al cargar.

Doblar, plantar y respirar

• Dobleces. Un codo dobla el antebrazo hacia delante, una rodilla la espinilla hacia atrás, la columna el pecho hacia delante. Una dirección de 90 dobla hacia fuera; -90 en un codo lo cruza por delante del cuerpo. Un cuerpo que se dobla se corta en al menos dos filas por extremidad, incluso con detalle 1.
• Pies plantados. Con plant=1 las piernas se resuelven para llegar al suelo, así que un cuerpo que se hunde dobla las rodillas. Los pies se quedan donde estaban cuando plant subió de cero por última vez.
• Respiración. breathe: (de 0 a 3) pone una respiración lenta sobre cada fotograma: la columna, los hombros y la cabeza, una respiración cada 3,4 segundos, ajustada para que un bucle contenga un número entero de ellas.
• Inercia. follow: (de 0 a 3) hace que las articulaciones sueltas vayan con retraso y se pasen: 0 es exacto, 1 un cuerpo, 2 un dibujo animado.

El final: then:

Lo que pasa tras el último fotograma: hold (por defecto), burst, collapse, implode, dissolve o spell.

Bucles y aceleraciones

Una cámara que gira con un cuerpo en bucle es su propia línea [CAMERA] en la secuencia.

Importar animaciones de Blockbench y Emotecraft

plugins/<TuPlugin>/animations/wave.json

Pon el archivo en la carpeta animations del plugin cuya secuencia lo reproduce. Los archivos se leen al primer uso y otra vez cada vez que cambia la carpeta; no hay nada que recargar.

Un archivo con una sola animación se llama como el archivo (wave.json → wave). Un archivo de Emotecraft también responde a su name, y cada animación de un archivo de Blockbench a su clave completa (animation.player.wave) o a su última parte (wave). Los nombres no distinguen mayúsculas. Un archivo que hace bucle pone loop y loop_from por ti.

Props: rigs.yml

plugins/ExyliaLib/rigs.yml guarda cosas hechas de bloques que un cuerpo lleva puestas, sostiene o carga. Es el archivo del servidor, no de un plugin, así que cualquier línea [RAGDOLL] del servidor puede usar cualquier prop: rig:tophat, rig:crown,wand. Viene con tophat, crown, wand y cake.

rigs:
  halo:
    joint: head
    at: 0, 0.25, 0
    blocks:
      - 'ring GOLD_BLOCK r:0.30 n:18 y:0 s:0.08'

Los números van en los ejes de la propia articulación: y sigue la extremidad y z es hacia donde mira el cuerpo. Un prop se resuelve junto con el cuerpo, así que se queda en la mano durante una rueda. Como mucho 256 bloques por prop.

Skins reales: ragdoll-skin-quality

Un ragdoll lleva la skin real del jugador sin configurar nada: ni clave ni cuenta. La cabeza es el objeto de cabeza real del jugador, así que la cara es exacta desde el primer fotograma. El resto del cuerpo se corta en piezas, y cada pieza se convierte en textura con Exylia Skins, un servicio gratuito con una caché compartida por todos los servidores. Una pieza que cualquier servidor ya hizo llega al momento; una nueva se dibuja con bloques del color más parecido hasta que llega. Lo único que se configura es lo fino que se corta el cuerpo, en plugins/ExyliaLib/config.yml:

ragdoll-skin-quality: normal

En cuanto llega cualquiera de sus piezas, un cuerpo con su skin real se corta según esta calidad e ignora detail:.

• Se hace una vez, para todos. Una pieza se nombra por el hash de sus píxeles y se sube una sola vez. Una pieza que es entera del color de un bloque se dibuja como ese bloque y nunca se sube. Cada plugin que muestra cuerpos guarda las piezas que recibió en su propia base de datos (tabla exylia_ragdoll_skins), así que al reiniciar no pide nada.
• Se prepara al entrar. Una skin se prepara cuando entra su dueño. Una skin cambiada en mitad de la sesión (por ejemplo con /skin de SkinsRestorer) se vuelve a preparar la siguiente vez que se lee.
• Modo offline. Un jugador sin skin lleva la skin por defecto que el juego da a su UUID (Steve, Alex y las demás skins por defecto, anchas o finas).
• 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 la calidad, y un cambio vuelve a preparar las skins de todos los conectados.

La API

PluginRagdolls ragdolls = Ragdolls.of(this);
 
RagdollAnimation hop = RagdollAnimation.parse(
        "0.25 crouch ease=anticipate | 0.35 stand up=1.6 flip=~-360 | 0.3 up=0 plant=1 knees=40 ease=bounce",
        problem -> getLogger().warning(problem));
 
RagdollMotion dance = RagdollMotion.builder()
        .pose(RagdollPose.ANIMATE)
        .animation(hop)
        .finish(RagdollFinish.DISSOLVE)
        .follow(1).breathe(1)
        .tempo(1.0, 1.3)
        .build();
 
RagdollProp crown = Rigs.get("crown");
RagdollModel body = RagdollModel.of(victim).detail(2).light(15)
        .rigs(crown == null ? List.of() : List.of(crown));
 
RagdollHandle handle = ragdolls.show(body, dance, victim.getLocation(), viewers);

ragdolls.show resuelve el vuelo entero antes de volver. Aquí no se simula nada ni se tickea nada: cada pose se calcula de antemano y se le entrega al cliente.