Configuration

This guide explains how to configure the bridge for your server. All options are set in config.lua inside the bridge resource folder.

• Configuration file
• Core options
  • Version check
  • Debug
• Integrations
  • Framework
  • Inventory
  • Phone
  • Targeting
  • Medical
  • Appearance
  • Voice
  • Dispatch
  • Vehicle keys
  • Vehicle fuel
  • Minigames
• Group system
• Cooldown system
• Loot rarity weights
• UniQueue
• Full example
• Important notes
• Support

Configuration file

Edit config.lua in the prp-bridge resource folder. Changes require a server restart to take effect.

Resource names

Every option that references a resource (framework, inventory, phone, etc.) must match the exact resource name (case-sensitive) of your installed resource.

Core options

Version check

BridgeConfig.VersionCheck = true

Type	boolean
Default	true
Description	Enables automatic version checking for compatibility.
Recommendation	Keep enabled to receive important updates.

Debug

BridgeConfig.Debug = true

Type	boolean
Default	true
Description	Enables module load and debug-level logging.

Integrations

Each integration is a string set to the resource name of the system you use.

You can disable any category by setting it to false. The bridge still starts, and scripts that do not use that category keep working. Calls to a disabled module are no-ops.

BridgeConfig.Phone = false
BridgeConfig.Dispatch = false

Framework

BridgeConfig.FrameWork = "qbx_core"

Value	Framework
"qbx_core"	QBox Framework
"qb-core"	QB-Core Framework
"es_extended"	ESX Framework
"nd_core"	ND Core Framework
"ox_core"	OX Core Framework

Inventory

BridgeConfig.Inventory = "ox_inventory"

Value	Name
"ox_inventory"	OX Inventory
"origen_inventory"	Origen Inventory
"tgiann-inventory"	Tgiann Inventory

Phone

BridgeConfig.Phone = "lb-phone"

Value	Name
"lb-phone"	LB Phone
"yseries"	YSeries
"yphone"	YPhone
"yflip"	YFlip Phone
"npwd"	NPWD
"roadphone"	Road Phone
"17mov_phone"	17Mov Phone
"gksphone"	GKS Phone
"meteo-phone"	Meteo Phone
"qs-smartphone-pro"	QS Smartphone Pro

Targeting

BridgeConfig.Target = "ox_target"

Value	Name
"ox_target"	OX Target
"qb-target"	QB-Target
"sleepless_interact"	Sleepless Interact

Medical

BridgeConfig.Medical = "qbx_medical"

Value	Name
"qbx_medical"	Qbox Medical
"esx_ambulancejob"	ESX Ambulance Job
"wasabi_ambulance"	Wasabi Ambulance
"ars_ambulancejob"	ARS Ambulance Job
"osp_ambulance"	OSP Ambulance
"p-ambulancejob"	P Ambulance Job
"nd_ambulance"	ND Ambulance
"qb-ambulancejob"	QB Ambulance Job
"randol_medical"	Randol Medical
"tk_ambulancejob"	TK Ambulance Job

Appearance

BridgeConfig.Appearance = "illenium-appearance"

Value	Name
"illenium-appearance"	Illenium Appearance
"fivem-appearance"	FiveM Appearance
"qb-clothing"	QB Clothing
"esx_skin"	ESX Skin

Voice

BridgeConfig.Voice = "pma-voice"

Value	Name
"pma-voice"	PMA Voice

Dispatch

BridgeConfig.Dispatch = "ps-dispatch"

Value	Name
"ps-dispatch"	PS Dispatch
"origen_police"	Origen Dispatch
"cd_dispatch"	CD Dispatch
"rcore_dispatch"	RCore Dispatch
"tk_dispatch"	TK Dispatch
"lb-tablet"	LB Tablet
"aty_dispatch"	ATY Dispatch
"codem-dispatch"	CodeM Dispatch
"core_dispatch"	Core Dispatch
"kartik-mdt"	Kartik MDT
"qs-dispatch"	QS Dispatch

Vehicle keys

BridgeConfig.VehicleKeys = "qbx_vehiclekeys"

Value	Name
"qbx_vehiclekeys"	Qbox Vehicle Keys
"cd_garage"	CD Garage
"mVehicle"	MVehicle
"okokGarage"	okokGarage
"qb-vehiclekeys"	QB Vehicle Keys
"vehicles_keys"	Vehicles Keys
"wasabi_carlock"	Wasabi Carlock
"nd_core"	ND Core (native vehicle keys)
"mrnewbvehiclekeys"	MrNewb Vehicle Keys
"Renewed-Vehiclekeys"	Renewed Vehicle Keys

Vehicle fuel

BridgeConfig.VehicleFuel = "ox_fuel"

Value	Name
"ox_fuel"	OX Fuel
"LegacyFuel"	Legacy Fuel
"cdn-fuel"	CDN Fuel
"lc_fuel"	LC Fuel
"qb-fuel"	QB Fuel
"Renewed-Fuel"	Renewed Fuel
"rcore_fuel"	RCore Fuel

Minigames

BridgeConfig.Minigames = "prp-minigames"

Value	Name
"prp-minigames"	Prodigy Studios Minigames

Group system

BridgeConfig.Group = {
    CommandEnabled = true,
    CommandName = "group",
}

Option	Type	Default	Description
CommandEnabled	boolean	true	Enables or disables the group command.
CommandName	string	"group"	Command name for group management (e.g. /group).

Cooldown system

BridgeConfig.Cooldowns = {
    AdminCommandEnabled = true,
    AdminCommandName = "cooldowns",
    AdminCommandRestriction = "group.admin",
}

Option	Type	Default	Description
AdminCommandEnabled	boolean	true	Enables the cooldown admin command.
AdminCommandName	string	"cooldowns"	Command name to manage cooldowns.
AdminCommandRestriction	string	"group.admin"	Permission required to use the command.

Loot rarity weights

Used by the loot generator when rolling item rarities. Higher weight = more common.

BridgeConfig.LootRarityWeights = {
    ["COMMON"] = 800,
    ["RARE"] = 150,
    ["EPIC"] = 45,
    ["LEGENDARY"] = 5,
}

Key	Type	Default	Description
COMMON	number	800	Weight for common loot.
RARE	number	150	Weight for rare loot.
EPIC	number	45	Weight for epic loot.
LEGENDARY	number	5	Weight for legendary loot.

UniQueue

UniQueue (mission queue and party system) is configured under BridgeConfig.Uniqueue. See UniQueue for the full option list and usage.

Full example

Click to expand full config example

BridgeConfig = {}

BridgeConfig.VersionCheck = true
BridgeConfig.Debug = true

BridgeConfig.FrameWork = "qbx_core"
BridgeConfig.Inventory = "ox_inventory"
BridgeConfig.Phone = "lb-phone"
BridgeConfig.Target = "ox_target"
BridgeConfig.Medical = "qbx_medical"
BridgeConfig.Dispatch = "ps-dispatch"
BridgeConfig.VehicleKeys = "qbx_vehiclekeys"
BridgeConfig.VehicleFuel = "ox_fuel"
BridgeConfig.Minigames = "prp-minigames"
BridgeConfig.Appearance = "illenium-appearance"
BridgeConfig.Voice = "pma-voice"

BridgeConfig.Group = {
    CommandEnabled = true,
    CommandName = "group",
}

BridgeConfig.Cooldowns = {
    AdminCommandEnabled = true,
    AdminCommandName = "cooldowns",
    AdminCommandRestriction = "group.admin",
}

BridgeConfig.Uniqueue = {
    MaxOverTimePriority = 30,
    AddOverTimePriorityTime = math.floor(2.5 * 60),
    HoldQueuesOnStartTime = 0,
    PoliceStrengthPerPlayer = 1,
    PoliceJobs = { "lspd", "police", "bsco" },
}

BridgeConfig.LootRarityWeights = {
    ["COMMON"] = 800,
    ["RARE"] = 150,
    ["EPIC"] = 45,
    ["LEGENDARY"] = 5,
}

Important notes

• Resource names: Must match exactly (case-sensitive) your installed resources.
• Restart: Configuration changes require a server restart.
• Framework first: Ensure your framework is running and configured before relying on the bridge.

Support

If you have configuration issues:

• Double-check every resource name against your server.
• Confirm required resources are installed and start before the bridge.
• Check the console for errors.

For more help, open a ticket on our Discord.