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
- Put
pebble_bridgein your resources folder. - 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.