Smoke Bunker
Smoke Bunker integrations
Supported frameworks, inventories, targets, clothing, dispatch and logging, and the file for each bridge.
The Lua files under bridge are open to edit. Framework and inventory bridges check at load whether their resource is running, so start both before smoke_bunker.
Frameworks#
| Framework | Resource | Status | What to know |
|---|---|---|---|
| ESX | es_extended | Supported | Members saved by xPlayer identifier. No gangs: gangMode.esxGangJobs lists the jobs that count as gangs. |
| QBCore | qb-core | Supported | Used only when qbx_core is not running. Members saved by citizenid. |
| Qbox | qbx_core | Supported | Wins over qb-core. Members saved by citizenid. |
| ox_core | ox_core | Supported | Members saved by charId. Jobs and gangs are both character groups. Payments use the character's account, whatever buyer.account says. No usable-item registry: placeable items rely on the server.export entry of their item definition. |
Buying or selling a bunker and depositing or withdrawing org funds use the player's bank account; the dealer terminal charges buyer.account. Admin check per framework: Commands.
Inventories#
| Inventory | Resource | Status | Item name table |
|---|---|---|---|
| ox_inventory | ox_inventory | Supported | config.itemNames.ox |
| jaksam_inventory | jaksam_inventory | Supported | config.itemNames.jaksam |
| qb-inventory | qb-inventory | Supported, v2 | config.itemNames.qb |
| ps-inventory | ps-inventory | Supported | config.itemNames.qb |
| codem-inventory | codem-inventory | Limited | config.itemNames.qb |
| codem-inventoryv2 | codem-inventoryv2 | Supported | config.itemNames.codemv2 |
| one_inventory | one_inventory | Supported | config.itemNames.one |
| wasabi_inventory | wasabi_inventory | Supported | config.itemNames.wasabi |
| tgiann-inventory | tgiann-inventory | Supported | config.itemNames.tgiann |
codem-inventory has no stash add or take export, so the bridge rewrites the whole stash on each change. A change made while a player has the stash open can be lost when they close it.
Run one inventory. If several run, wasabi_inventory wins, then codem-inventory and codem-inventoryv2, which beat every bridge except one_inventory. jaksam_inventory and one_inventory beat ox_inventory and qb-inventory. With both CodeM resources running, inventory support is off: see the FAQ.
Item files: Install. Item names: Configure.
Targets and prompts#
interact in config/client/config.lua sets how players use interact points.
| Value | Resource | What it does |
|---|---|---|
'ox_target' | ox_target | Sphere zone for each interact point. |
'qb-target' | qb-target | Circle zone for each interact point. |
'textui' | None | [E] <label> prompt through the text UI. |
'auto' | ox_target, qb-target or none | ox_target if running, then qb-target, then the text prompt. |
textUI in the same file sets the text UI for the text prompt and the cutscene skip.
| Value | Resource | Call |
|---|---|---|
'auto' or 'ox_lib' | ox_lib | lib.showTextUI |
'qb' | qb-core | DrawText export |
'okok' | okokTextUI | Open export |
'jg' | jg-textui | DrawText export |
Clothing#
clothing in config/client/config.lua picks the resource whose outfit menu the Personal Quarters wardrobe opens.
| Value | Resource | What it opens |
|---|---|---|
'illenium-appearance' | illenium-appearance | Its outfit menu. |
'fivem-appearance' | fivem-appearance | Components and props only. Saves through the original example's event: forks may save differently. |
'qb-clothing' | qb-clothing | Its outfit menu. |
'esx_skin' | esx_skin | Its saveable menu. |
'auto' | First of these that is running | Checked in table order. |
Dispatch#
Police alerts go to online players whose job is in dispatch.jobs, as a notification and a flashing blip lasting dispatch.blipSeconds. With cd_dispatch running, the same jobs also get the alert through its cd_dispatch:AddNotification event. dispatch.enabled turns alerts on or off. dispatch.onRaidBreach alerts when raiders hack or plant C4 on a bunker keypad, dispatch.onHighRiskMission when a high-risk mission first shows on the map. For another dispatch script, edit bridge/dispatch/server.lua.
Logging#
Set logger in config/server/config.lua. Logging is off until logger.enabled is true; logger.type picks where log lines go.
logger.type | What it does |
|---|---|
'discord' | Posts each log line to a Discord webhook as an embed. |
'ox' | Writes each log line through the ox_lib logger, as smoke_bunker:<category>. |
For 'discord', set logger.discordWebhook. logger.webhooks sends a category, such as RAID, to its own webhook; a blank entry falls back to webhooks.default, then discordWebhook.
Notifications and dialogs#
Notifications use lib.notify and input dialogs lib.inputDialog, both from ox_lib. Their files are in the table below.
Where each bridge lives#
| Folder or file | Covers |
|---|---|
bridge/framework/esx, ox, qb, qbx | Frameworks. |
bridge/inventory/codem, codemv2, jaksam, one, ox, ps, qb, tgiann, wasabi | Inventories. |
bridge/interact/interact.lua | Target or text prompt. |
bridge/textUI/client.lua | Text UI. |
bridge/clothing/client.lua | Wardrobe and outfit save. |
bridge/dispatch/client.lua and server.lua | Police alerts. |
bridge/notify/client.lua and server.lua | Notifications. |
bridge/inputDialog/client.lua | Input dialogs. |
bridge/logger/logger.lua | Discord and ox_lib logging. |
bridge/listeners/server.lua | Server events for your own code: Events. |
Check which bridge was picked#
Set debugPrints = true in config/shared/config.lua and restart the resource. The console prints the picked framework and inventory:
[smoke_bunker:S:bridge] framework selected: Qbox
[smoke_bunker:S:bridge] inventory selected: oxSet debugPrints back to false afterwards.
