struct
CharacterControllerComponent
- Module
- Physics
- Header
#include "Physics/Components/CharacterControllerComponent.h"- Namespace
Mowo- Reflection
- Reflected by MowoHeaderTool
Properties
| Type | Name | Description |
|---|---|---|
bool | enabled | Default true. |
float | radius | Default 0.3f. |
float | height | Default 1.8f. |
float | mass | Default 70.0f. |
float | maxSlopeAngle | degrees Default 50.0f. |
float | maxStrength | Default 100.0f. |
float | stepHeight | Max step-up height Default 0.35f. |
float | stepForwardTest | Default 0.15f. |
float | stepMinForward | Default 0.02f. |
float | stepDownExtra | Default 0.0f. |
float | stickToFloorDistance | Default 0.5f. |
bool | collideWithCharacters | Default false. |
float | crouchHeightScale | Default 0.55f. |
bool | useGravity | Auto-gravity (applied automatically in PhysicsSystem when not grounded) Default true. |
Vec3 | gravity | Default Vec3(0.0f, -9.81f, 0.0f). |
uint8_t | layer | Physics layer (0-31) for collision filtering Default 2. |
bool | physicalPresence | A 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. |
bool | pushBodies | Whether the character shoves dynamic bodies it walks into (bounded by maxStrength), and whether moving bodies shove it back. Default true. |
bool | pushable | Default true. |
ECollisionPreset | collisionPreset | Channel 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. |
ECollisionChannel | objectType | Default ECollisionChannel::Pawn. |
ECollisionResponse | responseToVisibility | Default ECollisionResponse::Block. |
ECollisionResponse | responseToCamera | Default ECollisionResponse::Block. |
ECollisionResponse | responseToProjectile | Default ECollisionResponse::Block. |
bool | controllerLive | Runtime state (managed by PhysicsSystem). The controller itself lives in PhysicsSystem (GetCharacterController); this only says one is live. Default false. |
bool | netDriven | Stepped 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. |
FPhysicsBodyId | innerBodyID | The inner body Jolt created for the capsule. Invalid when physicalPresence is off or body creation failed. |
bool | isGrounded | Default false. |
Vec3 | groundNormal | |
Vec3 | linearVelocity | The 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. |
Vec3 | groundVelocity | Velocity of the ground body at the contact point (linear plus angular about the contact). Zero on static ground or in the air. |
FPhysicsBodyId | groundBodyID | |
ESurfaceType | groundSurface | What 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. |
bool | wantsCrouchShape | Crouch 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. |
bool | isCrouchedShape | Default false. |
Generated from Physics/Components/CharacterControllerComponent.h via physics.json · Nov 4, 2026Version 1.0.0