Skip to content

Customization

Every setting is in one file, config.lua — the only file left open in escrow_ignore. The client and server scripts are escrowed.


FileWhat it decides
config.luaFramework, props, distances, timings, detector, defuser, what items come back, beeping, webhook
html/The detonator phone and the C4 minigame screens
inventory_items/Ready-made item definitions: ox_inventory.md, qb_inventory.md, esx_sql_items.md
inventory_images/Item icons: car_bomb.png, phone_detonator.png, bomb_detector.png, bomb_defuser.png, defused_bomb.png

There is no locales/ folder and no bridge folder. The framework is picked with Config.Framework.


OptionWhat it doesDefault
Config.Frameworkesx or qbcore. On QBox, use qbcore — QBox runs QBCore resources through its compatibility layer. Anything else stops the resource on startesx
OptionWhat it doesDefault
Config.BombPropThe bomb prop held in the right handprop_bomb_01
Config.ExplosionTypeThe game’s explosion type used when a bomb goes off4
Config.PlacementDistanceHow close (m) you must be to the vehicle2.0
Config.PlacementDurationLength of the planting animation, in ms2000
Config.RemoveItemTake one car_bomb from the inventory when a bomb is plantedfalse
Config.UseC4GameForPlacementPlanting needs the C4 minigame. A failed game blows the vehicle up on the spotfalse
OptionWhat it doesDefault
Config.DetectorPropThe scanner propw_am_digiscanner
Config.DetectorDistanceHow far (m) the detector finds bombed vehicles20.0
Config.DetectorFacingAngleHow far off-centre (degrees) the camera can point and still beep30.0
Config.DetectorMaxBeepIntervalTime between beeps at the edge of the range, in ms1000
Config.DetectorMinBeepIntervalTime between beeps right next to the bomb, in ms200
Config.DetectorBeepRangeHow close (m) other players must stand to hear your detector3.0
Config.ShowDetectorBlipPut a blip on bombed vehicles in range while the detector is outtrue
Config.DetectorBlipSpriteBlip icon486
Config.DetectorBlipColorBlip colour1 (red)
Config.DetectorBlipScaleBlip size0.8
Config.DetectorBlipDurationStill in config.lua, but not read by the current version. A blip stays while the vehicle is in range and the detector is out30000
OptionWhat it doesDefault
Config.DefuserDistanceHow close (m) you must be to the vehicle3.0
Config.DefuserDurationLength of the defusing animation, in ms5000
Config.RemoveDefuserItemTake one bomb_defuser from the inventory after a defusalfalse
Config.UseC4GameForDefusalDefusing needs the C4 minigame. A failed game blows the vehicle upfalse
OptionWhat it doesDefault
Config.GiveBackBombGive the defuser a bomb item after a successful defusaltrue
Config.ReturnDefusedBombWhen the option above is on: true gives defused_bomb, false gives car_bombfalse
OptionWhat it doesDefault
Config.BombBeepEnabledA planted bomb beeps for anyone within 5 m of the vehicletrue
OptionWhat it doesDefault
Config.WebhookEnabledSend Discord messagestrue
Config.WebhookURLYour Discord webhookYOUR_WEBHOOK_HERE

A message is sent when a bomb is detonated, defused (the timed defusal), when a plant fails the C4 game, and when a defusal fails the C4 game. Each one names the player who planted the bomb — their name, framework identifier, Discord, Steam and licence identifiers — with the plate, the coordinates and the reason.


These are fixed in the scripts and are not in config.lua.

HoldingKeyWhat it does
The bombEPlant it on the nearest vehicle in range
The bomb or the toolboxLeft or right mousePut it away without doing anything
The toolboxEStart defusing the nearest bombed vehicle in range
Any of the itemsUse it againPut it away

On the detonator phone:

KeyWhat it does
↑ / ↓Pick a bomb
GreenDetonate the selected bomb now, or confirm a countdown
StopwatchStart typing a countdown, in seconds, on the number keys
←Delete the last digit
HomeLeave countdown entry
RedLeave countdown entry, or close the phone
Esc / BackspaceClose the phone

A bomb on a countdown shows the seconds left next to it in the list.

Five lights show a sequence of red, blue, green and yellow. When it says REPEAT SEQUENCE, click the buttons in the same order. One wrong colour — or pressing Esc during the game — counts as a failure, and the vehicle explodes.


There is no locale file. The on-screen text (the phone, the minigame and the blip name) is English and lives in the escrowed and UI files, not in config.lua.