Getting started

Example

local g = ui.Group("my script")
local enabled = g.Checkbox("enabled", false)

events.On("createmove", function(cmd)
    if enabled:Get() then
        cmd.forwardmove = 1
    end
end)

Reload

Saving the file reloads an enabled script, as long as the Scripts tab is open. Widget values survive the reload (matched by tab/group/label; renamed widgets reset).

Libraries

Shared .lua files go in scripts\lib\. require("name") loads scripts\lib\name.lua and returns whatever it returns.

-- scripts/lib/hooking.lua
local M = {}
function M.jmp(addr, fn) --[[ ... ]] end
return M

-- scripts/my_script.lua
local hooking = require("hooking")

Names may contain only letters, digits, _, and -. Results are cached during each refresh pass. Editing a module takes effect when a dependent script reloads. Module globals stay in the module’s environment. Cyclic imports error.

Output

print writes to the game console. Errors appear there in red.

Standard library

Available: base, table, string, math, bit, jit. Stripped: io, os, debug, package (require is provided, see above), bytecode loading, and the filesystem loaders loadfile / dofile. load and loadstring still work. For saving state and settings use file. The JIT compiler is off. Scripts run interpreted.

FFI

ffi is a global; no require needed. See the LuaJIT FFI docs for API and semantics.

local pFlashAlpha = ffi.cast("float*", pawn.address + cheat.SchemaOffset("C_CSPlayerPawnBase->m_flFlashMaxAlpha"))

ffi.load is disabled. Prefer entity.* for schema fields.

API reference

Directory

Example

Reload

Libraries

Output

Standard library

FFI

​Directory

​Example

​Reload

​Libraries

​Output

​Standard library

​FFI

Directory

Example

Reload

Libraries

Output

Standard library

FFI