UCharacterMovementComponent

class Engine Blueprint Since 4.0

Inherits: UObjectBase › UObjectBaseUtility › UObject › UActorComponent › USceneComponent › UMovementComponent › UNavMovementComponent › UPawnMovementComponent › UCharacterMovementComponent

#include "GameFramework/CharacterMovementComponent.h"

Description

The movement component used by ACharacter. Handles walking, falling, swimming, flying, crouching, and jumping, with built-in network prediction support.

Caveats & Gotchas

• Access it via ACharacter::GetCharacterMovement() — do not add it manually, ACharacter creates one automatically.
• All movement parameters (MaxWalkSpeed, JumpZVelocity, etc.) are replicated-friendly but must be set on the server or using RPC patterns for authoritative movement.
• Custom movement modes can be added by overriding PhysCustom() — but this requires understanding the movement simulation loop.

Example

Modify walk speed at runtime C++

GetCharacterMovement()->MaxWalkSpeed = 600.f;

Functions (5)

Utility 2 CharacterMovement 2 Movement 1

Utility

2 ▼

Access	Type	Name	Description
public	function	UCharacterMovementComponent::IsFalling	Returns true if the character is currently in the Falling movement mode, which includes both the upward and downward phases of a jump.
public	function	UCharacterMovementComponent::Launch	Queues a velocity launch to be applied on the next movement update, overriding the current velocity.

CharacterMovement

2 ▼

Access	Type	Name	Description
public	function	UCharacterMovementComponent::AddImpulse	Applies an instantaneous impulse to the character's velocity.
public	function	UCharacterMovementComponent::SetMovementMode	Immediately changes the character's movement mode.

Movement

1 ▼

Access	Type	Name	Description
public	function	UCharacterMovementComponent::IsMovingOnGround	Returns true if the character is currently in Walking or NavWalking movement mode.

Properties

Access	Type	Name	Description
public	property	UCharacterMovementComponent::JumpZVelocity	The instantaneous vertical velocity applied to the character when a jump begins.
public	property	UCharacterMovementComponent::MaxWalkSpeed	The maximum ground speed in cm/s when walking.

Version History

Introduced in: 4.0

Version	Status	Notes
5.6	stable	—

Feedback

Was this helpful?