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 (20)

Lifecycle 2 Utility 9 Timer Management 3 Timer Query 6

Lifecycle

2 ▼

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.
public	function	FTimerManager::Tick	Advances all active timers by the given delta time, firing any whose expiry has been reached.

Utility

9 ▼

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::ListTimers	Dumps a human-readable list of all currently registered timers — including their rate, remaining time, and delegate info — to the output log.
public	function	FTimerManager::SetTimer	Schedules a member function to fire after InRate seconds.
public	function	FTimerManager::GenerateHandle	Creates a valid FTimerHandle for the timer at the given internal sparse-array index, encoding the index and a serial number into the handle.
public	function	FTimerManager::GetStatId	Returns the stat ID used to identify this timer manager in the Unreal Insights / stats profiler.
public	function	FTimerManager::HasBeenTickedThisFrame	Returns true if this timer manager has already been ticked during the current frame.
public	function	FTimerManager::OnCrash	Called by the crash handler to dump diagnostic information about the current state of all timers to the log.

Timer Management

3 ▼

Access	Type	Name	Description
public	function	FTimerManager::ClearAllTimersForObject	Cancels every timer whose delegate is bound to the specified object.
public	function	FTimerManager::PauseTimer	Temporarily suspends a timer so it stops counting down.
public	function	FTimerManager::UnPauseTimer	Resumes a previously paused timer, restoring the remaining countdown from when it was paused.

Timer Query

6 ▼

Access	Type	Name	Description
public	function	FTimerManager::TimerExists	Returns true if a timer with the given handle exists in the active, paused, or pending list.
public	function	FTimerManager::GetTimerElapsed	Returns the time in seconds that has elapsed since the timer last fired (or since it was set, for a timer that has not yet fired).
public	function	FTimerManager::GetTimerRate	Returns the configured repeat interval (in seconds) of the specified timer.
public	function	FTimerManager::IsTimerPaused	Returns true if the specified timer exists and is currently in the paused state.
public	function	FTimerManager::IsTimerPending	Returns true if the timer exists and is in the pending state, meaning it was set during the current tick and will be activated on the next Tick call.
public	function	FTimerManager::K2_FindDynamicTimerHandle	Searches the timer manager for a timer bound to the given dynamic delegate and returns its handle.

Version History

Introduced in: 4.0

Version	Status	Notes
5.6	stable	—

Feedback

Was this helpful?