Event editor
The event editor is used to add events to animations. It can be opened by selecting the Tools > Animation Events menu option.
Animation events include the following:
- Triggering of sounds such as footfalls or weapon impacts
- Firing of projectiles
- Triggering VFX
- Drawing or sheathing a weapon
This allows the game to synchronize the effects of a creature's actions with the animation that the creature is playing.
The main window of the event editor consists of a large nested list of all of the animations in the game's resources. They are grouped based on a prefix.name system. For example, the animations bow.aim, bow.enter, bow.fire and bow.withdraw are all grouped under "bow" and c_chicken.p, c_chicken.wkf, and c_chicken.com_v1 are grouped under "c_chicken".
Below the main window is a timeline, somewhat similar to the cutscene editor. The scale is in frames per second and covers the duration of the animation. since the animation itself cannot be modified in the event editor the length of the timeline is fixed, though it can be scaled for easier viewing. Events are added by placing the scrubber at the frame you want to add the event on and right-clicking on it, or alternately by selecting the Add Event command from the Edit menu. See below for the list of animation event types.
To the right of the main window is a creature or placeable view port where you can preview animations while placing their events.
Animation event types
The type of event is determined by its ID property, which is initially set to Invalid for all new events. All events can have a String property, and certain types of events can have additional properties set on them. The available event types and their additional properties are:
- Invalid - does nothing.
- Attack Impact
- HandOrFoot - Right or Left
- Attack Impact Reaction
- HandOrFoot - Right or Left
- Equip Right
- Equip Left
- Unequip Right
- Unequip Left
- Ability Cast Impact
- HandOrFoot - Right or Left
- PlayHitSound - True or False
- VFX Start
- Projectile Load
- Projectile Fire
- Blend Start
- Blend End
- Animation Done
- Foot Down
- HandOrFoot - Right or Left
- Detonate Emitter
- Movement sound
- Movement scale - Unknown, Small, or Medium
- Bodyfall
- Weapon swish
- HandOrFoot - Right or Left
- Play Custom Sound
- Sound - an FSE file
- Weapon Blocked
- HandOrFoot - Right or Left
- Lock Movement
- Unlock Movement
- Set Next Transition
- Set Animation Offset
- Play placeable sound
- Animation ID - ClosedToOpened, Destroyed, Hit, Locked, OpenToClosed, or Used (as defined in the sound_plc_column_names 2da)
- Deathblow Decapitation
- Sound - an FSE file
- Deathblow Decapitation VFX
- Deathblow Damage Impact
- Deathblow Attack Merge
- Deathblow Death Merge
- Game Speed
- Attach Point
- Fly Start
- Fly End
- Attach Point (with Rotation)
- VFX Instant
