🖥️Server Function Reference

Learn about and how to use common core server functions!

Player Getters

QBCore.Functions.GetIdentifier

Get a specific identifier of a player

source: number
identifier: string (optional)
return: string

local identifier = QBCore.Functions.GetIdentifier(source, 'license')
print(identifier)

OR -- defaults to the identifier in the config of qb-core

local identifier = QBCore.Functions.GetIdentifier(source)
print(identifier)

QBCore.Functions.GetSource

Get a players source by identifier

identifier: string
return: number

local identifier = QBCore.Functions.GetIdentifier(source, 'license')
local playerSource = QBCore.Functions.GetSource(identifier)
print(playerSource)

QBCore.Functions.GetPlayer

Get a player by their source and access their data

source: number | string
return: table

local Player = QBCore.Functions.GetPlayer(source)
QBCore.Debug(Player)

QBCore.Functions.GetPlayerByCitizenId

Get a player by their citizen id and access their data (must be online)

citizenid: string
return: table

local Player = QBCore.Functions.GetPlayerByCitizenId('ONZ55343')
QBCore.Debug(Player)

QBCore.Functions.GetPlayerByPhone

Get a player by their phone number (must be online)

number: number
return: table

local Player = QBCore.Functions.GetPlayerByPhone(6422738491)
QBCore.Debug(Player)

QBCore.Functions.GetPlayerByAccount

Get a player by their account number (must be online)

account: string
return: table

local Player = QBCore.Functions.GetPlayerByAccount('US08QBCore2345987612')
QBCore.Debug(Player)

QBCore.Functions.GetPlayerByCharInfo

Get a player by their character info (must be online)

property: string
value: any
return: table

local Player = QBCore.Functions.GetPlayerByCharInfo('firstname', 'Kakarot')
QBCore.Debug(Player)

QBCore.Functions.GetPlayers

Get all player IDs in the server (deprecated method)

return: table

local Players = QBCore.Functions.GetPlayers()
QBCore.Debug(Players)

QBCore.Functions.GetQBPlayers

Access the table of all active players on the server (preferred to above)

return: table

local Players = QBCore.Functions.GetQBPlayers()
QBCore.Debug(Players)

QBCore.Functions.GetPlayersOnDuty

Get a table of player id's that are on duty for a specific job and the amount

job: string
return: table , number

local Players, Amount = QBCore.Functions.GetPlayersOnDuty('police')
print(QBCore.Debug(Players))
print('Currently '..amount..' police online')

QBCore.Functions.GetDutyCount

Get the amount of players on duty for a specific job

job: string
return: number

local amount = QBCore.Functions.GetDutyCount('police')
print('Currently '..amount..' police online')

World Getters

QBCore.Functions.GetCoords

Get the coordinates of a passed entity

entity: number
return: vector4

local ped = GetPlayerPed(source)
local coords = QBCore.Functions.GetCoords(ped)
print(coords)

QBCore.Functions.GetClosestObject

Get's the closest object to a player in the world and the distance to it

source: string
coords: vector3 (optional)
return: number |number

local ped = GetPlayerPed(source)
local location = GetEntityCoords(ped)
local objectHandle, distance = QBCore.Functions.GetClosestObject(source, location)
print('Closest Object:', objectHandle, 'Distance:', distance)

QBCore.Functions.GetClosestVehicle

Get's the closest vehicle to a player in the world and the distance to it

source: string
coords: vector3 (optional)
return: number |number

local ped = GetPlayerPed(source)
local location = GetEntityCoords(ped)
local vehicle, distance = QBCore.Functions.GetClosestVehicle(source, location)
print('Closest Vehicle:', vehicle, 'Distance:', distance)

QBCore.Functions.GetClosestPed

Get's the closest ped to a player in the world and the distance to it

source: string
coords: vector3 (optional)
return: number |number

local ped = GetPlayerPed(source)
local coords = GetEntityCoords(ped)
local closestPed, distance = QBCore.Functions.GetClosestPed(source, coords)
print('Closest Ped:', closestPed, 'Distance:', distance)

Vehicle Creation

QBCore.Functions.SpawnVehicle

Spawns a vehicle near a player using the standard client-assisted CreateVehicle RPC. The client must be near the spawn location for the vehicle to appear

source: string
model: string|number
coords: vector3 (optional)
warp: boolean (optional)
return: number

local veh = QBCore.Functions.SpawnVehicle(source, "sultan")
print("Spawned vehicle:", veh)

QBCore.Functions.CreateAutomobile

Spawns a vehicle using the experimental CREATE_AUTOMOBILE native, which does not rely on the client for creation. This is more efficient but does not work for all vehicle types

source: string
model: string|number
coords: vector3 (optional)
warp: boolean (optional)
return: number

local veh = QBCore.Functions.CreateAutomobile(source, "sultan")
print("Created automobile:", veh)

QBCore.Functions.CreateVehicle

Uses the newer CreateVehicleServerSetter native to spawn vehicles on the server. More reliable and supports all major vehicle types

source: string
model: string|number
vehType: string
coords: vector3 (optional)
warp: boolean (optional)
return: number

local veh = QBCore.Functions.CreateVehicle(source, "sultan", "automobile")
print("Created vehicle with server setter:", veh)

Routing Buckets

QBCore.Functions.GetBucketObjects

Returns the internal bucket state tables used by the framework

return: table, table

local playerBuckets, entityBuckets = QBCore.Functions.GetBucketObjects()
QBCore.Debug(playerBuckets)
QBCore.Debug(entityBuckets)

QBCore.Functions.GetPlayersInBucket

Returns a list of player IDs assigned to a given bucket

bucket: number
return: table | boolean

local players = QBCore.Functions.GetPlayersInBucket(3)
if players then
    print("Players in bucket 3:", json.encode(players))
end

QBCore.Functions.GetEntitiesInBucket

Returns a list of entity IDs (excluding players) assigned to a given bucket

bucket: number
return: table | boolean

local entities = QBCore.Functions.GetEntitiesInBucket(3)
if entities then
    print("Entities in bucket 3:", json.encode(entities))
end

QBCore.Functions.SetEntityBucket

Assigns an entity (e.g., ped, vehicle, or prop) to the specified routing bucket

entity: number
bucket: number
return: boolean

local entity = GetVehiclePedIsIn(GetPlayerPed(source), false)
local success = QBCore.Functions.SetEntityBucket(entity, 3)
if success then
    print("Entity moved to bucket 3")
end

QBCore.Functions.SetPlayerBucket

Assigns a player to the specified routing bucket

source: string
bucket: number
return: boolean

local success = QBCore.Functions.SetPlayerBucket(source, 3)
if success then
    print("Player moved to bucket 3")
end

Items

QBCore.Functions.CreateUseableItem

Registers an item as "usable" and binds it to a callback function

item: string
data: function | table

QBCore.Functions.CreateUseableItem('my_cool_item', function(source, item)
	local Player = QBCore.Functions.GetPlayer(source)
	if not Player.Functions.GetItemByName(item.name) then return end
	-- Trigger code here for what item should do
end)

QBCore.Functions.CanUseItem

Checks if a given item has been registered as usable

item: string
return: table | nil

if QBCore.Functions.CanUseItem("my_cool_item") then
    print("my_cool_item is a usable item")
end

QBCore.Functions.UseItem

Trigger an item to be used on the player

source: string
item: string

local Player = QBCore.Functions.GetPlayer(source)
if not Player.Functions.GetItemByName('my_cool_item') then return end
QBCore.Functions.UseItem(source, 'my_cool_item')

QBCore.Functions.HasItem

Checks if a player has a specific item(s)

source: string
items: string | table
amount: number (optional)
return: boolean

if QBCore.Functions.HasItem(source, "radio") then
    print("Player has a radio")
end

if QBCore.Functions.HasItem(source, { "radio", "id_card" }) then
    print("Player has both a radio and ID")
end

if QBCore.Functions.HasItem(source, { radio = 1, bandage = 3 }) then
    print("Player has 1 radio and 3 bandages")
end

Permissions

QBCore.Functions.AddPermission

Give a player a specific permission level (per session only)

source: string
permission: string

local Player = QBCore.Functions.GetPlayer(playerId)
if not Player then return end
local permission = 'admin'
QBCore.Functions.AddPermission(Player.PlayerData.source, permission)

QBCore.Functions.RemovePermission

Remove a specific permission level or all of the players permissions (per session only)

source: string
permission: string (optional)

local Player = QBCore.Functions.GetPlayer(playerId)
if not Player then return end
local permission = 'admin'
QBCore.Functions.RemovePermission(Player.PlayerData.source, permission)

QBCore.Functions.HasPermission

Check if a player has a specific permission level(s)

source: string
permission: string | table

if QBCore.Functions.HasPermission(source, "admin") then
    print("Player is an admin")
end

QBCore.Functions.GetPermission

Get a player's permission level(s)

source: string
return: table

local permissions = QBCore.Functions.GetPermission(source)
QBCore.Debug(permissions)

QBCore.Functions.IsOptIn

Checks whether a player has opted in to receive reports

source: string
return: boolean

if QBCore.Functions.IsOptin(source) then
    print("Player receives reports")
end

QBCore.Functions.ToggleOptIn

Toggle a players status to receive reports

source: string

QBCore.Functions.ToggleOptin(source)

Callbacks

QBCore.Functions.TriggerClientCallback

Triggers a client-side callback function from the server. Supports both asynchronous usage via a promise and direct function-based response handling

name: string
source: string
cb: function (optional)
...: any

CreateThread(function()
    local playerData = QBCore.Functions.TriggerClientCallback("resourceName:testCallback", source)
    print(playerData)
end)

OR

QBCore.Functions.TriggerClientCallback("resourceName:testCallback", source, function(data)
    print("Received from client:", data)
end)

QBCore.Functions.CreateCallback

Registers a new server-side callback that can be triggered from the client

name: string
cb: function

QBCore.Functions.CreateCallback("resourceName:testCallback", function(source, cb)
    local Player = QBCore.Functions.GetPlayer(source)
    cb(Player)
end)

Miscellaneous

QBCore.Functions.Notify

Triggers a notification on a specfic player

source: string
text: string
type: string (optional)
length: number (optional)

QBCore.Functions.Notify(source, 'Success!', 'success', 5000)

QBCore.Debug

Prints a formatted, color-coded debug output of a table or value

table: table | any
indent: number (optional)
resource: string

local data = {
    name = "John",
    isAdmin = true,
    stats = {
        health = 100,
        stamina = 75,
    }
}

QBCore.Debug(data)

QBCore.ShowError

Prints a red-colored error log to the console

resource: string
message: string

QBCore.ShowError('qb-core', 'Error!')

QBCore.ShowSuccess

Prints a green-colored success/log message to the console

resource: string
message: string

QBCore.ShowSuccess('qb-core', 'Success!')

QBCore.Functions.Kick

Kick a player from the server

playerId: string
reason: string
setKickReason: function (optional)
deferrals: table (optional)

QBCore.Functions.Kick(playerId, "Exploiting detected")

PreviousServer Event Reference NextCommands

Last updated 6 months ago

Was this helpful?