struct
CharacterMovementComponent
- Module
- Physics
- Header
#include "Physics/Components/CharacterMovementComponent.h"- Namespace
Mowo- Reflection
- Reflected by MowoHeaderTool
Properties
| Type | Name | Description |
|---|---|---|
bool | enabled | Default true. |
float | walkSpeed | Default 4.0f. |
float | sprintMultiplier | Default 1.7f. |
float | crouchMultiplier | Default 0.5f. |
float | airControl | Default 0.25f. |
float | maxAcceleration | Default 20.0f. |
float | brakingDeceleration | Default 20.0f. |
float | groundFriction | Default 8.0f. |
float | jumpSpeed | Default 5.0f. |
int32_t | maxJumpCount | Jumps before landing (1 = no double jump). UE's JumpMaxCount. Default 1. |
float | jumpHoldTime | Variable 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. |
float | coyoteTime | Coyote time: a ground jump is still allowed this long after walking off a ledge. Default 0.1f. |
float | flySpeed | Default 8.0f. |
float | swimSpeed | Default 3.0f. |
float | ladderSpeed | Default 2.5f. |
bool | ledgeGrabEnabled | Default true. |
float | mantleMaxHeight | Default 1.2f. |
float | mantleReach | Default 0.7f. |
float | mantleDuration | Default 0.35f. |
bool | useRootMotion | Root-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. |
bool | rootMotionRotation | Also 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. |
EMovementMode | mode | Default EMovementMode::Walking. |
uint8_t | customMode | FCustomMovementModes id while mode == Custom. Default 0. |
Vec3 | moveInput | Default Vec3(0.0f, 0.0f, 0.0f). |
bool | wantsSprint | Default false. |
bool | wantsCrouch | Default false. |
bool | wantsJump | Default false. |
bool | jumpHeld | The 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_t | jumpCount | Default 0. |
float | jumpHoldRemaining | Default 0.0f. |
float | timeSinceGrounded | Default 0.0f. |
std::vector<FRootMotionSource> | rootMotionSources | Active 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_t | nextRootMotionSourceId | Default 1. |
bool | isSprinting | Default false. |
bool | isCrouching | Default false. |
bool | inWater | Written 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. |
float | submergedDepth | Default 0.0f. |
Vec3 | waterFlow | Downstream 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). |
bool | onLadder | Written 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. |
Vec3 | ladderAxis | Default Vec3(0.0f, 1.0f, 0.0f). |
float | ladderTopY | Default 0.0f. |
bool | ledgeDetected | Written by PhysicsSystem's ledge probe (previous frame's rays): a mantleable ledge top in front of the character while airborne. Default false. |
Vec3 | ledgeTarget | Default Vec3(0.0f, 0.0f, 0.0f). |
float | mantleTime | Default 0.0f. |
Constructors
| Signature | Name | Description |
|---|---|---|
CharacterMovementComponent() = default | CharacterMovementComponent |
Public functions
| Returns | Name | Description |
|---|---|---|
uint16_t | AddRootMotionSource | |
void | RemoveRootMotionSource |
Function details
CharacterMovementComponent
C++
CharacterMovementComponent() = defaultAddRootMotionSource
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