Server

The ak47_bridge automatically detects the running framework. You can access these functions by importing the bridge export in your script.

local Bridge = exports['ak47_bridge']:GetBridge()

Core Player & Identity

These functions handle identifying players and retrieving their basic information across all frameworks.

Bridge.GetPlayer

Retrieves the raw framework-specific player object (e.g., xPlayer for ESX, Player for QBCore).

--- @param source number The player's server ID
--- @return table|nil The player object
local player = Bridge.GetPlayer(source)

Bridge.GetIdentifier

Returns the unique identifier for the player (CitizenID for QBCore/QBX, Identifier for ESX).

--- @param source number The player's server ID
--- @return string The unique identifier
local identifier = Bridge.GetIdentifier(source)

Bridge.GetName

Returns the player's full character name.

--- @param source number The player's server ID
--- @return string The full name (Firstname Lastname)
local name = Bridge.GetName(source)

Bridge.GetPhoneNumber

Returns the player's phone number.

--- @param source number The player's server ID
--- @return string The phone number
local phone = Bridge.GetPhoneNumber(source)

Bridge.GetLicense

Returns the Rockstar license of the player.

--- @param source number The player's server ID
--- @return string The license
local license = Bridge.GetLicense(source)

Bridge.GetSourceFromIdentifier

Finds a player's server ID based on their identifier.

--- @param identifier string The unique identifier
--- @return number|nil The source ID (or nil if offline)
local source = Bridge.GetSourceFromIdentifier(identifier)

Bridge.GetPlayerMetaValue / Bridge.SetPlayerMetaValue

Gets or sets metadata for a player. (Bridges QBCore metadata and ESX xPlayer.getMeta/setMeta).

-- Get
local val = Bridge.GetPlayerMetaValue(source, 'hunger')

-- Set
Bridge.SetPlayerMetaValue(source, 'hunger', 100)

---

Jobs, Gangs & Permissions

Bridge.GetJob

Returns a standardized job table.

--- @param source number
--- @return table { name, label, payment, isboss, grade = { name, level } }
local job = Bridge.GetJob(source)
print(job.name, job.grade.level)

Bridge.SetJob

Sets the player's job and grade.

--- @param source number
--- @param jobName string
--- @param grade number
Bridge.SetJob(source, 'police', 2)

Bridge.GetGang

Returns a standardized gang table.

--- @param source number
--- @return table { name, label, isboss, grade = { name, level } }
local gang = Bridge.GetGang(source)

Bridge.SetGang

Sets the player's gang and grade.

--- @param source number
--- @param gangName string
--- @param grade number
Bridge.SetGang(source, 'ballas', 1)

Bridge.IsAdmin

Checks if the player has admin privileges (checks for 'command' ace permission).

--- @param source number
--- @return boolean
if Bridge.IsAdmin(source) then
    print("Player is admin")
end

---

Economy

Bridge.GetMoney

Retrieves the balance of a specific account.

--- @param source number
--- @param account string 'money' (or 'cash'), 'bank', 'black_money'
--- @return number
local cash = Bridge.GetMoney(source, 'cash')

Bridge.AddMoney

Adds money to a specific account.

--- @param source number
--- @param account string
--- @param amount number
Bridge.AddMoney(source, 'bank', 5000)

Bridge.RemoveMoney

Removes money from a specific account.

--- @param source number
--- @param account string
--- @param amount number
Bridge.RemoveMoney(source, 'money', 100)

Bridge.GetSocietyMoney

Gets the money associated with a job/society. Supports esx_addonaccount, qb-management, qb-banking, okokBanking, and Renewed-Banking.

--- @param jobName string
--- @return number
local balance = Bridge.GetSocietyMoney('police')

Bridge.AddSocietyMoney / Bridge.RemoveSocietyMoney

Modifies society funds.

Bridge.AddSocietyMoney('police', 1000)
Bridge.RemoveSocietyMoney('police', 500)

---

Basic Vehicle Management

Bridge.IsVehicleOwner

Checks if a player owns a vehicle with a specific plate.

--- @param source number
--- @param plate string
--- @return boolean
local owned = Bridge.IsVehicleOwner(source, 'ABC 123')

Bridge.GetVehicleOwner

Returns the identifier of the owner of a specific plate.

--- @param plate string
--- @return string|nil Identifier
local owner = Bridge.GetVehicleOwner('ABC 123')

Bridge.GeneratePlate

Generates a unique plate based on a pattern.

--- @param format string (optional) Default: "AAAA 11A"
--- @param prefix string (optional)
--- @return string
local newPlate = Bridge.GeneratePlate("AA111111")

Bridge.GiveVehicle

Inserts a vehicle into the database (owned_vehicles / player_vehicles).

--- @param source number
--- @param model string|number Model name or hash
Bridge.GiveVehicle(source, 'adder')