timers

Type Sets1

Symbol	Description
Timer	Any of the following prototypes will work for a timed function.

Defines5

Symbol	Description
TIMER_DATA_HNDL_CLOSE	Timer will automatically call CloseHandle() on its data when finished
TIMER_FLAG_NO_MAPCHANGE	Timer will not carry over mapchanges
TIMER_FLAG_TICK_PRECISE	Timer will have tick level time precision
TIMER_HNDL_CLOSE	Deprecated define, replaced by below
TIMER_REPEAT	Timer will repeat until it returns Plugin_Stop

Forwards1

Symbol	Description
OnMapTimeLeftChanged	Notification that the map's time left has changed via a change in the time limit or a change in the game rules (such as mp_restartgame). This is useful for plugins trying to create timers based on the time left in the map. Calling ExtendMapTimeLimit() from here, without proper precaution, will cause infinite recursion. If the operation is not supported, this will never be called. If the server has not yet processed any frames (i.e. no players have joined the map yet), then this will be called once the server begins ticking, even if there is no time limit set.

Symbol

Description

OnMapTimeLeftChanged

Notification that the map's time left has changed via a change in the time limit or a change in the game rules (such as mp_restartgame). This is useful for plugins trying to create timers based on the time left in the map. Calling ExtendMapTimeLimit() from here, without proper precaution, will cause infinite recursion. If the operation is not supported, this will never be called. If the server has not yet processed any frames (i.e. no players have joined the map yet), then this will be called once the server begins ticking, even if there is no time limit set.

Functions10

Symbol	Description
CreateDataTimer	Creates a timer associated with a new datapack, and returns the datapack.
CreateTimer	Creates a basic timer. Calling CloseHandle() on a timer will end the timer.
ExtendMapTimeLimit	Extends the map time limit in a way that will notify all plugins.
GetMapTimeLeft	Returns an estimate of the time left before the map ends. If the server has not processed any frames yet (i.e. no players have joined the map yet), then the time left returned will always be infinite.
GetMapTimeLimit	Retrieves the current map time limit. If the server has not processed any frames yet (i.e. no players have joined the map yet), then the time limit returned will always be 0.
GetTickedTime	Returns the simulated game time. This time is internally maintained by SourceMod and is based on the game tick count and tick rate. Unlike GetGameTime(), it will increment past map changes and while no players are connected. Unlike GetEngineTime(), it will not increment based on the system clock (i.e. it is still bound to the ticking process).
GetTickInterval	Returns the number of seconds in between game server ticks. Note: A tick, in this context, is a frame.
IsServerProcessing	Returns whether or not the server is processing frames or not. The server does not process frames until at least one client joins the game. If server hibernation is disabled, once the first player has joined, even if that player leaves, the server's timers and entities will continue to work.
KillTimer	Kills a timer. Use this instead of CloseHandle() if you need more options.
TriggerTimer	Manually triggers a timer so its function will be called.