UAnimInstance::BlueprintThreadSafeUpdateAnimation

function Engine Blueprint Since 5.0

#include "Animation/AnimInstance.h"

Access: public Specifiers: virtualUFUNCTIONBlueprintImplementableEventmeta=(BlueprintThreadSafe)

Description

Thread-safe Blueprint event for updating animation variables during parallel evaluation. Use this instead of BlueprintUpdateAnimation for performance-critical variable updates that do not require game-thread-only data, allowing the work to run in parallel with other game thread tasks.

Caveats & Gotchas

• Only thread-safe Blueprint nodes can be called from this event — accessing UObjects, spawning actors, or calling non-thread-safe functions will cause crashes or undefined behavior. Use Property Access nodes and thread-safe getters only.
• This event runs during the worker thread animation evaluation phase, not on the game thread. Any data read here must have been copied to thread-safe storage beforehand, typically via NativeUpdateAnimation or BlueprintUpdateAnimation.

Signature

virtual void BlueprintThreadSafeUpdateAnimation(float DeltaTime)

Parameters

Name	Type	Description	Default
DeltaTime	float	Time in seconds since the last animation update.	—

Return Type

void

Example

Thread-safe locomotion update C++

// In Animation Blueprint:
// 1. Override BlueprintThreadSafeUpdateAnimation
// 2. Use Property Access to read cached velocity/direction
// 3. Compute blend weights without touching game objects

// C++ equivalent using NativeThreadSafeUpdateAnimation:
void UMyAnimInstance::NativeThreadSafeUpdateAnimation(float DeltaSeconds)
{
    Super::NativeThreadSafeUpdateAnimation(DeltaSeconds);
    // Only access thread-safe cached data here
    Speed = CachedVelocity.Size();
    bShouldMove = Speed > 3.0f;
}

Version History

Introduced in: 5.0

Version	Status	Notes
5.6	stable	—

Feedback

Was this helpful?