Framework — Server

Functions

GetResourceName

Returns the framework resource name.

local name = Bridge.Framework.GetResourceName()
-- Returns: string

GetIsFrameworkAdmin

Checks if a player has admin permissions.

local isAdmin = Bridge.Framework.GetIsFrameworkAdmin(src)
-- Returns: boolean
ParameterTypeDescription
srcnumberPlayer server ID

GetPlayerIdentifier

Returns a player’s identifier.

local id = Bridge.Framework.GetPlayerIdentifier(src)
-- Returns: string
ParameterTypeDescription
srcnumberPlayer server ID

GetPlayer

Returns the raw framework player object.

local player = Bridge.Framework.GetPlayer(src)
-- Returns: table (framework-specific player object)
ParameterTypeDescription
srcnumberPlayer server ID

GetPlayerByIdentifier

Returns a player object by their identifier string.

local player = Bridge.Framework.GetPlayerByIdentifier(identifier)
-- Returns: table | nil
ParameterTypeDescription
identifierstringPlayer identifier

GetPlayerSource

Returns a player’s server ID from a framework player object.

local src = Bridge.Framework.GetPlayerSource(player)
-- Returns: number
ParameterTypeDescription
playertableFramework player object

GetFrameworkJobs

Returns all registered jobs in the framework.

local jobs = Bridge.Framework.GetFrameworkJobs()
-- Returns: table

GetPlayerName

Returns a player’s character name.

local name = Bridge.Framework.GetPlayerName(src)
-- Returns: string
ParameterTypeDescription
srcnumberPlayer server ID

GetPlayerDob

Returns a player’s date of birth.

local dob = Bridge.Framework.GetPlayerDob(src)
-- Returns: string
ParameterTypeDescription
srcnumberPlayer server ID

GetPlayers

Returns all currently connected players.

local players = Bridge.Framework.GetPlayers()
-- Returns: table

GetPlayerJobData

Returns a player’s job data.

local job = Bridge.Framework.GetPlayerJobData(src)
-- Returns: table { name, label, grade, gradeLabel, isBoss, duty, type }
ParameterTypeDescription
srcnumberPlayer server ID

GetPlayerDuty

Returns whether a player is on duty.

local onDuty = Bridge.Framework.GetPlayerDuty(src)
-- Returns: boolean
ParameterTypeDescription
srcnumberPlayer server ID

SetPlayerDuty

Sets a player’s duty status.

Bridge.Framework.SetPlayerDuty(src, duty)
ParameterTypeDescription
srcnumberPlayer server ID
dutybooleanDuty status

SetPlayerJob

Sets a player’s job.

Bridge.Framework.SetPlayerJob(src, job, grade)
ParameterTypeDescription
srcnumberPlayer server ID
jobstringJob name
gradenumberJob grade

GetPlayerPhone

Returns a player’s phone number.

local phone = Bridge.Framework.GetPlayerPhone(src)
-- Returns: string
ParameterTypeDescription
srcnumberPlayer server ID

GetPlayerGang

Returns a player’s gang data.

local gang = Bridge.Framework.GetPlayerGang(src)
-- Returns: table
ParameterTypeDescription
srcnumberPlayer server ID

GetPlayersByJob

Returns all online players with a given job.

local players = Bridge.Framework.GetPlayersByJob(job)
-- Returns: table
ParameterTypeDescription
jobstringJob name

GetPlayerMetadata

Returns player metadata for a key.

local meta = Bridge.Framework.GetPlayerMetadata(src, key)
ParameterTypeDescription
srcnumberPlayer server ID
keystringMetadata key

SetPlayerMetadata

Sets player metadata for a key.

Bridge.Framework.SetPlayerMetadata(src, key, value)
ParameterTypeDescription
srcnumberPlayer server ID
keystringMetadata key
valueanyValue to set

AddStress

Adds stress to a player.

Bridge.Framework.AddStress(src, amount)
ParameterTypeDescription
srcnumberPlayer server ID
amountnumberAmount to add

RemoveStress

Removes stress from a player.

Bridge.Framework.RemoveStress(src, amount)
ParameterTypeDescription
srcnumberPlayer server ID
amountnumberAmount to remove

AddHunger

Adds hunger to a player.

Bridge.Framework.AddHunger(src, amount)
ParameterTypeDescription
srcnumberPlayer server ID
amountnumberAmount to add

AddThirst

Adds thirst to a player.

Bridge.Framework.AddThirst(src, amount)
ParameterTypeDescription
srcnumberPlayer server ID
amountnumberAmount to add

GetHunger

Returns a player’s hunger level.

local hunger = Bridge.Framework.GetHunger(src)
-- Returns: number
ParameterTypeDescription
srcnumberPlayer server ID

GetThirst

Returns a player’s thirst level.

local thirst = Bridge.Framework.GetThirst(src)
-- Returns: number
ParameterTypeDescription
srcnumberPlayer server ID

GetIsPlayerDead

Returns whether a player is dead.

local dead = Bridge.Framework.GetIsPlayerDead(src)
-- Returns: boolean
ParameterTypeDescription
srcnumberPlayer server ID

RevivePlayer

Revives a player.

Bridge.Framework.RevivePlayer(src)
ParameterTypeDescription
srcnumberPlayer server ID

AddAccountBalance

Adds money to a player’s account.

Bridge.Framework.AddAccountBalance(src, accountType, amount)
ParameterTypeDescription
srcnumberPlayer server ID
accountTypestringAccount type (e.g. ‘cash’, ‘bank’)
amountnumberAmount to add

RemoveAccountBalance

Removes money from a player’s account.

Bridge.Framework.RemoveAccountBalance(src, accountType, amount)
ParameterTypeDescription
srcnumberPlayer server ID
accountTypestringAccount type
amountnumberAmount to remove

GetAccountBalance

Returns a player’s balance for a given account type.

local balance = Bridge.Framework.GetAccountBalance(src, accountType)
-- Returns: number
ParameterTypeDescription
srcnumberPlayer server ID
accountTypestringAccount type

GetJobCount

Returns the number of online players with a specific job.

local count = Bridge.Framework.GetJobCount(job)
-- Returns: number
ParameterTypeDescription
jobstringJob name

GetJobCountTotal

Returns the total count of online players across multiple jobs.

local count = Bridge.Framework.GetJobCountTotal(jobs)
-- Returns: number
ParameterTypeDescription
jobstableArray of job name strings

GetPlayerSourcesByJob

Returns the server IDs of all players with a specific job.

local sources = Bridge.Framework.GetPlayerSourcesByJob(job)
-- Returns: table (array of server IDs)
ParameterTypeDescription
jobstringJob name

Events

community_bridge:Server:OnPlayerLoaded

Fired when a player finishes loading.

RegisterNetEvent('community_bridge:Server:OnPlayerLoaded', function(src)
    -- src: player server ID
end)

community_bridge:Server:OnPlayerUnload

Fired when a player disconnects or unloads.

RegisterNetEvent('community_bridge:Server:OnPlayerUnload', function(src)
    -- src: player server ID
end)

community_bridge:Server:OnPlayerJobChange

Fired when a player’s job changes.

RegisterNetEvent('community_bridge:Server:OnPlayerJobChange', function(src, jobData)
    -- src: player server ID
    -- jobData: table { name, label, grade, gradeLabel, isBoss, duty, type }
end)