QBCore Frameworkqbcore.netCommunity docs
On this page

4 min read

QBCore client events

This list is verified against client/events.lua and server/player.lua. QBCore resources can add their own events; an event from qb-inventory or another resource is not a core event.

Client event and trusted server state boundaries

Conceptual diagram; verify the behavior against your installed resource version.

Handlers registered in client/events.lua

These are the current net-event handlers in the core file itself. "Internal" means the event is a framework transport/command path; it can still be observed, but new resources should prefer the public function or lifecycle surface.

EventHandler argumentsRole
QBCore:Client:OnPlayerLoadednoneLifecycle
QBCore:Client:OnPlayerUnloadnoneLifecycle
QBCore:Client:PvpHasToggledpvp_stateCore state update
QBCore:Command:TeleportToPlayercoordsInternal command transport
QBCore:Command:TeleportToCoordsx, y, z, hInternal command transport
QBCore:Command:GoToMarkernoneInternal command transport
QBCore:Command:SpawnVehiclevehNameInternal command transport
QBCore:Command:DeleteVehiclenoneInternal command transport
QBCore:Client:VehicleInfoinfoVehicle/baseevents bridge
QBCore:Client:OnPlayerUpdatedkey, valPlayer-data synchronization
QBCore:Notifytext, type, length, iconNotification transport
QBCore:Client:TriggerClientCallbackname, ...Callback transport
QBCore:Client:TriggerCallbackname, ...Callback transport
QBCore:Command:ShowMe3DsenderId, msg/me display transport
QBCore:Client:OnSharedUpdatetableName, key, valueShared-data synchronization
QBCore:Client:OnSharedUpdateMultipletableName, valuesShared-data synchronization
QBCore:Client:SharedUpdatetableFull shared-data synchronization

The command-prefixed client events are destinations for already-authorized server command flows. Triggering a client event locally is never a server-side permission grant.

Events intended for resource integrations

EventArgumentsMeaning
QBCore:Client:OnPlayerLoadednoneLocal player data finished loading.
QBCore:Client:OnPlayerUnloadnoneClear resource-local player state.
QBCore:Player:SetPlayerDataplayerDataFull player data changed.
QBCore:Client:OnJobUpdatejobJob data changed.
QBCore:Client:OnGangUpdategangGang data changed.
QBCore:Client:SetDutyonDutyDuty state changed.
QBCore:Client:OnMoneyChangemoneyType, amount, operation, reasonMoney was added, removed, or set.
QBCore:Client:EnteredVehicledataCore vehicle state changed to entered.
QBCore:Client:LeftVehicledataCore vehicle state changed to left.
QBCore:Client:UpdateObjectnoneRefresh the exported core object after shared-data changes.
local QBCore = exports['qb-core']:GetCoreObject()

RegisterNetEvent('QBCore:Client:OnJobUpdate', function(job)
    local isPolice = job.name == 'police'
    -- Update only this resource's local state here.
end)

RegisterNetEvent('QBCore:Client:UpdateObject', function()
    QBCore = exports['qb-core']:GetCoreObject()
end)

Internal transport events

QBCore:Client:OnPlayerUpdated, QBCore:Client:VehicleInfo, shared-data update events, and callback transport events are framework internals. Prefer the integration events or public callback functions instead of triggering internal events yourself.

There is no current core QBCore:Client:OnUseItem or QBCore:Client:ItemBox event. Item-box UI is owned by the inventory resource used by the server.

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.

On this page

Leonida RP server website built with RPWebsite
RPWebsite

Advertisement · RPWebsite

Want a website for your server?

Launch a site with live player status, rules, and a join button in minutes.

Build your website