> For the complete documentation index, see [llms.txt](https://denniodev.gitbook.io/animation-sequences/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://denniodev.gitbook.io/animation-sequences/quick-start.md).
# Quick Start
### Quick Start — Animation Sequences
This guide helps you set up your first animation sequence using the plugin. You’ll learn how to create and preview VFX, audio, or prefab spawns synced with animation — using a custom SequenceData asset and Animation Events under the hood.
***
#### 1. What is this tool?
**Animation Sequences** is a custom Animation Event editor made for Unity. It allows you to spawn VFX, sounds, prefabs, and call public methods during an animation — with a powerful preview system and Addressables integration.
It works by editing `SequenceData` assets and baking events into the animation using Unity’s `AnimationEvent` system.
***
#### 2. Requirements
Before using, make sure:
* Your prefab has an **Animator** component.
* Your prefab also includes a **SequenceEventsReceiver** on the **same GameObject** as the Animator.
* You’re working with a **prefab instance in the scene** (not a regular GameObject or asset).
***
#### 3. Setup Flow
1. Go to **`Tools > Animation Sequence > Sequence Preview Window`**
2. Select your prefab in the **scene**
3. In the window, click **“Start Edit”**
4. If no `SequenceData` exists yet, click **“Create Sequence Data”**
5. Assign an **Animation Clip** to the SequenceData
6. Click **“Add Event”** to create a new spawner
> 💡 Any `SequenceData` you create will be **automatically added to Addressables** if not already.
***
#### 4. Adding Spawners
Each **spawner** represents something that will be triggered during the animation.
You can configure:
* **Trigger Time** (frame/time)
* **Prefab** to spawn (VFX, mesh, audio source, etc.)
* **Transform offsets**
* **World or Local space**
* Optional **Audio** or **Method** call
***
#### 5. Baking the Animation
After you’ve configured all your spawners, you need to **bake** them into the animation clip.
Click the **“Bake”** button to inject Animation Events directly into the selected clip. These events are later used at runtime by the `SequenceEventsReceiver` to trigger the VFX, sounds, prefabs, or method calls.
{% hint style="warning" %}
#### Read-Only Clips (FBX / Imported Animations)
If the animation clip comes from a **read-only source**, such as an imported FBX file, Unity doesn’t allow modifying it directly.\
In this case, the plugin will **prompt you to duplicate the clip** before continuing.
This is a Unity limitation — only `.anim` files (created inside Unity) can be edited directly.
{% endhint %}
**What happens:**
* You choose a location to save the duplicate `.anim` file
* The new clip is linked to the SequenceData
* It is also automatically added to the Animator Controller (if needed)
* You can then bake events into this new, editable clip
***
#### 6. Runtime Execution
At runtime:
* `SequenceEventsReceiver` receives the Animation Events
* It parses the event data, loads the Addressable, and spawns it at the right position
* Method calls (if defined) are invoked directly on the specified component type
