struct

CharacterMovementComponent

Module
Physics
Header
#include "Physics/Components/CharacterMovementComponent.h"
Namespace
Mowo
Reflection
Reflected by MowoHeaderTool

Properties

TypeNameDescription
boolenabledDefault true.
floatwalkSpeedDefault 4.0f.
floatsprintMultiplierDefault 1.7f.
floatcrouchMultiplierDefault 0.5f.
floatairControlDefault 0.25f.
floatmaxAccelerationDefault 20.0f.
floatbrakingDecelerationDefault 20.0f.
floatgroundFrictionDefault 8.0f.
floatjumpSpeedDefault 5.0f.
int32_tmaxJumpCountJumps before landing (1 = no double jump). UE's JumpMaxCount. Default 1.
floatjumpHoldTimeVariable jump height: while jump stays held, the jump keeps its launch speed for up to this long. 0 = every jump is the same height. UE's JumpMaxHoldTime. Default 0.0f.
floatcoyoteTimeCoyote time: a ground jump is still allowed this long after walking off a ledge. Default 0.1f.
floatflySpeedDefault 8.0f.
floatswimSpeedDefault 3.0f.
floatladderSpeedDefault 2.5f.
boolledgeGrabEnabledDefault true.
floatmantleMaxHeightDefault 1.2f.
floatmantleReachDefault 0.7f.
floatmantleDurationDefault 0.35f.
booluseRootMotionRoot-motion locomotion: while walking, the animation's extracted root delta (AnimatorComponent::rootMotionDeltaPosition, which needs rootMotionEnabled on the animator) drives the capsule instead of the input velocity. Input still steers facing/jump; horizontal speed comes from the clip. Falls back to input velocity when no animator delta is available. Default false.
boolrootMotionRotationAlso fold the root delta's yaw into the character's facing while root-motion driven (turn-in-place / pivots authored in the clip). Default false.
EMovementModemodeDefault EMovementMode::Walking.
uint8_tcustomModeFCustomMovementModes id while mode == Custom. Default 0.
Vec3moveInputDefault Vec3(0.0f, 0.0f, 0.0f).
boolwantsSprintDefault false.
boolwantsCrouchDefault false.
boolwantsJumpDefault false.
booljumpHeldThe jump button's level, not its edge: wantsJump is consumed by the step that jumps, this stays true while the button is down and drives jumpHoldTime. Default false.
int32_tjumpCountDefault 0.
floatjumpHoldRemainingDefault 0.0f.
floattimeSinceGroundedDefault 0.0f.
std::vector<FRootMotionSource>rootMotionSourcesActive root-motion sources, advanced by every movement step (so the server's per-move step and the client's replay both run them). Gameplay adds them with AddRootMotionSource.
uint16_tnextRootMotionSourceIdDefault 1.
boolisSprintingDefault false.
boolisCrouchingDefault false.
boolinWaterWritten by the Game-tier CharacterWaterSystem (the movement system in Physics can't reach the water query directly): whether a water surface covers the character, and how deep the FEET sit below it. Default false.
floatsubmergedDepthDefault 0.0f.
Vec3waterFlowDownstream flow (m/s) of the covering water surface, written by the Game-tier CharacterWaterSystem. Non-zero only inside a river body; the swim branch adds it to the character's velocity so the current carries the swimmer. Default Vec3(0.0f, 0.0f, 0.0f).
boolonLadderWritten by CharacterLadderSystem: whether a LadderVolume covers the character and the world-space axis to climb along (normalized, usually up). Swimming/Flying/Mantling take priority; otherwise entering a ladder volume switches to Ladder mode and constrains motion to this axis. Default false.
Vec3ladderAxisDefault Vec3(0.0f, 1.0f, 0.0f).
floatladderTopYDefault 0.0f.
boolledgeDetectedWritten by PhysicsSystem's ledge probe (previous frame's rays): a mantleable ledge top in front of the character while airborne. Default false.
Vec3ledgeTargetDefault Vec3(0.0f, 0.0f, 0.0f).
floatmantleTimeDefault 0.0f.

Constructors

SignatureNameDescription
CharacterMovementComponent() = defaultCharacterMovementComponent

Public functions

ReturnsNameDescription
uint16_tAddRootMotionSource
voidRemoveRootMotionSource

Function details

CharacterMovementComponent

C++
CharacterMovementComponent() = default

AddRootMotionSource

C++
uint16_t AddRootMotionSource(FRootMotionSource source)

RemoveRootMotionSource

C++
void RemoveRootMotionSource(uint16_t id)
Generated from Physics/Components/CharacterMovementComponent.h via physics.json · Nov 4, 2026Version 1.0.0