Manual de Transiciones de AnimationTree (Godot Engine)

Manual de Transiciones de AnimationTree (Godot Engine)

1. Modos de Transición (Switch Modes)

Estos modos determinan el momento temporal exacto en el que el motor obedece la orden de cruzar la flecha desde una animación (Origen) hacia otra (Destino).

A. Inmediata

Mecánica: Ejecuta el cambio en el mismo milisegundo en que el evento ocurre (ya sea por su GDScript o por el motor). La animación de origen se corta abruptamente sin importar en qué fotograma se encontraba.

Propósito: Otorgarle a usted, el control absoluto e instantáneo para interrumpir acciones a voluntad.

Cuándo aplicarlo:

Acciones de respuesta rápida que sobreescriben la locomoción (Ej: De "Idle" a "Salto" o "Ataque").

Interrupciones de acciones continuas al soltar una tecla (Ej: De "Girar" a "Idle", asumiendo que "Girar" es un bucle infinito que se sostiene con el teclado).

Reacciones críticas del sistema (Ej: Pasar al estado "Recibir_Daño" desde cualquier otro estado).

B. Sincronizar

Mecánica: Realiza el cambio visual de inmediato, pero obliga a la animación de Destino a heredar el porcentaje de tiempo de reproducción de la animación de Origen.

Propósito: Mantener la coherencia biomecánica. Si el avatar tiene la pierna derecha extendida (50% de la animación de caminar), la animación de correr iniciará exactamente en ese mismo 50% de su propio ciclo.

Cuándo aplicarlo:

Exclusivamente para conectar animaciones de locomoción cíclica continuas.

El caso principal es la ruta de ida y de vuelta entre "Caminar" y "Correr". Jamás debe usarse para transicionar hacia acciones estáticas o cortes de ritmo.

C. Al Final

Mecánica: Pone la transición en estado de espera. El motor ignora el cruce de la flecha hasta que la animación de Origen alcance y reproduzca por completo su último fotograma.

Propósito: Garantizar que una acción específica se ejecute en su totalidad para que el jugador visualice el movimiento completo sin mutilaciones gráficas.

Regla de Oro: La animación de Origen no debe ser un bucle infinito (Loop apagado). Si es infinita, el último fotograma nunca llega y su avatar quedará atascado para siempre.

Cuándo aplicarlo:

Acciones singulares o cerradas (One-Shot).

Transiciones de finalización (Ej: Terminar de "Acostarse" para pasar a "Quedarse acostado", o el retorno de "Saludo" hacia "Idle").

2. Avance Automático (Auto Advance)

Representado por el ícono de la letra "A" azul encendida en el panel del Inspector. Es una directriz que releva a su código de la obligación de gestionar el cambio.

Mecánica: Instruye a la máquina de estados de Godot a cruzar la flecha de transición por su propia cuenta tan pronto como el Modo de Transición se lo permita.

Propósito: Construir retornos autónomos. Permite mantener su código GDScript limpio, evitando el uso de temporizadores (Timers) o la vinculación de señales de finalización (animation_finished) para saber cuándo devolver el avatar a su postura base.

Combinación Principal: Se utiliza en sincronía estricta con el modo Al Final.

Ejemplo Práctico: Usted ordena mediante código travel("saludo"). La flecha de retorno (de "saludo" a "idle") tiene configurado el modo Al Final y el Avance Automático activado. Su avatar ejecutará la reverencia de manera íntegra y, en el milisegundo exacto en que la concluya, el motor cruzará la flecha devolviéndolo al reposo sin que usted deba escribir ni una sola línea de código para ordenar el retorno.