🔗nova_bridge

NOVA Framework compatibility bridge. Allows scripts written for ESX, QBCore, vRPex, or Creative frameworks to work with NOVA without any code changes.

Features

• ESX Compatibility — Provides es_extended resource

• QBCore Compatibility — Provides qb-core resource

• vRPex Compatibility — Provides vrp resource

• Creative Compatibility — Provides Creative framework functions

• Single Mode — One compatibility mode active at a time

Configuration

Edit config.lua:

BridgeConfig = {
    Mode = 'esx',    -- 'esx', 'qbcore', 'vrpex', 'creative', 'none'
}

Available Modes

Mode	Description	Provides Resource
esx	ESX Legacy compatibility	es_extended
qbcore	QBCore compatibility	qb-core
vrpex	vRPex compatibility	vrp
creative	Creative Network compatibility	—
none	No compatibility (NOVA-native only)	—

How It Works

The bridge intercepts calls to the target framework's API and translates them to NOVA equivalents:

Example with ESX mode:

-- A script written for ESX does this:
local ESX = exports['es_extended']:getSharedObject()
local xPlayer = ESX.GetPlayerFromId(source)
xPlayer.addMoney(500)

-- The bridge translates it to:
-- exports['nova_core']:GetPlayer(source)
-- exports['nova_core']:AddPlayerMoney(source, 'cash', 500)

Mapped Functions

The bridge maps common framework functions including:

• Player data retrieval

• Money operations (add, remove, get)

• Job management

• Inventory operations

• Notification triggers

• Callbacks

Usage

1. Set BridgeConfig.Mode to match the scripts you want to use

2. Ensure nova_bridge loads after nova_core

3. Start your ESX/QBCore/vRPex scripts as normal — they'll use NOVA through the bridge

# server.cfg
ensure nova_core
ensure nova_bridge

# ESX scripts work without changes
ensure esx_skin
ensure esx_policejob

Dependencies

• nova_core — Core framework (source of all player data)

Notes

• Only one mode can be active at a time

• Not all edge-case functions may be mapped; test your scripts

• Native NOVA scripts do not need the bridge

• The bridge adds minimal overhead since it's just function mapping

• If you're writing new scripts, use NOVA's native API for best performance