Callbacks

koja-lib provides a callback system that lets client scripts request data from the server and vice versa.

TriggerServerCallback

Trigger a callback registered on the server and receive the result asynchronously.

KOJA.Client.TriggerServerCallback(key, payload, callback)

Parameter	Type	Description
key	string	Callback identifier
payload	any	Data sent to the server
callback	function	Called with the server's response

Example

KOJA.Client.TriggerServerCallback('myScript:getPlayerData', nil, function(data)
    print('Player name:', data.name)
    print('Money:', data.money)
end)

RegisterClientCallback

Register a callback on the client that the server can trigger.

KOJA.Client.RegisterClientCallback(key, handler)

Parameter	Type	Description
key	string	Callback identifier
handler	function(payload, cb)	Handler function — call cb(result) to respond

Example

KOJA.Client.RegisterClientCallback('myScript:getLocalPos', function(payload, cb)
    local coords = GetEntityCoords(PlayerPedId())
    cb({ x = coords.x, y = coords.y, z = coords.z })
end)

Registering a Server Callback

On the server side you register the handler:

KOJA.Server.RegisterServerCallback('myScript:getPlayerData', function(source, payload, cb)
    local name = KOJA.Server.GetPlayerName(source)
    local money = KOJA.Server.getMoney(source, 'cash')
    cb({ name = name, money = money })
end)

See Server Callbacks for full server-side documentation.