Player Data - Atlas Scripts

The Bridge global gives you one provider-agnostic surface for player data. Write against Bridge.GetJob(src) and Bridge.Inventory.AddItem(src, ...), and the bridge routes to whatever framework and inventory the server runs. Account names and the job shape are normalized, so your code never branches on ESX vs QBCore.

Everything here is for resources building on the bridge. If you are configuring which framework/inventory the bridge uses, see Providers.

Framework

The most-used calls hang off Bridge directly as shortcuts; the full surface is Bridge.Framework.

Server

local job = Bridge.GetJob(src)   -- { name, label, grade, gradeLabel, isBoss, onDuty }

Bridge.AddMoney(src, 'bank', 500, 'paycheck')   -- accounts: 'cash' | 'bank' | 'dirty'
Bridge.RemoveMoney(src, 'cash', 100, 'shop')
local cash = Bridge.GetMoney(src, 'cash')

Bridge.SetJob(src, 'police', 2)
Bridge.SetDuty(src, true)
if Bridge.IsAdmin(src) then end

local id   = Bridge.GetIdentifier(src)   -- license / primary identifier
local name = Bridge.GetName(src)         -- "First Last"

Method	Returns / effect
`Bridge.GetJob(src)`	Normalized job table (below).
`Bridge.SetJob(src, name, grade?)`	Change a player’s job.
`Bridge.SetDuty(src, bool)`	Toggle duty.
`Bridge.GetMoney(src, account)`	Balance of `cash` / `bank` / `dirty`.
`Bridge.AddMoney(src, account, amount, reason?)`	Credit an account.
`Bridge.RemoveMoney(src, account, amount, reason?)`	Debit an account; returns `false` if short.
`Bridge.GetIdentifier(src)`	Primary identifier.
`Bridge.GetName(src)`	Display name.
`Bridge.GetPlayers()`	All loaded players.
`Bridge.IsAdmin(src)`	Framework admin check (see warning below).

The full Bridge.Framework surface also includes GetSociety(job), AddSociety(job, amount), RemoveSociety(job, amount), and GetPlayersByJob(job).

Normalized job shape

{
    name       = 'police',     -- internal job name
    label      = 'Police',     -- display label
    grade      = 2,            -- grade level (number)
    gradeLabel = 'Sergeant',   -- grade display label
    isBoss     = false,        -- boss/management grade
    onDuty     = true,         -- duty state
}

Normalized accounts

Money accounts are always one of three normalized names, regardless of framework:

Account	Notes
`cash`	On-hand money.
`bank`	Bank balance.
`dirty`	”Black”/dirty money — only on ESX (`black_money`) and standalone.

Society balances require the framework’s banking resource (esx_addonaccount, qb-banking, or Renewed-Banking). Without one, GetSociety / AddSociety / RemoveSociety are no-ops.

Client

local data   = Bridge.GetPlayerData()  -- { identifier, name = { first, last }, job, money = { cash, bank, dirty } }
local job    = Bridge.GetJob()         -- normalized job table
local onDuty = Bridge.IsOnDuty()

Bridge.IsAdmin(src) is a framework admin check (e.g. ESX/QB group), and is separate from the Discord-role permission system. For permission nodes backed by ACEs and Discord roles, use Bridge.Permissions.Has(src, node) — see Permissions.

Lifecycle hooks

React to player load, job change, and unload without touching framework-specific events.

Server
Client

Bridge.Framework.OnPlayerLoaded(function(src)
    -- player fully loaded
end)

Bridge.Framework.OnJobChange(function(src, job)
    -- job is the new normalized job table
end)

Bridge.Framework.OnPlayerUnload(function(src)
    -- player dropped — flush per-player state here
end)

Bridge.Framework.OnPlayerLoaded(function()
    -- local player loaded (no src on the client)
end)

Bridge.Framework.OnJobChange(function(job)
    -- local player's new job table
end)

Inventory

Item operations are normalized across ox_inventory, qb-inventory, qs-inventory, ESX legacy, and the bridge’s virtual inventory.

Server

Bridge.Inventory.AddItem(src, 'water', 1)
Bridge.Inventory.RemoveItem(src, 'water', 1)

if Bridge.Inventory.HasItem(src, 'lockpick', 1) then end
local n   = Bridge.Inventory.GetItemCount(src, 'water')
local can = Bridge.Inventory.CanCarry(src, 'water', 10)
local all = Bridge.Inventory.GetItems(src)

Method	Returns / effect
`AddItem(src, item, count, meta?)`	Give an item.
`RemoveItem(src, item, count)`	Take an item.
`HasItem(src, item, count?)`	Whether the player holds at least `count` (default 1).
`GetItemCount(src, item)`	Quantity held.
`CanCarry(src, item, count)`	Whether the player has room/weight.
`GetItems(src)`	The player’s full item list.

Client

local items = Bridge.Inventory.GetItems()
local has   = Bridge.Inventory.HasItem('phone', 1)

Usable items

Register a use handler from the server. The bridge wires it to whatever inventory’s “use” path and calls your function with the player src.

-- server
Bridge.Inventory.RegisterUsableItem('water', function(src)
    -- consume + apply effect
    Bridge.Inventory.RemoveItem(src, 'water', 1)
end)

Treat every inventory action as server-authoritative. Never decide an item exists or a balance is sufficient on the client — call these server-side, and validate any client request through Bridge.Net first.

Running an unsupported stack?

If the bridge does not ship support for your framework or inventory, fill the editable adapter and point a convar at custom. The adapter contract is the exact method set documented here.

Custom Framework

The framework adapter contract and a worked example.

Custom Inventory

The inventory adapter contract and item shapes.

​Framework

​Server

​Normalized job shape

​Normalized accounts

​Client

​Lifecycle hooks

​Inventory

​Server

​Client

​Usable items

​Running an unsupported stack?

Custom Framework

Custom Inventory

Framework

Server

Normalized job shape

Normalized accounts

Client

Lifecycle hooks

Inventory

Server

Client

Usable items

Running an unsupported stack?