Skip to content

Runtime a události ​

Scheduler ​

Client / Server.

FunkceVracíÚčel
CreateThread(callback)task IDSpustí managed coroutine. Alias: Citizen.CreateThread.
Wait(milliseconds)noneUspí aktuální managed coroutine. Alias: Citizen.Wait.
SetTimeout(milliseconds, callback)task IDSpustí jednou po zadaném zpoždění.
ClearTimeout(taskId)booleanZruší naplánovanou úlohu.
SetInterval(milliseconds, callback)task IDSpouští opakovaně.
ClearInterval(taskId)booleanZruší interval.
Schedule(expression, callback)task IDSpouš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 ​

FunkceStranaÚčel
AddEventHandler(name, callback)Client / ServerObslouží lokální event.
RegisterNetEvent(name, callback)Client / ServerObslouží lokální i síťové volání.
TriggerEvent(name, ...)Client / ServerVyvolá event v aktuálním procesu.
TriggerServerEvent(name, ...)ClientPošle JSON serializované argumenty na server.
TriggerClientEvent(name, peerId, ...)ServerPoš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.

Lua resources pro Valheim postavené na server-authoritative runtime.