Client

Framework Bridge

This module provides a unified client-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 name of the detected framework.

---

Returns

• string | nil

  • esx

  • qbcore

  • qbox

  • nil if no framework is detected

---

Example

local fw = fjsf.getFramework()
print(fw)

---

getCore

fjsf.getCore()

Returns the core object of the detected framework.

---

Returns

• table | nil Framework core object, or nil if not detected.

---

Example

local core = fjsf.getCore()
if core then
    print('Core loaded')
end

---

isFrameworkDetected

fjsf.isFrameworkDetected()

Checks whether a supported framework was detected.

---

Returns

• boolean

  • true – Framework detected

  • false – No framework detected

---

Example

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

---

isPlayerLoaded

fjsf.isPlayerLoaded()

Checks whether the player is fully loaded.

This uses framework-specific player load and unload events.

---

Returns

• boolean

  • true – Player is loaded

  • false – Player is not loaded

---

Example

CreateThread(function()
    while not fjsf.isPlayerLoaded() do
        Wait(100)
    end

    print('Player loaded')
end)

---

getJob

fjsf.getJob()

Returns the player’s current job.

Works across ESX, QBCore, and QBox.

---

Returns

• table | nil Player job object, or nil if unavailable.

---

Example

local job = fjsf.getJob()
if job then
    print(job.name)
end

---

getJobGrade

fjsf.getJobGrade()

Returns the player’s job grade level.

Automatically adapts to framework-specific job structures.

---

Returns

• number Job grade level. Returns 0 if unavailable.

---

Example

local grade = fjsf.getJobGrade()
print('Job grade:', grade)

---

hasJob

fjsf.hasJob(jobs)

Checks whether the player has a specific job.

---

Parameters

• jobs string | table Job definition(s).

  Supported formats:

  • string Exact job name.

  • array List of allowed job names.

  • table Job name mapped to minimum required grade.

---

Returns

• boolean

  • true – Player matches the job condition

  • false – Does not match

---

Examples

Single job

if fjsf.hasJob('police') then
    print('Player is police')
end

Multiple jobs

if fjsf.hasJob({ 'police', 'ambulance' }) then
    print('Emergency services')
end

Job with minimum grade

if fjsf.hasJob({ police = 3 }) then
    print('High rank police')
end

---

isPlayerDead

fjsf.isPlayerDead()

Checks whether the player is dead or in last stand.

Automatically adapts to framework-specific metadata.

---

Returns

• boolean

  • true – Player is dead or in last stand

  • false – Player is alive

---

Example

if fjsf.isPlayerDead() then
    print('Player is dead')
end

---

hasLicense

fjsf.hasLicense(license)

Checks whether the player owns a specific license.

This function uses a server callback internally.

---

Parameters

• license string License name.

---

Returns

• boolean

  • true – Player has the license

  • false – Player does not have the license

---

Example

if fjsf.hasLicense('weapon') then
    print('Weapon license owned')
end