RealDocs

ACharacter::GetRepRootMotion_Mutable

function Engine Since 5.0
#include "GameFramework/Character.h"
Access: public

Description

Returns a mutable reference to the replicated root-motion montage struct for in-place modification. Intended for engine-internal replication code that needs to write fields of the struct directly.

Caveats & Gotchas

  • Modifying the returned reference bypasses SetRepRootMotion and will not mark the property dirty for replication — call SetRepRootMotion or trigger a dirty flag manually when you need the change to be sent to clients.
  • This accessor exists for performance-sensitive internal paths; prefer SetRepRootMotion in game code to avoid silent replication bugs.

Signature

ENGINE_API FRepRootMotionMontage& GetRepRootMotion_Mutable()

Return Type

FRepRootMotionMontage&

Example

Clear replicated root motion in a custom replication path C++
// Engine-internal usage pattern — clear root motion state
FRepRootMotionMontage& Mutable = GetRepRootMotion_Mutable();
Mutable.Clear();

Version History

Introduced in: 5.0

Version Status Notes
5.6 stable

Feedback

Was this helpful?

Suggest an edit

Select a field above to begin editing.