pebble_bridge · v1.2.0

Bridge

The shared bridge every Pebble resource runs on. It detects your framework, inventory, target, UI and services, so you configure it once per server.

Frameworks
QBCoreQboxESXStandalone
Requires
ox_lib

pebble_bridge connects Pebble resources to your framework, inventory, target, UI (notifications, progress bars, TextUI, menus, input dialogs), logging and services like dispatch, vehicle keys, fuel, medical, phone and appearance. Every Pebble resource needs it.

It's open source, not escrowed, so you can adjust things like an inventory's image path or export name yourself.

Install

  1. Put pebble_bridge in your resources folder.
  2. Start it after your framework, inventory, target and ox_lib, and before any Pebble resource:
ensure ox_lib
ensure oxmysql
ensure qb-core          # or qbx_core / es_extended
ensure ox_inventory     # your inventory
ensure ox_target        # optional
ensure pebble_bridge
ensure pebble_looting
ensure pebble_airdrops

Configuration

Everything defaults to auto, which picks the first started resource from Supported resources. To force one, set its convar in server.cfg. Use setr so clients see the same values:

setr pebble_bridge:framework "auto"
setr pebble_bridge:inventory "auto"
setr pebble_bridge:target "auto"
setr pebble_bridge:dispatch "auto"
setr pebble_bridge:vehicleKeys "auto"
setr pebble_bridge:fuel "auto"
setr pebble_bridge:medical "auto"
setr pebble_bridge:phone "auto"
setr pebble_bridge:appearance "auto"
setr pebble_bridge:notify "auto"
setr pebble_bridge:progress "auto"
setr pebble_bridge:progressStyle "bar"  # ox_lib / wasabi_uikit: bar or circle
setr pebble_bridge:textUI "auto"
setr pebble_bridge:menu "auto"
setr pebble_bridge:input "auto"
set pebble_bridge:log "auto"
set pebble_bridge:logWebhook ""        # Discord webhook; set, not setr, so clients never see it
setr pebble_bridge:lootWindow "false"  # true: show loot in the resource's own window with any inventory
setr pebble_bridge:debug "false"       # true: draw qb-target zones

config.lua holds the same settings as fallbacks for servers without convars, plus the loot window's search timing (lootWindowSearchSeconds) and its messages.

Supported resources

Listed in detection order. The last entry in italics is used when none of the others is started.

Kind Resources
Framework qbx_core, qb-core, es_extended, standalone (license identifier, ace groups, no money or jobs)
Inventory codem-inventoryv2, ox_inventory, tgiann-inventory, qs-inventory, qb-inventory (2.x), ps-inventory, codem-inventory (v1). Required.
Target ox_target, qb-target, sleepless_interact, textui (ox_lib [E] prompt)
Dispatch ps-dispatch, cd_dispatch, qs-dispatch, rcore_dispatch, core_dispatch, lb-tablet, tk_dispatch, origen_police, codem-dispatch, aty_dispatch, none (notification and blip for on-duty players)
Vehicle keys qbx_vehiclekeys, qb-vehiclekeys, Renewed-Vehiclekeys, wasabi_carlock, MrNewbVehicleKeys, vehicles_keys, cd_garage, none
Fuel ox_fuel, LegacyFuel, cdn-fuel, Renewed-Fuel, lc_fuel, rcore_fuel, native (GTA fuel level)
Medical wasabi_ambulance (v1 and v2), osp_ambulance, p-ambulancejob, tk_ambulancejob, qbx_medical, qb-ambulancejob, esx_ambulancejob, none
Phone lb-phone, qs-smartphone-pro, gksphone, yseries, 17mov_Phone, none (framework notification)
Appearance illenium-appearance, fivem-appearance, qb-clothing (set only), skinchanger / esx_skin, none
Notifications wasabi_notify, okokNotify, lation_ui, brutal_notify, mythic_notify, framework (Qbox, QBCore or ESX notifications; ox_lib when standalone). ox_lib can also be set.
Progress bar lation_ui, wasabi_uikit, progressbar (QBCore), esx_progressbar, ox_lib
TextUI lation_ui, okokTextUI, jg-textui, cd_drawtextui, esx_textui, qb-core (DrawText), ox_lib
Menu lation_ui, wasabi_uikit, qb-menu, ox_lib
Input dialog lation_ui, wasabi_uikit, qb-input, ox_lib
Logging discord (picked automatically when pebble_bridge:logWebhook is set), fmsdk (Fivemanage), ox_lib (lib.logger)

ps-inventory and codem-inventory v1 have no server API to fill a stash, so their stashes always open in the resource's own loot window.

qb-inventory and qs-inventory stashes are named <resource>_stash_<time>_<n> and deleted from the database when the resource restarts.

Without a framework (standalone), money, jobs, gangs and metadata return empty values.