struct

CharacterControllerComponent

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

Properties

TypeNameDescription
boolenabledDefault true.
floatradiusDefault 0.3f.
floatheightDefault 1.8f.
floatmassDefault 70.0f.
floatmaxSlopeAngledegrees Default 50.0f.
floatmaxStrengthDefault 100.0f.
floatstepHeightMax step-up height Default 0.35f.
floatstepForwardTestDefault 0.15f.
floatstepMinForwardDefault 0.02f.
floatstepDownExtraDefault 0.0f.
floatstickToFloorDistanceDefault 0.5f.
boolcollideWithCharactersDefault false.
floatcrouchHeightScaleDefault 0.55f.
booluseGravityAuto-gravity (applied automatically in PhysicsSystem when not grounded) Default true.
Vec3gravityDefault Vec3(0.0f, -9.81f, 0.0f).
uint8_tlayerPhysics layer (0-31) for collision filtering Default 2.
boolphysicalPresenceA kinematic rigid body shaped like the capsule, carried along by the controller. Without it the character exists ONLY inside its own sweep: it is never added to the broad phase, so bullets, melee traces, explosion overlaps, AI line-of-sight and the scanner all pass straight through a player. Clear it only for a deliberately non-interactive proxy (a spectator, a replay ghost). Default true.
boolpushBodiesWhether the character shoves dynamic bodies it walks into (bounded by maxStrength), and whether moving bodies shove it back. Default true.
boolpushableDefault true.
ECollisionPresetcollisionPresetChannel responses the inner body registers with, so a character answers traces the same way a collider does. Preset seeds the whole set; the overrides below apply when it is Custom. Default ECollisionPreset::Pawn.
ECollisionChannelobjectTypeDefault ECollisionChannel::Pawn.
ECollisionResponseresponseToVisibilityDefault ECollisionResponse::Block.
ECollisionResponseresponseToCameraDefault ECollisionResponse::Block.
ECollisionResponseresponseToProjectileDefault ECollisionResponse::Block.
boolcontrollerLiveRuntime state (managed by PhysicsSystem). The controller itself lives in PhysicsSystem (GetCharacterController); this only says one is live. Default false.
boolnetDrivenStepped by its owner's network moves (FCharacterNetDriver on the server), one step per move with that move's time, and never by the frame: CharacterMovementSystem and the physics character pass skip it. Default false.
FPhysicsBodyIdinnerBodyIDThe inner body Jolt created for the capsule. Invalid when physicalPresence is off or body creation failed.
boolisGroundedDefault false.
Vec3groundNormal
Vec3linearVelocityThe character's own velocity, relative to whatever it stands on. The platform's share is carried separately in groundVelocity and folded back in when the feet leave it, so a jump off a moving platform keeps the platform's velocity.
Vec3groundVelocityVelocity of the ground body at the contact point (linear plus angular about the contact). Zero on static ground or in the air.
FPhysicsBodyIdgroundBodyID
ESurfaceTypegroundSurfaceWhat the character is currently standing on. Jolt tracks the ground contact's sub-shape, so this is the painted terrain layer or the struck mesh triangle under the feet, not the whole body's material. Default ESurfaceType::Default.
boolwantsCrouchShapeCrouch capsule request/state: gameplay (CharacterMovementSystem) sets wantsCrouchShape; PhysicsSystem applies it each tick and reports back the actual shape (standing up stays refused under a low ceiling). Default false.
boolisCrouchedShapeDefault false.
Generated from Physics/Components/CharacterControllerComponent.h via physics.json · Nov 4, 2026Version 1.0.0