UAnimInstance::GetMutableInstanceAssetPlayers

function Engine Since 4.11

#include "Animation/AnimInstance.h"

Access: public Specifiers: ENGINE_API

Description

Returns a mutable reference to the array of all active asset player tick records. Allows custom animation systems to modify tick records before they are processed by the animation evaluation pipeline.

Caveats & Gotchas

• Modifying tick records at the wrong point in the update pipeline (e.g., after evaluation has started) can cause desynchronized poses or crashes. Only safe to call during the pre-update or native update phases.
• Like GetInstanceAssetPlayers, the array is rebuilt each frame. Any modifications are transient and must be reapplied every tick.

Signature

ENGINE_API TArray<FAnimTickRecord>& GetMutableInstanceAssetPlayers();

Return Type

TArray<FAnimTickRecord>&

Example

Override blend weight of all asset players C++

TArray<FAnimTickRecord>& Players = AnimInstance->GetMutableInstanceAssetPlayers();
for (FAnimTickRecord& Record : Players)
{
    Record.EffectiveBlendWeight *= BlendWeightMultiplier;
}

Version History

Introduced in: 4.11

Version	Status	Notes
5.6	stable	—

Feedback

Was this helpful?