Čeština
Runtime a události
Scheduler
Client / Server.
| Funkce | Vrací | Účel |
|---|---|---|
CreateThread(callback) | task ID | Spustí managed coroutine. Alias: Citizen.CreateThread. |
Wait(milliseconds) | none | Uspí aktuální managed coroutine. Alias: Citizen.Wait. |
SetTimeout(milliseconds, callback) | task ID | Spustí jednou po zadaném zpoždění. |
ClearTimeout(taskId) | boolean | Zruší naplánovanou úlohu. |
SetInterval(milliseconds, callback) | task ID | Spouští opakovaně. |
ClearInterval(taskId) | boolean | Zruší interval. |
Schedule(expression, callback) | task ID | Spouští cron výraz s pěti nebo šesti poli. |
lua
CreateThread(function()
while true do
Wait(1000)
print('tick')
end
end)
Schedule('0 */5 * * * *', function()
print('every five minutes')
end)Vyhněte se neomezeným smyčkám s Wait(0). Runtime na resource vynucuje limity pro fronty, callbacky, wakeupy i CPU budgety.
Události
| Funkce | Strana | Účel |
|---|---|---|
AddEventHandler(name, callback) | Client / Server | Obslouží lokální event. |
RegisterNetEvent(name, callback) | Client / Server | Obslouží lokální i síťové volání. |
TriggerEvent(name, ...) | Client / Server | Vyvolá event v aktuálním procesu. |
TriggerServerEvent(name, ...) | Client | Pošle JSON serializované argumenty na server. |
TriggerClientEvent(name, peerId, ...) | Server | Pošle argumenty jednomu klientovi. |
Vlastní názvy eventů nerozlišují velikost písmen. Síťové handlery dostávají odesílatele v globální source.
Příkazy a oprávnění
lua
RegisterCommand(commandName, callback, restricted)
Command.Execute(rawCommand, sourcePeer)
HasPermission(permission)
Player.HasPermission(peerId, permission)
IsPlayerAceAllowed(source, ace)
IsPlayerAdmin()restricted může být false, true pro command.<name> nebo explicitní ACE string. Logika citlivá na oprávnění patří na server.
Exports
lua
exports('getState', function()
return { active = true }
end)
local state = exports['other_resource'].getState()Exports jsou synchronní a zůstávají na aktuální straně. Chybějící nebo selhávající export vrátí nil a zapíše chybu do logu.
Workflow nody
Server.
lua
Workflow.RegisterNode(definition)
Workflow.UnregisterNode(localId)
Workflow.GetNodes()Resources mohou rozšířit WebAdmin Visual Flow Builder registrací vlastních node definic za běhu. Definice node musí obsahovat alespoň id a title; volitelná pole jsou category, kind, description, handler, template a subtitle.
Workflow.GetNodes() vrací vestavěný katalog plus aktuálně registrované nody dané resource včetně kvalifikovaného resource-scoped ID, které používá Webflow.
Convars
lua
GetConvar(key, defaultValue)
GetConvarInt(key, defaultValue)
GetConvarFloat(key, defaultValue)
GetConvarBool(key, defaultValue)
SetConvar(key, value)
SetReplicatedConvar(key, value)Varianty lokální pro resource používají prefixy GetResourceConvar* a SetResourceConvar*. Autoritativní jsou jen serverové hodnoty; setr hodnoty se replikují ke klientům, zatímco sets zůstávají secret jen pro engine.