ACharacter::ClientAdjustPosition
Deprecated: Use ClientMoveResponsePacked() instead.
#include "GameFramework/Character.h"
Access: public
Specifiers: UFUNCTIONdeprecated
Description
Deprecated client RPC sent by the server to correct the client's position and velocity after detecting client-side prediction error. Replaced by ClientMoveResponsePacked() since UE 4.26.
Caveats & Gotchas
- • Deprecated since 4.26. Position corrections are now delivered via ClientMoveResponsePacked, which is more bandwidth-efficient and supports variable payloads.
- • When this correction fires, the client will snap to the corrected position and replay all saved moves that occurred after the corrected timestamp — this can cause a visible position pop if the error is large. Tuning UCharacterMovementComponent::MaxClientSmoothingDeltaTime can soften the visual impact.
Signature
void ClientAdjustPosition(float TimeStamp, FVector NewLoc, FVector NewVel, UPrimitiveComponent* NewBase, FName NewBaseBoneName, bool bHasBase, bool bBaseRelativePosition, uint8 ServerMovementMode) Parameters
| Name | Type | Description | Default |
|---|---|---|---|
| TimeStamp | float | Timestamp of the ServerMove this correction corresponds to. | — |
| NewLoc | FVector | Corrected world location from the server. | — |
| NewVel | FVector | Corrected velocity from the server. | — |
| NewBase | UPrimitiveComponent* | Movement base component the server has the character on. | — |
| NewBaseBoneName | FName | Bone name on the base component. | — |
| bHasBase | bool | Whether the character has a movement base. | — |
| bBaseRelativePosition | bool | Whether NewLoc is relative to the base. | — |
| ServerMovementMode | uint8 | Movement mode on the server. | — |
Return Type
void Example
Understanding when corrections occur C++
// You do not call this RPC directly. The server sends it automatically when
// the client's predicted position deviates from the server position by more than
// KINDA_SMALL_NUMBER. To reduce correction frequency, keep server/client
// movement logic identical and minimise physics interactions that diverge. See Also
Version History
Introduced in: 4.0
| Version | Status | Notes |
|---|---|---|
| 5.6 | deprecated | — |
| 4.26 | deprecated | Replaced by ClientMoveResponsePacked. |
Feedback
Was this helpful?