FTimerManager

class Engine Since 4.0

#include "TimerManager.h"

Description

Manages all gameplay timers for a UWorld instance. Provides an API to schedule, cancel, pause, and inspect timed callbacks identified by FTimerHandle. Not UObject-derived; always access via UWorld::GetTimerManager().

Caveats & Gotchas

• Never store a raw pointer to FTimerManager — always access it through GetWorld()->GetTimerManager() or the AActor/UActorComponent helper GetWorldTimerManager().
• Timer callbacks bound to UObjects are automatically invalidated if the bound object is garbage collected — the timer will silently never fire.
• FTimerManager is not thread-safe. All calls must be made from the game thread.
• Timers pause automatically when the game is paused (TimeDilation == 0). Set bIgnorePause via FTimerManagerTimerParameters to keep a timer running during pause.

Example

Set and cancel a one-shot timer C++

// Header:
FTimerHandle MyTimer;

// BeginPlay:
GetWorldTimerManager().SetTimer(
	MyTimer, this, &AMyActor::OnExpire, 5.0f
);

// Cancel before it fires:
GetWorldTimerManager().ClearTimer(MyTimer);

Functions (5)

Lifecycle 1 Utility 4

Lifecycle

1 ▼

Access	Type	Name	Description
public	function	FTimerManager::SetTimerForNextTick	Schedules a callback to fire exactly once at the start of the next frame's timer tick.

Utility

4 ▼

Access	Type	Name	Description
public	function	FTimerManager::ClearTimer	Stops and removes the timer identified by InHandle and invalidates the handle so it can no longer be used to query or cancel that timer.
public	function	FTimerManager::GetTimerRemaining	Returns the time in seconds until the timer's next fire.
public	function	FTimerManager::IsTimerActive	Returns true if the timer referred to by InHandle is currently running and not paused.
public	function	FTimerManager::SetTimer	Schedules a member function to fire after InRate seconds.

Version History

Introduced in: 4.0

Version	Status	Notes
5.6	stable	—

Feedback

Was this helpful?