Locomotion

Velocity-driven animation hooks and prefab animation asset reloading for performer entities.
Categories:
Tags:

The Locomotion system bridges entity movement to animation. The VelocityLocomotionHookComponent samples entity velocity each tick and pushes values into the EMotionFX animation graph, driving blend trees without manual parameter management. The PrefabAnimAssetsReloaderComponent supports hot-reloading animation assets during development.

For usage guides and setup examples, see The Basics: GS_Performer.

 

Contents

VelocityLocomotionHookComponent

Reads the entity’s current velocity each tick and writes locomotion parameters (speed, direction) to the EMotionFX animation graph. This drives blend trees automatically — characters walk, run, and idle based on their actual movement speed.

PropertyTypeDescription
Speed ParameterAZStd::stringThe EMotionFX parameter name to write speed values into.
Direction ParameterAZStd::stringThe EMotionFX parameter name to write direction values into.

PrefabAnimAssetsReloaderComponent

Hot-reloads prefab animation assets during development without requiring a full level restart. Monitors animation asset files for changes and reapplies them to the entity’s EMotionFX actor.

Setup

  1. Add VelocityLocomotionHookComponent to an entity with an EMotionFX actor and a movement system (GS_Unit mover or physics rigidbody).
  2. Configure the speed and direction parameter names to match your EMotionFX blend tree parameters.
  3. Add PrefabAnimAssetsReloaderComponent during development for faster animation iteration.

See Also

For related component references:

For conceptual overviews and usage guides:

Get GS_Performer

GS_Performer — Explore this gem on the product page and add it to your project.