/Godot 3.1


Inherits: Node < Object

Category: Core

Brief Description

A countdown timer.


bool autostart
bool one_shot
bool paused
TimerProcessMode process_mode
float time_left
float wait_time


bool is_stopped ( ) const
void start ( float time_sec=-1 )
void stop ( )


timeout ( )

Emitted when the timer reaches 0.


enum TimerProcessMode:

  • TIMER_PROCESS_PHYSICS = 0 — Update the timer during the physics step at each frame (fixed framerate processing).
  • TIMER_PROCESS_IDLE = 1 — Update the timer during the idle time at each frame.


Counts down a specified interval and emits a signal on reaching 0. Can be set to repeat or “one shot” mode.

Property Descriptions

bool autostart

Setter set_autostart(value)
Getter has_autostart()

If true, the timer will automatically start when entering the scene tree. Default value: false.

bool one_shot

Setter set_one_shot(value)
Getter is_one_shot()

If true, the timer will stop when reaching 0. If false, it will restart. Default value: false.

bool paused

Setter set_paused(value)
Getter is_paused()

If true, the timer is paused and will not process until it is unpaused again, even if start is called.

TimerProcessMode process_mode

Setter set_timer_process_mode(value)
Getter get_timer_process_mode()

Processing mode. See TimerProcessMode.

float time_left

Getter get_time_left()

The timer’s remaining time in seconds. Returns 0 if the timer is inactive.

Note: You cannot set this value. To change the timer’s remaining time, use wait_time.

float wait_time

Setter set_wait_time(value)
Getter get_wait_time()

Wait time in seconds.

Method Descriptions

bool is_stopped ( ) const

Returns true if the timer is stopped.

void start ( float time_sec=-1 )

Starts the timer. Sets wait_time to time_sec if time_sec > 0. This also resets the remaining time to wait_time.

Note: this method will not resume a paused timer. See paused.

void stop ( )

Stops the timer.

© 2014–2019 Juan Linietsky, Ariel Manzur, Godot Engine contributors
Licensed under the MIT License.