struct

FootstepComponent

Footstep audio driven by the surface under the character's feet.

Module
Game
Header
#include "Game/Components/FootstepComponent.h"
Namespace
Mowo
Reflection
Reflected by MowoHeaderTool

Cues are found by convention rather than through a mapping table: the cue for a surface is "<cueFolder>/<SurfaceType>.cuegraph", with "Default.cuegraph" as the fallback. A designer adds gravel footsteps by dropping Gravel.cuegraph in the folder — no registry to keep in sync, and a surface with no cue simply stays silent instead of playing the wrong thing.

Properties

TypeNameDescription
boolenabledDefault true.
std::stringcueFolderDefault "Content/Audio/Footsteps".
floatstrideDistanceMetres of horizontal travel between steps at a normal walk. Default 1.7f.
floatsprintStrideScaleDefault 0.75f.
floatcrouchStrideScaleDefault 1.45f.
boolstepOnLandingDefault true.
floatdistanceAccumulatorDefault 0.0f.
Vec3lastPositionDefault Vec3(0.0f, 0.0f, 0.0f).
boolhasLastPositionDefault false.
boolwasGroundedDefault false.
ESurfaceTypelastSurfaceObservable result of the last step — what it decided the ground was and which cue that resolved to. Gameplay, debug overlays and the self-test all read these. Default ESurfaceType::Default.
std::stringlastCuePath
int32_tstepCountDefault 0.
Generated from Game/Components/FootstepComponent.h via game.json · Nov 5, 2026Version 1.0.0