# QBCore server events

This reference is pinned to the current
[`server/events.lua`](https://github.com/qbcore-fivem/qb-core/blob/9b3cddcce93e5e12cbcf6b47b866b687d32ac7bf/server/events.lua) and
[`server/player.lua`](https://github.com/qbcore-fivem/qb-core/blob/9b3cddcce93e5e12cbcf6b47b866b687d32ac7bf/server/player.lua).

![Server event validation and state changes](/diagrams/authority.svg)

*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. |

```lua
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.
