Descripción#

Se activa al terminar la animación de un personaje.

Datos del evento#

Campo Tipo / función Significado
event.object Objeto MD Personaje: jugador o NPC.
event.param unknown Identificación de animación.
event.param2 Tiempo MD Tiempo de mezcla restante para la siguiente animación.

Las etiquetas MD describen valores MD y roles semánticos de objetos, no tipos Lua. unknown indica que la fuente no declara la representación exacta; no garantiza nil. No se presuponen campos del evento que no estén enumerados.

Ejemplo de suscripción#

Inserta este fragmento independiente en el nodo cues adecuado de tu script MD. Cambia el nombre WikiWatch si usas varios ejemplos.

XML
<cue name="WikiWatch" instantiate="true" namespace="this">
  <conditions>
    <event_character_animation_finished object="player" />
  </conditions>
  <actions>
    <set_value name="$Character" exact="event.object" />
    <set_value name="$AnimationID" exact="event.param" />
    <set_value name="$BlendTime" exact="event.param2" />
    <debug_text text="'Wiki: event_character_animation_finished received'" />
  </actions>
</cue>

Qué ocurre#

Cada evento que coincide crea una instancia del manejador y copia los campos documentados a sus variables locales. Con la depuración de scripts activada, se espera esta marca de diagnóstico:

TEXT
Wiki: event_character_animation_finished received

Es la salida esperada de un ejemplo didáctico independiente, no de una prueba completada en el juego. Las suscripciones observan eventos sin iniciar la acción de juego subyacente. Evita llenar el log con un mensaje por evento cuando se dispara con frecuencia.

Filtros de suscripción XML#

Estos atributos filtran eventos; no son los campos de datos del evento de la tabla anterior. Tipos de esquema.

libraries/common.xsd

Atributo Tipo de esquema Requerido Predeterminado / fijo
chance expression no no declarada
comment comment no no declarada
object expression no no declarada
group groupeventsource no no declarada
check checkeventsource no no declarada
id expression no no declarada

Valor devuelto#

Es una condición de evento MD, no una función que devuelve una tupla Lua. Lee event.object/event.param en el contexto de acciones MD correspondiente.

Evidencia del contrato#

La correspondencia de campos se contrastó con las anotaciones common.xsd / md.xsd de X4 9.00 (611726). Solo se publican explicaciones propias y ejemplos independientes. La validez del XML por sí sola no demuestra un efecto en el juego.

Tipos y métodos · Cues de MD · Depuración