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 (148)

Lifecycle 5 Networking 52 Navigation 7 Utility 4 Avoidance 7 Character Movement: Jumping / Falling 3 CharacterMovement 13 Movement 23 Physics Interaction 2 RootMotion 4 Rotation 3 Swimming 2 Walking 23

Lifecycle

5 ▼

Access	Type	Name	Description
public	function	UCharacterMovementComponent::BeginPlay	Initializes movement-simulation state (such as cached navigation and prediction data) once the component's owning actor has begun play.
public	function	UCharacterMovementComponent::TickComponent	Drives the movement simulation each frame — computes acceleration and rotation for locally controlled characters, or replicates the move to the server for network clients, as described in the class's networking overview comment.
public	function	UCharacterMovementComponent::RegisterComponentTickFunctions	Registers or unregisters this component's tick functions (including the pre-physics and post-physics tick functions) with the actor's tick manager, overriding UActorComponent's base registration.
public	function	UCharacterMovementComponent::PostPhysicsTickComponent	Called after the synchronous physics scene finishes simulating for the frame, before cloth simulation runs.
public	function	UCharacterMovementComponent::PrePhysicsTickComponent	Tick function that runs before the physics simulation step, used to feed movement-derived forces or velocity changes into physics before it advances.

Networking

52 ▼

Access	Type	Name	Description
public	function	UCharacterMovementComponent::ApplyNetworkMovementMode	Decodes a packed network movement mode byte and applies it to the character, setting MovementMode, custom mode, and GroundMovementMode in one step.
public	function	UCharacterMovementComponent::ClientAckGoodMove deprecated	Legacy replicated function that tells the client no adjustment is needed for a given move, so it can be removed from SavedMoves.
public	function	UCharacterMovementComponent::ClientAckGoodMove_Implementation	Called on the client when the server's move response indicates no correction was needed, so the acknowledged move can be removed from the pending SavedMoves list.
public	function	UCharacterMovementComponent::ClientAdjustPosition deprecated	Legacy client RPC the server calls to correct a client's position and velocity after detecting enough prediction error, triggering the client to replay pending moves from the corrected state.
public	function	UCharacterMovementComponent::ClientAdjustPosition_Implementation	Applies a full position/velocity correction sent from the server to a locally controlled client, then replays subsequent unacknowledged moves from the client's saved move list.
public	function	UCharacterMovementComponent::ClientAdjustRootMotionPosition deprecated	Legacy fixed-signature client RPC for root motion position correction, superseded by the packed move response system routed through ClientHandleMoveResponse.
public	function	UCharacterMovementComponent::ClientAdjustRootMotionSourcePosition deprecated	Legacy fixed-signature client RPC for root motion source position correction, superseded by the packed move response system routed through ClientHandleMoveResponse.
public	function	UCharacterMovementComponent::ClientHandleMoveResponse	On the client, interprets the server's move response after it's unpacked, dispatching to ClientAckGoodMove_Implementation() if there was no error, or to one of the root motion/position adjustment implementations otherwise.
public	function	UCharacterMovementComponent::ClientVeryShortAdjustPosition deprecated	Bandwidth-saving variant of the legacy ClientAdjustPosition RPC used when the server's corrected velocity is zero, so only position needs to be sent over the wire.
public	function	UCharacterMovementComponent::ClientVeryShortAdjustPosition_Implementation	Implementation body for the legacy ClientVeryShortAdjustPosition RPC, applying a bandwidth-saving position-only correction (velocity assumed zero) to the local client.
public	function	UCharacterMovementComponent::ConvertRootMotionServerIDsToLocalIDs	Rewrites server-assigned root motion source IDs in InOutServerRootMotion to the equivalent local client IDs, using the most recent ID mappings recorded during move replay.
—	function	DEPRECATED_CHARACTER_MOVEMENT_RPC	Preprocessor macro that decorates the legacy, non-packed character movement RPCs (ServerMove, ServerMoveDual, ClientAdjustPosition, etc.
public	function	UCharacterMovementComponent::FlushServerMoves	Immediately sends any pending client moves to the server rather than waiting for the normal send interval, forcing an out-of-band network update.
public	function	UCharacterMovementComponent::ForceClientAdjustment	Forces the server to send the next available client a movement correction by resetting ServerLastClientAdjustmentTime, bypassing the normal minimum-interval throttling between adjustments.
public	function	UCharacterMovementComponent::ForceReplicationUpdate	Forces a client movement update by making the server behave as though the client hasn't sent an update in a long time, so the next replication check is guaranteed to fire.
public	function	UCharacterMovementComponent::GetLastServerMovementBase	Returns the movement base the character was standing on as of the last processed server move.
public	function	UCharacterMovementComponent::GetPredictionData_Client	Returns the client-side movement prediction data, allocating it on first use.
public	function	UCharacterMovementComponent::GetPredictionData_Client_Character	Returns the concrete Character-specific client prediction data (saved moves, pending move, network smoothing state), allocating it on first use.
public	function	UCharacterMovementComponent::GetPredictionData_Server	Returns the server-side movement prediction data, allocating it on first use.
public	function	UCharacterMovementComponent::GetPredictionData_Server_Character	Returns the concrete Character-specific server prediction data (last acknowledged move, force-update flags, error-checking state), allocating it on first use.
public	function	UCharacterMovementComponent::GetServerLastTransformUpdateTimeStamp	Returns the timestamp of the last transform update the server received or sent for this character's movement.
public	function	UCharacterMovementComponent::HasPredictionData_Client	Returns true if client-side movement prediction data has already been allocated for this component.
public	function	UCharacterMovementComponent::HasPredictionData_Server	Returns true if server-side movement prediction data has already been allocated for this component.
public	function	UCharacterMovementComponent::MoveResponsePacked_ClientReceive	On the client, unpacks a packed move response from the server into the MoveResponseDataContainer and passes it to ClientHandleMoveResponse().
public	function	UCharacterMovementComponent::MoveResponsePacked_ServerSend	Sends a packed move response from the server to the client, routed through the owning Character to avoid component RPC overhead, eventually reaching MoveResponsePacked_ClientReceive() on the client.
public	function	UCharacterMovementComponent::PackNetworkMovementMode	Packs the current MovementMode, CustomMovementMode, and GroundMovementMode into a single byte for efficient replication over the network.
public	function	UCharacterMovementComponent::PackYawAndPitchTo32	Compresses a yaw and pitch pair into a single 32-bit value, packing each axis into 16 bits via FRotator::CompressAxisToShort.
public	function	UCharacterMovementComponent::ResetPredictionData_Client	Frees the allocated client-side movement prediction data (saved moves, pending move, smoothing state) and clears ClientPredictionData back to null.
public	function	UCharacterMovementComponent::ResetPredictionData_Server	Discards the server-side prediction data (FNetworkPredictionData_Server_Character), forcing it to be reallocated on next use.
public	function	UCharacterMovementComponent::SendClientAdjustment	Server-side hook from INetworkPredictionInterface that dispatches a pending correction to the owning client if GetPredictionData_Server_Character()->bForceClientUpdate or ServerCheckClientError() indicate one is needed.
public	function	UCharacterMovementComponent::ServerMove deprecated	Legacy server RPC that a client calls to replicate a single player move — its acceleration input, resultant location, and view — to the authoritative server.
public	function	UCharacterMovementComponent::ServerMove_HandleMoveData	Handles move data on the server after it has been unpacked from the client's RPC.
public	function	UCharacterMovementComponent::ServerMove_Implementation deprecated	Server-side body of the legacy ServerMove RPC — decodes the client's compressed move parameters on the server and forwards them to ServerMove_PerformMovement() to actually simulate the move.
public	function	UCharacterMovementComponent::ServerMove_PerformMovement	Checks timestamps, derives a delta time, and forwards the move parameters to MoveAutonomous() on the server, optionally checking the final location against the client-reported location.
public	function	UCharacterMovementComponent::ServerMove_Validate deprecated	Server-side RPC validation for the legacy ServerMove — returning false causes the engine to disconnect the sending client as a cheat-protection measure.
public	function	UCharacterMovementComponent::ServerMoveDual deprecated	Legacy server RPC that batches two consecutive client moves into a single call, used when a pending move couldn't be sent on its own tick and needs to piggyback on the next one.
public	function	UCharacterMovementComponent::ServerMoveDual_Implementation deprecated	Server-side body of the legacy ServerMoveDual RPC — processes the first (pending) move and then the second move by calling ServerMove_PerformMovement() twice.
public	function	UCharacterMovementComponent::ServerMoveDual_Validate deprecated	Server-side RPC validation for the legacy ServerMoveDual — returning false rejects both packed moves and can flag the connection as sending invalid data.
public	function	UCharacterMovementComponent::ServerMoveDualHybridRootMotion deprecated	Legacy server RPC variant of ServerMoveDual used when a character mixes regular movement with animation root motion — the first move is non-root-motion, the second is root motion.
public	function	UCharacterMovementComponent::ServerMoveDualHybridRootMotion_Implementation deprecated	Server-side body of ServerMoveDualHybridRootMotion — processes the non-root-motion move followed by the root-motion move via ServerMove_PerformMovement().
public	function	UCharacterMovementComponent::ServerMoveDualHybridRootMotion_Validate deprecated	Server-side RPC validation for the legacy ServerMoveDualHybridRootMotion — returning false rejects both packed moves.
public	function	UCharacterMovementComponent::ServerMoveOld deprecated	Legacy replicated function for resending an important old move so the server can process it if it hasn't already been received.
public	function	UCharacterMovementComponent::ServerMoveOld_Implementation deprecated	The RPC implementation body for the legacy ServerMoveOld(), executed on the server when the deprecated RPC path is active.
public	function	UCharacterMovementComponent::ServerMoveOld_Validate	The RPC validation function paired with ServerMoveOld_Implementation(); returning false rejects the RPC before it runs and can trigger a network security violation.
public	function	UCharacterMovementComponent::ServerMovePacked_ClientSend	On the client, wraps the packed move bitstream and forwards it through the owning Character's ServerMove RPC to the server, avoiding per-component RPC overhead.
public	function	UCharacterMovementComponent::ServerMovePacked_ServerReceive	On the server, unpacks the client's move bitstream into the FCharacterNetworkMoveDataContainer and passes the resulting data to ServerMove_HandleMoveData().
public	function	UCharacterMovementComponent::ServerSendMoveResponse	On the server, fills the move response container via ServerFillResponseData(), serializes it, and sends it to the client through MoveResponsePacked_ServerSend().
public	function	UCharacterMovementComponent::ShouldCorrectRotation	Returns whether the server should include a rotation correction when sending a server move response back to the owning client.
public	function	UCharacterMovementComponent::ShouldUsePackedMovementRPCs	Determines whether the packed, variable-length movement RPC path is used instead of the legacy fixed-parameter ServerMove RPCs.
public	function	UCharacterMovementComponent::SmoothCorrection	Reacts to a new transform received from a network update on the client, applying it and clearing bNetworkSmoothingComplete so future smoothing updates blend from the corrected state.
public	function	UCharacterMovementComponent::UnpackNetworkMovementMode	Decodes a movement mode byte produced by PackNetworkMovementMode() back into its base mode, custom sub-mode, and ground mode components.
public	function	UCharacterMovementComponent::VerifyClientTimeStamp	Runs on the server to check that an incoming client move timestamp is valid and has not already expired, also handling a timestamp reset if a large gap is detected.

Navigation

7 ▼

Access	Type	Name	Description
public	function	UCharacterMovementComponent::GetActorFeetLocation	Returns the location of the character's feet — the base of the collision capsule — rather than the capsule's center, which is what GetActorLocation() returns.
public	function	UCharacterMovementComponent::CanStartPathFollowing	Queried by the path following component to check whether this character is currently in a movement state where following a path can begin.
public	function	UCharacterMovementComponent::CanStopPathFollowing	Queried by the path following component to check whether it is safe to stop an in-progress path-following move right now, for example when the move is cancelled or the goal changes.
public	function	UCharacterMovementComponent::FindNavFloor	Projects TestLocation onto the navmesh to find the corresponding navmesh floor height, used for NavWalking movement mode.
public	function	UCharacterMovementComponent::GetPathFollowingBrakingDistance	Returns the distance before the path-following destination at which the path follower should start braking, so the character comes to a stop at the goal instead of overshooting it.
public	function	UCharacterMovementComponent::PerformAirControlForPathFollowing	Adjusts Velocity and Acceleration to steer a falling character toward Direction while it is following a path, letting AI characters correct their trajectory mid-air.
public	function	UCharacterMovementComponent::ShouldPerformAirControlForPathFollowing	Determines whether PerformAirControlForPathFollowing() should run this tick.

Utility

4 ▼

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.
public	function	UCharacterMovementComponent::AddReferencedObjects	Part of the UObject garbage collection interface — reports any UObject references this component holds beyond its reflected UPROPERTY members, so the GC doesn't collect them prematurely.
public	function	UCharacterMovementComponent::GetGravitySpaceComponentZ	Returns the component of a vector that lies along the current gravity-space vertical axis, as a vector rather than a scalar.

Avoidance

7 ▼

Access	Type	Name	Description
public	function	UCharacterMovementComponent::SetAvoidanceEnabled	Enables or disables RVO avoidance for this character, registering or unregistering it with the avoidance manager as needed.
public	function	UCharacterMovementComponent::SetAvoidanceGroup deprecated	Sets which RVO avoidance group this character belongs to, using a raw bitmask integer.
public	function	UCharacterMovementComponent::SetAvoidanceGroupMask	Sets which RVO avoidance group this character belongs to, used by the avoidance system to filter which neighboring agents are relevant to it.
public	function	UCharacterMovementComponent::SetGroupsToAvoid deprecated	Sets the mask of avoidance groups this character should actively avoid, using a raw bitmask integer.
public	function	UCharacterMovementComponent::SetGroupsToAvoidMask	Sets the mask of avoidance groups this character should actively avoid during RVO avoidance calculations.
public	function	UCharacterMovementComponent::SetGroupsToIgnore deprecated	Sets the mask of avoidance groups this character should ignore, using a raw bitmask integer, overriding GroupsToAvoid for matching groups.
public	function	UCharacterMovementComponent::SetGroupsToIgnoreMask	Sets the mask of avoidance groups this character should ignore during RVO avoidance, taking priority over GroupsToAvoid for any overlapping groups.

Character Movement: Jumping / Falling

3 ▼

Access	Type	Name	Description
public	function	UCharacterMovementComponent::GetMaxJumpHeight	Computes the maximum height a jump can reach, based on JumpZVelocity and gravity.
public	function	UCharacterMovementComponent::GetMaxJumpHeightWithJumpTime	Computes the maximum jump height including the extra height gained from holding the jump button for CharacterOwner->JumpMaxHoldTime.
public	function	UCharacterMovementComponent::CheckFall	Determines whether the character should start falling after losing its footing, and if so calls HandleWalkingOffLedge() and transitions it into the Falling movement mode.

CharacterMovement

13 ▼

Access	Type	Name	Description
public	function	UCharacterMovementComponent::GetCharacterOwner	Returns the Character that owns the UpdatedComponent this movement component is driving.
public	function	UCharacterMovementComponent::AddImpulse	Applies an instantaneous impulse to the character's velocity.
public	function	UCharacterMovementComponent::GetGravityDirection	Returns the current normalized gravity direction used by the movement simulation.
public	function	UCharacterMovementComponent::GetGravityToWorldTransform	Returns the cached quaternion that transforms vectors from gravity-relative space back into world space — the inverse of GetWorldToGravityTransform().
public	function	UCharacterMovementComponent::GetLastUpdateLocation	Returns the UpdatedComponent's world location as recorded at the end of the most recent movement update.
public	function	UCharacterMovementComponent::GetLastUpdateRotation	Returns the UpdatedComponent's rotation as recorded at the end of the most recent movement update, converted from the internally stored quaternion.
public	function	UCharacterMovementComponent::GetLastUpdateVelocity	Returns the character's velocity as recorded at the end of the most recent movement update.
public	function	UCharacterMovementComponent::GetWorldToGravityTransform	Returns the cached quaternion that transforms vectors from world space into gravity-relative space, based on the current custom gravity direction.
public	function	UCharacterMovementComponent::HasCustomGravity	Returns whether the character has a custom local gravity direction set, different from UCharacterMovementComponent::DefaultGravityDirection.
public	function	UCharacterMovementComponent::SetMovementMode	Immediately changes the character's movement mode.
public	function	UCharacterMovementComponent::CalcVelocity	Updates Velocity and Acceleration for the current tick by applying friction and acceleration or deceleration.
public	function	UCharacterMovementComponent::GetLastUpdateRequestedVelocity	Returns the velocity most recently requested by path following, such as an AI MoveTo request, and consumed during the last movement update.
public	function	UCharacterMovementComponent::SetGravityDirection	Sets a custom local gravity direction for movement simulation, recomputing the cached world/gravity-space transforms used to orient the character.

Movement

23 ▼

Access	Type	Name	Description
public	function	UCharacterMovementComponent::DisableMovement	Makes movement impossible by setting the movement mode to MOVE_None.
public	function	UCharacterMovementComponent::GetCurrentAcceleration	Returns the current acceleration vector, computed each update from player input and clamped by GetMaxAcceleration().
public	function	UCharacterMovementComponent::IsMovingOnGround	Returns true if the character is currently in Walking or NavWalking movement mode.
public	function	UCharacterMovementComponent::Crouch	Checks that the reduced capsule size fits without encroachment and, if so, shrinks the capsule and calls CharacterOwner->OnStartCrouch().
public	function	UCharacterMovementComponent::GetGroundMovementMode	Returns the movement mode (MOVE_Walking or MOVE_NavWalking) the character will switch to once it stops falling and resumes ground movement.
public	function	UCharacterMovementComponent::GetLastUpdateQuat	Returns the character's rotation as a quaternion at the end of the last movement update tick.
public	function	UCharacterMovementComponent::GetMaxAcceleration	Returns the maximum acceleration for the current movement state.
public	function	UCharacterMovementComponent::GetMaxBrakingDeceleration	Returns the maximum deceleration for the current state when braking, i.
public	function	UCharacterMovementComponent::GetMovementBase	Returns the primitive component the character is currently standing on, or null if not based on anything.
public	function	UCharacterMovementComponent::SetGroundMovementMode	Sets which movement mode (MOVE_Walking or MOVE_NavWalking) the character should switch to when it stops falling and resumes ground movement.
public	function	UCharacterMovementComponent::UnCrouch	Checks that the default (standing) capsule size fits without encroachment and, if so, restores the capsule and calls CharacterOwner->OnEndCrouch().
public	function	UCharacterMovementComponent::GetAnalogInputModifier	Returns a modifier in [0.
public	function	UCharacterMovementComponent::GetImpartedMovementBaseVelocity	If the character has a movement base, returns the velocity that should be imparted from that base, such as when jumping off a moving platform.
public	function	UCharacterMovementComponent::GetMinAnalogSpeed	Returns the minimum speed enforced when moving with partial (analog gamepad) input, for the current movement mode.
public	function	UCharacterMovementComponent::GetSimulationTimeStep	Computes the size of the next movement sub-step given how much time is left in the tick, clamped by MaxSimulationTimeStep and MaxSimulationIterations.
public	function	UCharacterMovementComponent::MaybeSaveBaseLocation	Calls SaveBaseLocation() unless bDeferUpdateBasedMovement is set, in which case the save is skipped for this tick.
public	function	UCharacterMovementComponent::PhysicsVolumeChanged	Called by the engine whenever the character's UpdatedComponent enters a new physics volume.
public	function	UCharacterMovementComponent::RevertMove	Restores the character's position, base, and floor state to a previous snapshot, undoing a move that turned out to be invalid.
public	function	UCharacterMovementComponent::SaveBaseLocation	Updates OldBaseLocation and OldBaseQuat from the current movement base, storing the relative location/rotation if necessary, ignoring bDeferUpdateBasedMovement.
public	function	UCharacterMovementComponent::SetBase	Updates the PrimitiveComponent the character is currently standing on, used for relative movement and move-with-base behavior.
public	function	UCharacterMovementComponent::SetUpdatedComponent	Assigns the component that this movement component drives, overriding UMovementComponent's base implementation to also cache the owning ACharacter and validate that the component is a capsule where required.
public	function	UCharacterMovementComponent — UE_DEPRECATED_FORGAME annotations deprecated	A compiler-warning macro applied to deprecated members of UCharacterMovementComponent.
public	function	UCharacterMovementComponent::UpdateBasedRotation	Applies the movement base's rotation delta to the controller's view rotation so a character standing on a rotating platform turns with it.

Physics Interaction

2 ▼

Access	Type	Name	Description
public	function	UCharacterMovementComponent::AddForce	Queues a continuous force to be applied to the character, scaled by mass and accumulated across multiple calls within the same tick.
public	function	UCharacterMovementComponent::ClearAccumulatedForces	Clears forces accumulated through AddImpulse() and AddForce(), and also cancels any pending launch velocity.

RootMotion

4 ▼

Access	Type	Name	Description
public	function	UCharacterMovementComponent::ClientAdjustRootMotionPosition_Implementation	Applies a position correction from the server while the client is driving movement from animation root motion, also resyncing the client's montage playback position to the server's.
public	function	UCharacterMovementComponent::ClientAdjustRootMotionSourcePosition_Implementation	Applies a position correction from the server while one or more RootMotionSources (e.
public	function	UCharacterMovementComponent::ConvertLocalRootMotionToWorld	Takes a root motion delta transform captured in component space and converts it into a world-space transform, running any bound ProcessRootMotionPreConvertToWorld/ProcessRootMotionPostConvertToWorld delegates around the conversion.
public	function	UCharacterMovementComponent::SimulateRootMotion	Applies animation root motion physics on a simulated proxy, converting the given component-space root motion delta to world space and moving the character accordingly.

Rotation

3 ▼

Access	Type	Name	Description
public	function	UCharacterMovementComponent::ComputeOrientToMovementRotation	Computes the target rotation the character should turn toward based on its current Acceleration, used by PhysicsRotation() when bOrientRotationToMovement is true.
public	function	UCharacterMovementComponent::GetDeltaRotation	Returns how far the character should rotate over the given time interval, based on RotationRate.
public	function	UCharacterMovementComponent::PhysicsRotation	Performs the character's rotation update for the given time slice, combining ShouldRemainVertical(), GetDeltaRotation(), and (if bOrientRotationToMovement is set) ComputeOrientToMovementRotation().

Swimming

2 ▼

Access	Type	Name	Description
public	function	UCharacterMovementComponent::StartSwimming	Handles the internal transition from another movement mode (typically walking or falling) into MOVE_Swimming, consuming the remaining time budget for the current physics step.
public	function	UCharacterMovementComponent::Swim	Performs one swimming move by Delta and, if the character surfaces during the move, slides along the water line.

Walking

23 ▼

Access	Type	Name	Description
public	function	UCharacterMovementComponent::IsWalking	Returns true if the character is currently in a ground movement mode (Walking or NavWalking).
public	function	UCharacterMovementComponent::K2_GetWalkableFloorAngle	Returns the maximum slope angle, in degrees, that the character can walk on without sliding off.
public	function	UCharacterMovementComponent::SetWalkableFloorAngle	Sets the maximum slope angle, in degrees, that the character can walk on, and recomputes WalkableFloorZ to match.
public	function	UCharacterMovementComponent::IsWalkable	Returns true if the hit result should be considered a walkable surface for the character, based on the impact normal's angle relative to WalkableFloorZ.
public	function	UCharacterMovementComponent::K2_FindFloor	Sweeps a vertical trace from CapsuleLocation to find the floor beneath the capsule, writing the result into FloorResult.
public	function	UCharacterMovementComponent::K2_GetWalkableFloorZ	Returns the minimum Z component of a walkable surface's normal, as a value between 0 and 1.
public	function	UCharacterMovementComponent::SetWalkableFloorZ	Sets the minimum Z component of a walkable surface's normal, and recomputes WalkableFloorAngle to match.
public	function	UCharacterMovementComponent::CanStepUp	Returns whether the character is currently allowed to step up onto the actor or component recorded in the given hit result.
public	function	UCharacterMovementComponent::CheckLedgeDirection	Tests whether stepping sideways by SideStep from OldLocation lands on a walkable floor, used to decide whether the character can slide along a ledge instead of falling off it.
public	function	UCharacterMovementComponent::ComputeFloorDist	Computes the swept distance from the bottom of the capsule to the first walkable point of impact and stores the result in OutFloorResult, ignoring whether the capsule's own collision is enabled.
public	function	UCharacterMovementComponent::ComputePerchResult	Sweeps a smaller capsule of TestRadius to determine whether the character could stand perched at the edge represented by InHit, within InMaxFloorDist of the impact point.
public	function	UCharacterMovementComponent::FindFloor	Sweeps a vertical trace to find the floor beneath the capsule at the given location, and attempts to perch at the edge of unwalkable surfaces when ShouldComputePerchResult() allows it.
public	function	UCharacterMovementComponent::FloorSweepTest	Sweeps a shape from Start to End against the world and returns the first blocking hit.
public	function	UCharacterMovementComponent::GetLedgeMove	Computes a replacement move delta that slides the character along a ledge instead of walking off it, based on the original Delta and the last known floor.
public	function	UCharacterMovementComponent::GetPerchRadiusThreshold	Returns the distance from the edge of the capsule within which the character is not allowed to perch on the edge of a surface.
public	function	UCharacterMovementComponent::GetValidPerchRadius	Returns the radius within which the character can stand on the edge of a walkable surface without falling, computed as the capsule radius minus GetPerchRadiusThreshold().
public	function	UCharacterMovementComponent::HandleWalkingOffLedge	Called when the walking movement mode detects the character has walked off a ledge with no floor beneath it, and forwards an OnWalkingOffLedge notification to the owning Character.
public	function	UCharacterMovementComponent::IsValidLandingSpot	Determines whether a hit result is a valid surface for the character to land on when falling, rejecting unwalkable normals, hits above the capsule's lower hemisphere, and hits too close to the capsule's edge.
public	function	UCharacterMovementComponent::IsWithinEdgeTolerance	Returns true if the 2D distance from CapsuleLocation to TestImpactPoint is within the capsule radius minus a small rejection threshold, used to reject hits too close to the capsule's edge.
public	function	UCharacterMovementComponent::K2_ComputeFloorDist	Measures the distance from the base of the capsule at CapsuleLocation down to the floor, using a line trace and/or capsule sweep, and writes the result into FloorResult.
public	function	UCharacterMovementComponent::ShouldCheckForValidLandingSpot	Determines whether an impact during falling movement hit the edge of a surface, such that a downward sweep might find a walkable landing spot above the edge rather than treating the hit as a wall.
public	function	UCharacterMovementComponent::ShouldComputePerchResult	Checks whether a sweep hit might represent a valid perch location, such that ComputePerchResult() should be called to validate it further.
public	function	UCharacterMovementComponent::StepUp	Attempts to move the character up and over a step or shallow slope after a blocking hit.

Properties

Access	Type	Name	Description
public	property	UCharacterMovementComponent::AirControl	Amount of lateral movement control available while falling, from 0 (no control) to 1 (full control at MaxWalkSpeed).
public	property	UCharacterMovementComponent::AirControlBoostMultiplier	Multiplier applied to AirControl while falling when lateral speed is below AirControlBoostVelocityThreshold, giving extra control at low speed.
public	property	UCharacterMovementComponent::AirControlBoostVelocityThreshold	Lateral speed threshold below which AirControl is multiplied by AirControlBoostMultiplier.
public	property	UCharacterMovementComponent::AvoidanceConsiderationRadius	Radius around the character used by the RVO avoidance system to decide which nearby agents to consider when steering around them.
public	property	UCharacterMovementComponent::AvoidanceGroup	Group mask identifying which avoidance group this character belongs to, used together with GroupsToAvoid and GroupsToIgnore to filter RVO neighbors.
public	property	UCharacterMovementComponent::AvoidanceUID	Unique identifier assigned by the avoidance manager when this component registers for RVO avoidance.
public	property	UCharacterMovementComponent::AvoidanceWeight	Relative priority this character gives its own path versus yielding to other agents in RVO avoidance calculations.
public	property	UCharacterMovementComponent::BrakingDecelerationFalling	Lateral deceleration applied while falling and not applying acceleration.
public	property	UCharacterMovementComponent::BrakingDecelerationFlying	Constant deceleration applied while flying and not applying acceleration, used to bring the character to a stop.
public	property	UCharacterMovementComponent::BrakingDecelerationSwimming	Deceleration applied while swimming when the character has no acceleration input, in centimetres per second squared.
public	property	UCharacterMovementComponent::BrakingDecelerationWalking	Constant deceleration applied while walking when there is no input acceleration, used to bring the character to a stop.
public	property	UCharacterMovementComponent::BrakingFriction	Friction coefficient used specifically for braking (stopping), separate from the friction used during normal movement.
public	property	UCharacterMovementComponent::BrakingFrictionFactor	Multiplier applied to whatever friction value is currently in effect when the character is braking (no input, or over max speed).
public	property	UCharacterMovementComponent::BrakingSubStepTime	Time slice used when substepping the braking friction calculation.
public	property	UCharacterMovementComponent::Buoyancy	Ratio controlling how much a character floats while swimming.
public	property	UCharacterMovementComponent::CrouchedHalfHeight deprecated	Capsule half-height to use while the character is crouched, before any component scale is applied.
public	property	UCharacterMovementComponent::CurrentFloor	Cached information about the floor the character is currently standing on — walkability, impact normal, and hit result — updated only during Walking movement.
public	property	UCharacterMovementComponent::CustomMovementMode	The active custom sub-mode when MovementMode is set to MOVE_Custom.
public	property	UCharacterMovementComponent::DefaultLandMovementMode	Movement mode a Character starts with, or reverts to, when not in water — applied at player start and after teleporting.
public	property	UCharacterMovementComponent::DefaultWaterMovementMode	Movement mode a Character starts with, or reverts to, when inside a water volume — applied at player start and after teleporting.
public	property	UCharacterMovementComponent::DeferredUpdatedMoveComponent	Internal failsafe storage for a pending SetUpdatedComponent() call that arrived while a movement update was already in progress; StartNewPhysics() applies it once the update finishes.
public	property	UCharacterMovementComponent::FallingLateralFriction	Friction applied to horizontal movement while falling, slowing lateral velocity over time.
public	property	UCharacterMovementComponent::FormerBaseVelocityDecayHalfLife	Controls how quickly a character retains the velocity of a moving object it just fell off while a root motion override is active, expressed as a half-life in seconds.
public	property	UCharacterMovementComponent::GravityScale	Multiplier applied to gravity for this character.
public	property	UCharacterMovementComponent::GroundFriction	Friction applied while walking on the ground, controlling how quickly the character changes direction and how much it slides.
public	property	UCharacterMovementComponent::GroupsToAvoid	Mask of avoidance groups this character will actively steer around when using RVO avoidance.
public	property	UCharacterMovementComponent::GroupsToIgnore	Mask of avoidance groups this character will not avoid, even if those groups also appear in GroupsToAvoid.
public	property	UCharacterMovementComponent::InitialPushForceFactor	Impulse strength applied to a physics object the instant this character first bumps into it while blocked.
public	property	UCharacterMovementComponent::JumpOffJumpZFactor	Fraction of JumpZVelocity applied when the character is automatically pushed off a base actor it isn't allowed to stand on.
public	property	UCharacterMovementComponent::JumpOutOfWaterPitch	Control pitch angle, in degrees, at or above which the character automatically jumps when exiting water.
public	property	UCharacterMovementComponent::JumpZVelocity	The instantaneous vertical velocity applied to the character when a jump begins.
public	property	UCharacterMovementComponent::LastUpdateRequestedVelocity	The path-following requested velocity that was consumed during the most recent movement update.
public	property	UCharacterMovementComponent::LedgeCheckThreshold	Used to determine whether the character is going off a ledge.
public	property	UCharacterMovementComponent::ListenServerNetworkSimulatedSmoothLocationTime	Same as NetworkSimulatedSmoothLocationTime, but used only when the local machine is running as a Listen Server rather than a dedicated server or pure client.
public	property	UCharacterMovementComponent::ListenServerNetworkSimulatedSmoothRotationTime	Same as NetworkSimulatedSmoothRotationTime, but used only when the local machine is running as a Listen Server rather than a dedicated server or pure client.
public	property	UCharacterMovementComponent::Mass	Mass of the character's pawn, used to compute the momentum/force it imparts onto objects it interacts with physically.
public	property	UCharacterMovementComponent::MaxAcceleration	Maximum rate of change of velocity for the character, controlling how quickly it speeds up or changes direction.
public	property	UCharacterMovementComponent::MaxCustomMovementSpeed	Caps ground speed while the component is in a user-defined Custom movement mode (MOVE_Custom).
public	property	UCharacterMovementComponent::MaxDepenetrationWithGeometry	Maximum distance simulated proxies are allowed to depenetrate per step when resolving overlaps with world geometry, as opposed to other pawns.
public	property	UCharacterMovementComponent::MaxDepenetrationWithGeometryAsProxy	Maximum depenetration distance applied to overlaps with world geometry (not Pawns) specifically when the character is a simulated proxy, used instead of MaxDepenetrationWithGeometry in that case.
public	property	UCharacterMovementComponent::MaxDepenetrationWithPawn	Maximum distance the locally controlled or autonomous character is allowed to depenetrate per step when resolving overlaps with other Pawns.
public	property	UCharacterMovementComponent::MaxDepenetrationWithPawnAsProxy	Maximum distance a simulated proxy is allowed to depenetrate per step when overlapping other Pawns, kept intentionally small so local correction doesn't fight the server-authoritative position.
public	property	UCharacterMovementComponent::MaxFlySpeed	Maximum ground speed while the character is in Flying movement mode.
public	property	UCharacterMovementComponent::MaxJumpApexAttemptsPerSimulation	Maximum number of attempts, per simulation tick, to precisely resolve the jump apex when falling movement reaches the top of its arc.
public	property	UCharacterMovementComponent::MaxOutOfWaterStepHeight	Maximum height of a ledge, in centimetres, that a swimming character can climb onto when exiting water.
public	property	UCharacterMovementComponent::MaxSimulationIterations	Maximum number of discrete substeps used per movement simulation tick, for modes like falling and walking that break large time deltas into smaller pieces.
public	property	UCharacterMovementComponent::MaxSimulationTimeStep	Maximum time delta allowed for a single discrete simulation step in movement modes that break up large frame times, such as falling and walking.
public	property	UCharacterMovementComponent::MaxStepHeight	Maximum height, in centimetres, of a ledge or step the character can walk up automatically without jumping.
public	property	UCharacterMovementComponent::MaxSwimSpeed	The maximum speed the character can reach while swimming, in centimetres per second.
public	property	UCharacterMovementComponent::MaxTouchForce	Upper bound on the force applied to physics objects the character touches, computed from TouchForceFactor.
public	property	UCharacterMovementComponent::MaxWalkSpeed	The maximum ground speed in cm/s when walking.
public	property	UCharacterMovementComponent::MaxWalkSpeedCrouched	Maximum ground speed while the character is crouched, capping movement speed independently of MaxWalkSpeed.
public	property	UCharacterMovementComponent::MinAnalogWalkSpeed	The ground speed the character accelerates toward when analog input, such as a gamepad stick, is at minimum non-zero tilt, preventing overly slow walking from small stick deflections.
public	property	UCharacterMovementComponent::MinTouchForce	Lower bound on the force applied to physics objects the character touches, computed from TouchForceFactor.
public	property	UCharacterMovementComponent::MovementMode	The character's current movement mode — walking, falling, flying, swimming, or a custom mode.
public	property	UCharacterMovementComponent::NavMeshProjectionHeightScaleDown	Scale of the capsule's total height used for the downward trace distance when projecting a NavWalking character from the nav mesh down onto the underlying geometry.
public	property	UCharacterMovementComponent::NavMeshProjectionHeightScaleUp	Scale of the capsule's total height used to start the upward trace when projecting a NavWalking character from the nav mesh down onto the underlying geometry.
public	property	UCharacterMovementComponent::NavMeshProjectionInterpSpeed	Speed at which the visual capsule offset interpolates toward the newly traced nav mesh projection between raycasts.
public	property	UCharacterMovementComponent::NavMeshProjectionInterval	Sets how often, in seconds, NavWalking characters raycast from the nav mesh down to the underlying geometry to keep their visual position matched to the floor.
public	property	UCharacterMovementComponent::NavMeshProjectionTimer	Internal countdown timer that tracks when the next NavMesh-to-geometry projection raycast should fire while NavWalking.
public	property	UCharacterMovementComponent::NavWalkingFloorDistTolerance	Amount of allowed disagreement, in centimetres, between the server's and client's idea of ground height while a character is in NavWalking mode before a correction is applied.
public	property	UCharacterMovementComponent::NetProxyShrinkHalfHeight	Shrinks a simulated proxy's collision capsule half-height by this amount, compensating for network rounding error that could otherwise cause the proxy to visibly encroach into geometry.
public	property	UCharacterMovementComponent::NetProxyShrinkRadius	Shrinks a simulated proxy's collision capsule radius by this amount, compensating for network rounding error that could otherwise cause the proxy to visibly encroach into geometry.
public	property	UCharacterMovementComponent::NetworkLargeClientCorrectionDistance	Position error threshold beyond which the server treats a client's drift as a large correction, triggering the tighter NetworkMinTimeBetweenClientAdjustmentsLargeCorrection throttle instead of the normal one.
public	property	UCharacterMovementComponent::NetworkMaxSmoothUpdateDistance	Maximum distance a character is allowed to lag behind its true server location while smoothly interpolating toward network position updates.
public	property	UCharacterMovementComponent::NetworkMinTimeBetweenClientAckGoodMoves	Minimum time in seconds the server waits between acknowledging good (unmodified) client moves, used to reduce the bandwidth spent on move acks.
public	property	UCharacterMovementComponent::NetworkMinTimeBetweenClientAdjustments	Minimum time in seconds the server waits between sending correction adjustments to a client whose position has drifted beyond the allowed error, used to save bandwidth.
public	property	UCharacterMovementComponent::NetworkMinTimeBetweenClientAdjustmentsLargeCorrection	Minimum time in seconds between sending client corrections when the position error exceeds NetworkLargeClientCorrectionDistance, letting large errors be corrected more frequently than small ones.
public	property	UCharacterMovementComponent::NetworkNoSmoothUpdateDistance	Distance beyond which a character is teleported directly to its corrected server location instead of continuing to smoothly interpolate toward it.
public	property	UCharacterMovementComponent::NetworkSimulatedSmoothLocationTime	Time in seconds to smoothly interpolate a simulated proxy's position from its old client-side location to the corrected position sent by the server.
public	property	UCharacterMovementComponent::NetworkSimulatedSmoothRotationTime	Time in seconds to smoothly interpolate a simulated proxy's rotation from its old client-side orientation to the corrected orientation sent by the server.
public	property	UCharacterMovementComponent::NetworkSmoothingMode	Controls how simulated proxies interpolate between server-corrected positions on the network — Disabled, Linear, or Exponential.
public	property	UCharacterMovementComponent::OldBaseLocation	Stores the world-space location of the object the character was standing on as of the last base update, so UpdateBasedMovement() can detect whether the base moved this frame.
protected	property	UCharacterMovementComponent::OldBaseQuat	Cached rotation of the movement base from the previous frame, used by UpdateBasedMovement() to detect whether the base moved or rotated since the last update.
public	property	UCharacterMovementComponent::OutofWaterZ	Upward velocity, in centimetres per second, applied to the character when it climbs out of water onto solid ground.
public	property	UCharacterMovementComponent::PendingLaunchVelocity	Temporarily holds the velocity requested by LaunchCharacter() until it's applied at the end of the current movement update.
public	property	UCharacterMovementComponent::PerchAdditionalHeight	Extra distance added to MaxStepHeight when determining how high above a walkable floor the character can perch, letting it hang slightly further off an edge.
public	property	UCharacterMovementComponent::PerchRadiusThreshold	Minimum distance a walkable surface's edge must be from the capsule's contact point for the character to be allowed to perch there rather than fall off.
public	property	UCharacterMovementComponent::PostPhysicsTickFunction	The tick function object that drives PostPhysicsTickComponent, run after the physics scene has finished simulating for the frame.
public	property	UCharacterMovementComponent::PushForceFactor	Force continuously applied to a physics object while this character remains blocked against it.
public	property	UCharacterMovementComponent::PushForcePointZOffsetFactor	Vertical offset, as a fraction of the target object's height, for where push forces are applied.
public	property	UCharacterMovementComponent::RepulsionForce	Force per kilogram of mass applied continuously to every physics component currently overlapping the character, pushing them apart.
public	property	UCharacterMovementComponent::RequestedVelocity	Velocity requested by path following (e.
public	property	UCharacterMovementComponent::RotationRate	Change in rotation per second applied when bUseControllerDesiredRotation or bOrientRotationToMovement is enabled.
public	property	UCharacterMovementComponent::ServerCorrectionRootMotion	Holds the root motion source group received from the server that is used to correct the client's CurrentRootMotion during a network correction.
public	property	UCharacterMovementComponent::StandingDownwardForceScale	Multiplier applied to the downward force this character exerts on physics objects it stands on, derived from the character's Mass and gravity.
public	property	UCharacterMovementComponent::StayBasedInAirHeight	How high above the movement base a character can rise while jumping before it's no longer considered based, when bStayBasedInAir is true.
public	property	UCharacterMovementComponent::TouchForceFactor	Force applied to any physics object the character touches while moving, scaled by the character's current speed.
public	property	UCharacterMovementComponent::bBaseOnAttachmentRoot	When enabled, a character based on an object stays based on that object's attachment root component instead of the specific component it was traced against.
public	property	UCharacterMovementComponent::bBasedMovementIgnorePhysicsBase	When enabled, UpdateBasedMovement ignores collision with actors that are part of the character's current MovementBase, if that base is simulated by physics.
public	property	UCharacterMovementComponent::bStayBasedInAir	When true, keeps the character considered based on the object it was standing on while jumping, instead of immediately becoming unbased.

Version History

Introduced in: 4.0

Version	Status	Notes
5.6	stable	—

Feedback

Was this helpful?