Lua:createTimer
Jump to navigation
Jump to search
Creates a Timer object.
This function has two calling modes. The first mode creates a persistent timer that keeps running until it is disabled or destroyed. The second mode creates a one-shot timer that executes a callback once and then destroys itself.
Contents
Function Parameters
Persistent Timer
| Parameter | Type | Description |
|---|---|---|
| owner | Component or nil (optional) | The owner of the timer. When the owner is destroyed, the timer is destroyed too. Pass nil or omit this parameter for a standalone timer. |
| enabled | Boolean (optional) | If true, the timer starts enabled. If false, the timer is created disabled. |
One-Shot Timer
| Parameter | Type | Description |
|---|---|---|
| interval | Integer | The delay in milliseconds before the callback is executed. |
| callback | Function | The function to execute when the timer fires. |
| ... | Any (optional) | Additional arguments that are passed to the callback function. |
Returns
Timer — The created Timer object.
Calling Modes
| Mode | Syntax | Description |
|---|---|---|
| Persistent Timer | createTimer(owner, enabled) | Creates a timer that fires repeatedly until it is disabled or destroyed. |
| One-Shot Timer | createTimer(interval, callback, ...) | Creates a timer that fires once, executes the callback, and then destroys itself. |
Persistent Timer Example
1 local timer = createTimer(nil, false)
2
3 timer.Interval = 1000
4 timer.OnTimer = function(sender)
5 print("Tick: " .. os.date("%H:%M:%S"))
6 end
7
8 timer.Enabled = true
Timer With Owner Example
1 local form = createForm()
2 form.Caption = "Timer Example"
3
4 local timer = createTimer(form)
5 timer.Interval = 500
6 timer.OnTimer = function(sender)
7 form.Caption = "Time: " .. os.date("%H:%M:%S")
8 end
9
10 form.show()
Stopping A Persistent Timer
1 local timer = createTimer()
2 timer.Interval = 1000
3
4 local count = 0
5
6 timer.OnTimer = function(sender)
7 count = count + 1
8 print("Count: " .. count)
9
10 if count >= 10 then
11 sender.Enabled = false
12 sender.destroy()
13 end
14 end
One-Shot Timer Example
1 createTimer(2000, function()
2 print("Executed after 2 seconds")
3 end)
One-Shot Timer With Parameters
1 local name = "Player"
2 local health = 100
3
4 createTimer(1500, function(playerName, hp)
5 print(playerName .. " health: " .. hp)
6 end, name, health)
Delayed Form Update Example
1 local form = createForm()
2 form.Caption = "Loading..."
3 form.show()
4
5 createTimer(2000, function()
6 form.Caption = "Ready!"
7 end)
Notes
- The interval is specified in milliseconds.
- A value of 1000 means one second.
- Persistent timers keep firing until disabled or destroyed.
- One-shot timers destroy themselves after the callback has executed.
- Do not manually destroy a one-shot timer after it has fired.
- Use an owner such as a form or getMainForm() when the timer should be cleaned up automatically.
- Timer callbacks execute in Cheat Engine's main thread.
- Timer accuracy depends on system load and the operating system timer resolution.
Common Mistakes
Destroying One-Shot Timers
One-shot timers destroy themselves automatically after firing. Usually, you should create them and let them run.
1 createTimer(1000, function()
2 print("This one-shot timer destroys itself")
3 end)
Forgetting To Destroy Persistent Timers
Persistent timers should either have an owner or be destroyed manually when no longer needed.
1 local timer = createTimer(getMainForm())
2
3 timer.Interval = 1000
4 timer.OnTimer = function(sender)
5 print("This timer is owned by the main form")
6 end
