Server

Framework Bridge

This module provides a unified server-side API for working with ESX, QBCore, and QBox frameworks. The framework is detected automatically at runtime.

Supported frameworks:

• esx

• qbcore

• qbox

If no supported framework is detected, all functions return safe defaults.

---

getFramework

fjsf.getFramework()

Returns the detected framework name.

---

Returns

• string | nil

  • esx

  • qbcore

  • qbox

  • nil if no framework is detected

---

Example

print(fjsf.getFramework())

---

getCore

fjsf.getCore()

Returns the core object of the detected framework.

---

Returns

• table | nil Framework core object, or nil if unavailable.

---

Example

local core = fjsf.getCore()

---

isFrameworkDetected

fjsf.isFrameworkDetected()

Checks whether a supported framework was detected.

---

Returns

• boolean

---

Example

if fjsf.isFrameworkDetected() then
    print('Framework ready')
end

---

getName

fjsf.getName(source)

Returns the player’s full character name.

---

Parameters

• source number Player server ID.

---

Returns

• string | nil

---

Example

print(fjsf.getName(source))

---

getIdentifier

fjsf.getIdentifier(source)

Returns the player’s unique identifier.

---

Parameters

• source number Player server ID.

---

Returns

• string | nil

---

Example

local identifier = fjsf.getIdentifier(source)

---

getJob

fjsf.getJob(source)

Returns the player’s job object.

---

Parameters

• source number Player server ID.

---

Returns

• table | nil

---

Example

local job = fjsf.getJob(source)
print(job and job.name)

---

getJobGrade

fjsf.getJobGrade(source)

Returns the player’s job grade level.

---

Parameters

• source number Player server ID.

---

Returns

• number Returns 0 if unavailable.

---

Example

print(fjsf.getJobGrade(source))

---

hasJob

fjsf.hasJob(source, jobs)

Checks whether the player matches a job condition.

---

Parameters

• source number Player server ID.

• jobs string | table Job definition(s).

  Supported formats:

  • string – exact job name

  • array – list of job names

  • table – { jobName = minimumGrade }

---

Returns

• boolean

---

Examples

fjsf.hasJob(source, 'police')

fjsf.hasJob(source, { 'police', 'ambulance' })

fjsf.hasJob(source, { police = 2 })

---

getPermission

fjsf.getPermission(source)

Returns the player’s permission group.

---

Parameters

• source number Player server ID.

---

Returns

• string Permission name (default: user).

---

Example

print(fjsf.getPermission(source))

---

hasPermission

fjsf.hasPermission(source, perms)

Checks whether the player belongs to a permission group.

---

Parameters

• source number

• perms string | table

---

Returns

• boolean

---

Example

fjsf.hasPermission(source, 'admin')

---

hasAcePermission

fjsf.hasAcePermission(source, ace)

Checks whether the player has an ACE permission.

---

Parameters

• source number

• ace string | table

---

Returns

• boolean

---

Example

fjsf.hasAcePermission(source, 'command.mycommand')

---

hasMoney

fjsf.hasMoney(source, amount, account)

Checks whether the player has enough money.

---

Parameters

• source number

• amount number

• account string | nil

  • cash

  • bank

  • money (auto-normalized)

---

Returns

• boolean

---

Example

if fjsf.hasMoney(source, 500, 'cash') then
    print('Enough money')
end

---

addMoney

fjsf.addMoney(source, amount, account)

Adds money to a player account.

---

Parameters

• source number

• amount number

• account string | nil

---

Returns

• boolean

---

Example

fjsf.addMoney(source, 1000, 'bank')

---

removeMoney

fjsf.removeMoney(source, amount, account)

Removes money from a player account.

---

Parameters

• source number

• amount number

• account string | nil

---

Returns

• boolean

---

Example

fjsf.removeMoney(source, 250, 'cash')

---

hasItem

fjsf.hasItem(source, item, amount)

Checks whether the player has an item.

---

Parameters

• source number

• item string

• amount number | nil

---

Returns

• boolean

---

Example

if fjsf.hasItem(source, 'lockpick', 2) then
    print('Has lockpicks')
end

---

addItem

fjsf.addItem(source, item, amount, metadata)

Adds an item to the player inventory.

---

Parameters

• source number

• item string

• amount number | nil

• metadata table | nil

---

Returns

• boolean

---

Example

fjsf.addItem(source, 'water', 1)

---

removeItem

fjsf.removeItem(source, item, amount, slot, metadata)

Removes an item from the player inventory.

---

Parameters

• source number

• item string

• amount number | nil

• slot number | nil

• metadata table | nil

---

Returns

• boolean

---

Example

fjsf.removeItem(source, 'bread', 1)

---

hasLicense

fjsf.hasLicense(source, license)

Checks whether the player owns a license.

---

Parameters

• source number

• license string

---

Returns

• boolean

---

Example

if fjsf.hasLicense(source, 'weapon') then
    print('License owned')
end