# Animation Events
## Overview
In Airship animation events are passed to Typescript through the AnimationEventListener component. If you add this component to your animator it will pass along events from your animations. Airship Characters have this component by default.
{% hint style="info" %}
Naming is important here. All animation events must fire the function "TriggerEvent" to be passed into Typescript.
{% endhint %}
## Create Animation Events
To setup an event use Unity's animation event system either in the animation clip itself using the animation window, or on an FBX using the inspector window.
1. Create a new animation event
2. Give it the function `TriggerEvent`
3. Set the triggers key to be whatever you would like to identify it by
MyAnimationEvent On Animation Clip
MyAnimationEvent On FBX Animation
## Listening To Animation Events
To listen to events in Typescript, get the component reference for the AnimationEventListener, then connect to the OnAnimationEvent Signal on Character.animator:
```typescript
//Get the component (or you can setup a reference if in an AirshipBehaviour)
const events = this.gameObject.GetComponent();
if(events){
//Connect to simple events
events.OnAnimEvent((key)=>{
//Key is the string value you specify in editor
if(key === "MyAnimationEvent"){
///Do Stuff
print("Heard my event!");
}
})
}
```
{% hint style="info" %}
Characters by default have an AnimationEventListener and can be listened to through a signal on Character.animation.OnAnimationEvent which is more performant than directly accessing the characters AnimationEventListener.
Read more on the [Character Animations Page](/characters/character-animations.md)
{% endhint %}
### Optional - Pass Data With Event
If you need additional data passed along with the event, you can include an AnimationEventData scriptable object.
1. In your project, right click to `Create -> Airship -> Animation Event Data`
1. Fill in the objects data with whatever you want to receive in TS
2. On your animation, Set the event function to `TriggerEventObj`
3. Set the Object variable to the Animation Event Object you created
Now to receive this event in Typescript
```typescript
//Get the component (or you can setup a reference if in an AirshipBehaviour)
const events = this.gameObject.GetComponent();
if(events){
//Connect to object event
events.OnAnimObjEvent((data)=>{
//key is used to identify the event
if(data.key === "MyAnimationEventObj"){
///Do Stuff with the extra data
print("New Float: " + data.floatValue);
}
})
}
```
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://docs.airship.gg/unity-for-airship/animation-events.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.