Animaciones y Emotes

Configuración de emotes

Cada emote es un archivo .yml en animations/. El nombre del archivo (sin extensión) es el namespace del emote. Cada animación dentro del archivo se registra como namespace:nombre_animacion.

Ejemplo simple

animation: greet.animation.json

Si greet.animation.json contiene una animación llamada "wave", el emote se invoca con /animorph emote greet:wave @a.

Ejemplo con propiedades

animation: dance.animation.json
properties:
  freeze: true
  stop:
    on_death: true
    on_hurt: false
  controller_exceptions:
    - arm_right
    - arm_left
  layer_emotes:
    pompompurin: dance

Referencia de campos

Emotes por layer

Además de emotes a nivel de modelo, Animorph soporta emotes por layer. Esto permite reproducir animaciones independientes en cada layer del modelo.

Desde el servidor (API o comandos), puedes reproducir emotes en layers específicos:

// Reproducir emote solo en un layer
api.playEmote(player, "dance:spin", Set.of("pompompurin"));

// Detener emote en layers específicos
api.clearEmote(player, Set.of("pompompurin"));

O definir emotes de layer automáticos en el YAML con layer_emotes, para que al reproducir el emote principal, los layers indicados reproduzcan su propio emote simultáneamente.

Controladores de animación

Los controladores se evalúan en orden de prioridad. El primero que tenga una animación activa gana para ese ciclo de renderizado.

Regístralos en el YAML del modelo:

properties:
  animation_controllers:
    idle:
      transition_time: 0
    simple_pose:
      transition_time: 0
    extended_pose:
      transition_time: 5          # blend entre animaciones (en ticks)
      animation_transitions:
        standing.jump: 0          # override: sin blend al saltar
        standing.fall: 2          # override: blend rápido al caer
    emote:
      transition_time: 2
    mount_pose:
      transition_time: 0
    turn_overlay:
      transition_time: 0
    arm_right:
      transition_time: 0
    arm_left:
      transition_time: 0

animation_transitions permite sobrescribir el transition_time para animaciones específicas. La clave es el nombre de la animación sin el prefijo del controlador (ej. standing.jump, no extended_pose.standing.jump).

Nombres de animación por controlador

Cada controlador busca animaciones con nombres exactos en tu .animation.json. Si la animación no existe, el controlador simplemente no la reproduce.

idle

Controla la orientación de la cabeza del modelo. Siempre está activo si el modelo lo tiene registrado.

simple_pose

extended_pose

Variantes más detalladas de cada estado:

mount_pose

Animaciones específicas según el tipo de montura:

turn_overlay

Overlay que se activa al girar el cuerpo del jugador:

arm_right / arm_left

Poses del brazo según la acción. En primera persona se usa el prefijo fp..

Para el brazo izquierdo, sustituye arm_right por arm_left.

Animaciones por ítem específico

Podés definir una animación de hold para un ítem concreto de Minecraft. Si existe, toma prioridad sobre la animación genérica de hold:

arm_right.hold.<item_id>
arm_right.hold.minecraft:diamond_sword
arm_right.hold.minecraft:bow

arms / fp_arms

Ambos brazos a la vez. Se usan principalmente en primera persona (fp.arms.*).

emote

No usa nombres fijos. Reproduce la animación declarada en el .animation.json que referencia el YAML del emote.

Animation Controllers custom

Los animation controllers custom son máquinas de estados exportadas desde Blockbench que usan condiciones Molang para determinar qué animación reproducir.

Uso

1. En Blockbench, crea un Animation Controller en la pestaña de animaciones.
2. Exporta como JSON y colócalo en animations/ (la misma carpeta de animaciones).
3. Añádelo a animation_controllers en el modelo con una clave libre y el campo file apuntando al archivo.

properties:
  animation_controllers:
    idle:
      transition_time: 0
    simple_pose:
      transition_time: 0
    mi_controlador:
      file: mi_controlador.animation_controller.json

Coloca el archivo en:

plugins/Animorph/animations/mi_controlador.animation_controller.json

Estructura del JSON

{
  "format_version": "1.10.0",
  "animation_controllers": {
    "controller.animation.mi_controlador": {
      "initial_state": "idle",
      "states": {
        "idle": {
          "animations": ["idle"],
          "transitions": [
            { "walking": "query.limb_swing_amount > 0.1" }
          ]
        },
        "walking": {
          "animations": ["pose.standing"],
          "transitions": [
            { "idle": "query.limb_swing_amount < 0.1" }
          ]
        }
      }
    }
  }
}

Queries Molang

Queries personalizadas disponibles en condiciones de transición y propiedades de animación:

Ejemplos de uso

// Transición cuando el jugador vuela y se mueve
"query.is_flying && query.limb_swing_amount > 0.05"

// Peso de animación de arco ponderado por carga
"query.use_action == 'BOW' ? math.min(query.use_time / 20.0, 1.0) : 0.0"

// Detectar que el jugador acaba de morir
"query.death_time > 0"

Conversión desde EmoteCraft

Si tienes animaciones en formato EmoteCraft:

1. Asegúrate de que EmoteCraft está instalado y la animación registrada.
2. Ejecuta: /animorph emote-parser <id_emote>
3. El archivo convertido se guarda en plugins/Animorph/animations/parser/.
4. Crea un YAML referenciando el archivo y recarga con /animorph reload.