3 min read
QBCore server events
This reference is pinned to the current
server/events.lua and
server/player.lua.
Conceptual diagram; verify the behavior against your installed resource version.
Network handlers registered in server/events.lua
| Event | Arguments | Current server behavior |
|---|---|---|
QBCore:Server:CloseServer | reason | Requires admin; closes joins and kicks players lacking the whitelist permission |
QBCore:Server:OpenServer | none | Requires admin; reopens the server |
QBCore:Server:TriggerClientCallback | name, ... | Resolves a pending server→client callback |
QBCore:Server:TriggerCallback | name, ... | Invokes a callback registered with CreateCallback |
QBCore:UpdatePlayer | none | Applies hunger/thirst decay, synchronizes metadata, and saves; rate-limited per source |
QBCore:ToggleDuty | none | Toggles the caller's current job duty state |
QBCore:Server:OnPlayerLoaded | none | Confirms the source is loaded, then emits the client loaded event |
QBCore:CallCommand | command, args | Resolves the registered command and checks its command.<name> ACE before invoking it |
QBCore:Server:TriggerCallback is a transport mechanism, not automatic authorization. Every
callback that returns sensitive data or changes state must validate the calling source and
client-supplied arguments.
The same file also handles playerConnecting, playerDropped, resource cleanup, and
baseevents:* vehicle events through normal FiveM event handlers.
Integration events
| Event | Arguments | Meaning |
|---|---|---|
QBCore:Server:PlayerLoaded | player | A server-side player object finished loading. |
QBCore:Server:OnPlayerUnload | source | A player session was unloaded. |
QBCore:Server:PlayerDropped | source | A network player dropped. |
QBCore:Server:OnPlayerUpdated | source, key, value | One field or the full player data changed. |
QBCore:Server:OnJobUpdate | source, job | Job data changed. |
QBCore:Server:OnGangUpdate | source, gang | Gang data changed. |
QBCore:Server:SetDuty | source, onDuty | Duty state changed. |
QBCore:Server:OnMoneyChange | source, moneyType, amount, operation, reason | Money was added, removed, or set. |
QBCore:Server:UpdateObject | none | Shared jobs, items, or gangs changed. |
AddEventHandler('QBCore:Server:OnPlayerUnload', function(playerSource)
activeRoutes[playerSource] = nil
end)
AddEventHandler('QBCore:Server:OnPlayerUpdated', function(playerSource, key, value)
if key == 'job' then
refreshJobAccess(playerSource, value)
end
end)There is no current core QBCore:Server:PlayerLoggedOut or
QBCore:Server:SetPlayerData event. QBCore:Server:UpdateObject has no payload; reacquire the
exported core object if a resource caches shared tables.
Never expose a server event that grants money, items, jobs, or permissions without checking the
calling source and validating every client-supplied value.
Found an issue in this guide?
Send the page URL, the affected example, and a source or reproduction to the site maintainer. For a server or resource problem, use the support guide.
