Smoke Bunker

Smoke Bunker configuration

Every option in Smoke Bunker's open config files, with its default and what it does.

The options live in four Lua files under config. Restart smoke_bunker after a change.

FileHolds
config/shared/config.luaSites, interior positions, economy, missions, raids, storage, workshop. Client and server read it.
config/shared/catalog.luaWorkshop recipes, blueprint items.
config/client/config.luaInteract, text UI and clothing providers, blips, hatch, drive-in, delivery ped, cutscene.
config/server/config.luaAdmin groups, command names, loop intervals, rate limit, terminal distance, logger.

bridge/**/*.lua, config/**/*.lua, types.lua and install/*.lua (item files) are under escrow_ignore, so they stay editable under Cfx.re Asset Escrow. Integrations covers the bridge files.

Positions are vec3 or vec4. Distances are in metres, times in seconds unless the name ends in Ms, Min, Minutes, Hours or Days, money in dollars. Interior positions are GTA Online bunker coordinates, moved to every site; get them with /bunkercoords (admin) inside any bunker.

Server config#

config/server/config.lua

OptionDefaultWhat it does
adminGroups{ 'admin', 'god' }Groups allowed to use /bunkeradmin, /bunkerui, /bunkermission, /bunkercoords. Framework group matching: Commands.
commands.admin'bunkeradmin'Admin command name.
commands.ui'bunkerui'Debug screen command name. Only while debug = true.
sim.tickSeconds5Timer loop interval.
sim.viewerPushSeconds15Push interval to open terminals.
sim.saveSeconds30Save interval for changed bunkers.
sim.pruneLogsOnStarttrueDelete log rows older than logs.retainDays at start.
rateLimit.windowMs1000Rate-limit window, per player and request type.
rateLimit.maxRequests8Requests per window.
terminal.requireNearChairtrueTerminal actions need player near boss chair in their bunker.
terminal.maxDistance8.0Max chair distance, metres.
logger.enabledfalseSend logs to Discord webhook or ox_lib logger.
logger.type'discord''ox' or 'discord'; any other value warns and turns logging off.
logger.discordWebhook''Webhook URL used when category has none.
logger.webhooksevery key ''Optional URL per category: MONEY, PRODUCTION, RESEARCH, SECURITY, RAID, STAFF, default. Blank falls back to default, then discordWebhook. STORAGE has no key and uses that fallback.

Client config#

config/client/config.lua

OptionDefaultWhat it does
commands.coords'bunkercoords'Admin command name that copies your coordinates.
interact'auto''auto', 'ox_target', 'qb-target' or 'textui'. 'auto' uses first running of ox_target, qb-target, else text prompt.
textUI'auto'Prompt resource. 'auto' and 'ox_lib' use ox_lib; 'qb' uses qb-core, 'okok' okokTextUI, 'jg' jg-textui.
clothing'auto'Personal Quarters wardrobe resource: 'auto' (first running of the rest, in order), 'illenium-appearance', 'fivem-appearance', 'qb-clothing' or 'esx_skin'.
interactDistance2.0Default interact point radius.
blips.forSale{ enabled = true, sprite = 557, color = 4, scale = 0.7, label = 'Bunker For Sale' }Blip of each bunker for sale. enabled = false hides it.
blips.owned{ enabled = true, sprite = 557, color = 2, scale = 0.8, label = 'Your Bunker' }Blip of your own bunker, same fields.
door.renderDistance150.0Hatch prop exists within this distance.
door.openSeconds6.5Hatch open and close time.
door.easing'smoothstep''smoothstep' or 'linear'.
door.openDegrees20Open pose: closed rot.y minus this. Negative tilts other way.
door.sound{ bank = 'DLC_GR_Bunker_Door_Sounds', open = 'Door_Open_Long', limit = 'Door_Open_Limit', hearDistance = 60.0 }Hatch sounds from bank, heard within hearDistance: open at start, limit at stop.
driveIn{ speed = 5.0, timeoutMs = 12000, stopDistance = 4.0 }Delivery trucks drive to config.sites[].door at speed until within stopDistance or after timeoutMs.
deliveryPed{ sale = 's_m_m_highsec_01', scenario = 'WORLD_HUMAN_CLIPBOARD', sideOffset = 4.0, spawnDistance = 80.0 }Ped at every sale drop-off, local and export. scenario is nil for none; stands sideOffset right of spot, spawns within spawnDistance.
cutscene{ name = 'BUNK_INT', flagsDefault = 501, flagsGunRange = 493, skipControl = 38, maxSeconds = 120 }First walk-in intro; needs entry.introCutscene. flagsGunRange replaces flagsDefault in bunkers with Shooting Range. skipControl skips it and sale cutscene (38 is E); stops after maxSeconds.
fadeMs1200Screen fade length.

Jobs in blipRestrictions.hiddenForJobs see neither blip.

Shared config#

config/shared/config.lua

General#

OptionDefaultWhat it does
debugfalseAdmin test tools: simulate-raid and breach buttons, /bunkerui.
debugPrintsfalseVerbose console logs. Errors and warnings always print.
language'en'File name in locales/. See Language.
inventoryImagePath'nui://ox_inventory/web/images/%s.png'Item icon source; %s is item name. Copy install/image/ PNGs into your inventory's image folder and, if not ox_inventory, point this path there. Missing icon shows label's first two letters.

Ownership and entry#

OptionDefaultWhat it does
ownership.oneBunkerPerCharactertrueOne bunker org per character.
ownership.keypadDigits4Keypad code length.
ownership.keypadAttempts3Wrong codes before lockout.
ownership.keypadLockoutSeconds60Lockout length.
ownership.startingBalance0Starting org funds.
ownership.startingSupplies50Starting supplies.
entry.checkMs1000Access check interval; anyone inside without access returns to entrance.
entry.groupEnabledtrueOffer solo or group entry when others are close.
entry.groupRadius8.0Players this close are offered group entry.
entry.groupMax8Max people per entry, you included.
entry.groupConsenttrueNearby players must accept first.
entry.groupConsentSeconds15Seconds to answer.
entry.passSeconds120Seconds a guest or group member has to walk the tunnel.
entry.doorOpenSeconds90Hatch open time after keypad, raid breach or delivery truck opens it; new opening restarts it.
entry.introCutscenetrueIntro cutscene on first walk-in after buying.
blipRestrictions.hiddenForJobs{ 'police', 'sheriff', 'bcso', 'sasp', 'lspd', 'state', 'fib', 'ranger' }Jobs or groups that never see bunker blips.
keypad.renderDistance40.0Keypad prop spawn distance.
keypad.useDistance1.5Keypad use distance, also reach of its raid hack and C4 points.
keypad.onOpennilFunction run when keypad camera starts, e.g. to hide your HUD.
keypad.onClosenilFunction run when keypad camera ends.

Gang mode and org#

When a gang buys a bunker, every gang member is added and kept in sync.

OptionDefaultWhat it does
gangMode.enabledfalseTurns gang purchases on.
gangMode.minBuyGrade3Lowest grade that can buy for gang.
gangMode.resyncMinutes10Minutes between full resyncs; gang changes and player loads also sync.
gangMode.esxGangJobs{}ESX job names that count as gangs, e.g. { 'vagos', 'ballas' }.
gangMode.defaultRole'MEMBER'Role for grades below first gradeRoles entry.
gangMode.gradeRoles{ minGrade = 0, role = 'PROSPECT' }, { minGrade = 1, role = 'MEMBER' }, { minGrade = 3, role = 'OFFICER' }Grade to org role: highest minGrade at or below member's grade wins. Buyer is always OWNER.
gangMode.rolePermsOFFICER has SELL, RAID, RESEARCH. MEMBER has SELL. PROSPECT has none.Permissions a synced member gets when added and when a grade change gives another role. Owner can edit them in between.
org.perms{ 'SELL', 'RAID', 'RESEARCH', 'WITHDRAW' }Permissions that exist. OWNER always has all.
org.rolePermsSame values as gangMode.rolePermsPermissions for hand-assigned role, and for previous owner who becomes OFFICER on transfer.
org.maxMembers20Max org members.
org.inviteDistance5.0Max distance to player you invite.

Ownership lifecycle and police alerts#

OptionDefaultWhat it does
lifecycle.sellRefundPct60Percent of site price paid to owner on sale.
lifecycle.payoutBalancetrueAlso pay org balance to owner on sale.
lifecycle.requireEmptyStashtrueSelling or abandoning needs empty stash.
lifecycle.gangOwnerFallbacktrueGang bunkers: ownership moves to best gang member when owner leaves gang.
lifecycle.upkeep{ enabled = true, perDay = 2000, graceDays = 3 }Daily org-funds fee: perDay plus each bought upgrade's dailyFee. Unpaid days past graceDays repossess bunker.
dispatch.enabledtruePolice alerts on. Sent to online players whose job is in dispatch.jobs and to cd_dispatch when running.
dispatch.jobs{ 'police', 'sheriff', 'bcso', 'sasp', 'lspd', 'state', 'fib', 'ranger' }Jobs that receive alerts.
dispatch.blipSeconds90Seconds the alert blip stays.
dispatch.onRaidBreachtrueAlert when raiders breach bunker.
dispatch.onHighRiskMissiontrueAlert when high-risk mission becomes tracked.
perksSee belowWhat each feature needs.

Each perk names the upgrade or custom it needs. Other scripts read perks with exports.smoke_bunker:getPerks and hasPerk.

PerkNeedsUnlocks
workshop, exportContracts, garageEquipment upgradeWorkshop, export contracts, armored sale vehicle
blastDoorsSecurity upgradeBlast doors: officers seal or open them in terminal; they seal when raid is launched on bunker.
range, locker, quarters, caddySame-name customizationShooting range, gun locker, Personal Quarters, caddy

Sites#

sites has one entry per bunker (11):

keylabelpricestyle
chumashChumash Facility1450000Bunker_Style_A
senora_wGrand Senora West1050000Bunker_Style_B
senora_eGrand Senora East1100000Bunker_Style_C
harmonyHarmony Facility1200000Bunker_Style_A
route68Route 68 Facility950000Bunker_Style_B
tongvaTongva Facility1350000Bunker_Style_C
grapeseedGrapeseed Facility1000000Bunker_Style_A
palmerPalmer-Taylor Facility1250000Bunker_Style_B
paletoPaleto Facility1500000Bunker_Style_C
zancudo_nZancudo North Facility900000Bunker_Style_A
zancudo_sLago Zancudo Facility1150000Bunker_Style_B
FieldWhat it does
keySite id, used in /bunkeradmin site <key>.
labelSite name in game.
pricePurchase price.
styleInterior look before purchase, and starting style after.

Position fields, matching the map in stream:

FieldWhat it is
mloInterior position and heading from its ymap. Do not change unless you edit the map.
doorSurface tunnel door.
entranceSpot in front of door.
hatchMoving hatch part: closed-pose coords and rot, and its model.
keypadOutside wall keypad: prop coords and rot. Opens the hatch and walks you in.
exitKeypadInside keypad: coords and rot. Only opens the hatch.
blipBlip position.

Interior#

Some positions are placeholders: check each in game with /bunkercoords.

OptionDefaultWhat it does
interior.referencevec4(938.3077, -3196.1116, -100.0, 180.0)Placement of the GTA Online interior gr_grdlc_int_02. Do not change.
interior.boundsmin = vec3(826.0, -3267.0, -104.0), max = vec3(1039.0, -3064.0, -88.0)Inside-bunker box: hall, range, lower tunnel.
interior.applyDistance220.0Entity sets and props apply within this distance of interior.
interior.coordsvec3(899.5518, -3246.038, -98.04907)Hall point used to find interior.
interior.spawnvec4(885.982, -3245.716, -98.278, 90.0)Spawn after the intro cutscene or waking up.
interior.desk.chairvec4(908.670, -3206.994, -97.500, 10.022)Boss chair: terminal opens here, raiders hack laptop here.
interior.desk.chairModel'sm_prop_smug_offchair_01a'Desk chair prop.
interior.desk.animDict'anim@amb@clubhouse@boss@male@'Sit and stand animations.
interior.desk.maxDistance6.0Terminal closes beyond this plus 2 m from chair; also chair range for stash.
interior.gunLockervec3(896.60, -3217.40, -98.20)Personal weapon locker.
interior.workshopvec3(904.50, -3214.50, -98.28)Workshop machine.
interior.workshopRadius2.5Workshop machine radius; screen stays open up to this plus 1 m.
interior.caddyvec4(890.50, -3238.20, -98.28, 90.0)Shared caddy parking spot while anyone is inside.
interior.caddyRespawnSeconds30Seconds between caddy checks; wrecked or missing caddy respawns.
interior.missionCabvec4(878.00, -3245.50, -97.80, 270.0)Phantom cab wait spot for large supply runs.
interior.supplyDropvec4(896.50, -3241.00, -98.28, 90.0)Supply run parking spot.
interior.quarterswardrobe = vec3(904.90, -3201.20, -97.20), bed = vec3(906.70, -3198.80, -97.20)Personal Quarters wardrobe and bed.
interior.camProp'prop_cctv_cam_01a'Working camera prop; shooting it breaks camera.
interior.camHits3Weapon or melee hits that break camera prop.
interior.camRepairseconds = 8, distance = 3.0, anim = { dict = 'amb@prop_human_movie_bulb@idle_a', clip = 'idle_b', flag = 1 }Camera repair takes seconds, plays anim, uses one storage.cameraPartItem from you or the stash. distance includes height.
interior.camView{ sensitivity = 3.0, maxYaw = 60.0, maxPitch = 30.0 }Feed mouse look; maxYaw and maxPitch limit sideways and up/down turn.
interior.camsFour camerasid and zone: CAM-01 ENTRY RAMP, CAM-02 LOADING BAY, CAM-03 LAB WING, CAM-04 PERIMETER. coords, rot, fov set the view. Bunker has first upgrades.security.baseCams cameras, upgrades.security.cams with Security upgrade.
interior.setsA list of rulesEntity set rules: set is active when its when is met (or absent) and its unless is not. A condition is upgrade, { upgrade = 'equipment', min = 2 }, or customization, { custom = 'quarters' }.
interior.styles{ 'Bunker_Style_A', 'Bunker_Style_B', 'Bunker_Style_C' }Interior looks.

The shooting range is under interior.range:

OptionDefaultWhat it does
range.startvec3(899.00, -3170.50, -97.10)Mode and shooting spot. Placeholder.
range.radius2.0Radius around start spot.
range.boardvec3(901.50, -3170.50, -97.10)Scoreboard spot.
range.boardSize10Rows per leaderboard.
range.keepPerPlayer50Stored runs per player. Older runs are deleted.
range.gapMs400Pause between two targets of one lane.
range.comboStep, range.comboMax0.1, 2.0Each consecutive hit adds comboStep to score multiplier, up to comboMax. No combo in precision.
range.modespopup 60 s, moving 60 s, precision 45 s with 20 hits at mostModes with label (Pop-up, Moving, Precision) and length in seconds. shots caps precision hits.
range.difficultySee belowFour difficulty levels.
range.popupModel gr_prop_gr_target_04a and 12 pointsWhere pop-up targets appear.
range.railsModel gr_prop_gr_target_04b and 3 lanesMoving targets slide between each lane's from and to.
range.precisionModel prop_target_comp_wood and 3 pointsBullseye spots. Heading 0 faces shooters for this model.
range.zonesHEAD 100, TORSO 50 and LIMB 25 for both box targets. Rings R1 10, R2 5 and R3 2 for the bullseye.Hit zones per target model, in its own space, with points. First match wins.
range.headZones{ HEAD = true, R1 = true }Zones that count as headshots or bullseyes.

Target positions and zone sizes are placeholders: shoot a target with debug on and tune them.

Difficultywindow (ms a target stays up, moving targets x2)speed (rail metres per second)mult (score multiplier)
easy20001.01.0
normal12001.81.5
hard7002.82.0
insane3504.03.0

Each level also has a label and an order (list position).

Upgrades and customizations#

Upgrades are bought once; effects add up. Decimal values are fractions: 0.30 is +30%. An optional image = 'https://...' (or nui:// URL) on an upgrade or customization replaces the icon.

UpgradepricedailyFeeNumbers
upgrades.equipment1155000800production = 0.30, research = 0.25, value = 0.10 (stock value), drain = -0.25 (supply drain).
upgrades.staff5985001000production = 0.20, research = 0.25, value = 0.05 (stock value).
upgrades.security351000700hold = 0.25 (raid defence), cams = 4 (with the upgrade), baseCams = 2 (without).

Each upgrade and customization also has an effects list (its card lines).

Customizations are bought one option at a time; switching pays that option's price. set is the interior style an option applies, model the caddy's vehicle.

CustomizationOptions and priceWhat it gives
customizations.styleStyle 1 0 (Bunker_Style_A), Style 2 215000 (Bunker_Style_B), Style 3 290000 (Bunker_Style_C)Interior look, changeable any time.
customizations.quarters265000Personal Quarters: office, sleeping area, wardrobe, bed.
customizations.rangeBlack 740000, White 845000Firing range and target challenge with best score.
customizations.locker175000Personal weapon locker per member.
customizations.caddyCaddy 85000 (caddy2), Bunker Caddy 120000 (caddy3)Caddy to drive around bunker.

Supplies, stock and production#

OptionDefaultWhat it does
supplies.max100Max supplies held.
supplies.drainPerHour4.2Supplies used per hour while producing, times active line's supplyMult.
supplies.researchDrainPerHour1.8Extra supplies per hour per active research project.
supplies.tiers{ units = 25, price = 15000 }, { units = 50, price = 28000 }, { units = 100, price = 50000 }Supply orders: units delivered for price.
stock.defaultLine'ammo'Line new bunker produces.
stock.order{ 'ammo', 'parts', 'precision', 'heavy' }Terminal order of stock types.
production.baseUnitsPerHour2.0Units per hour with no Production staff.
production.perStaffUnitsPerHour2.4Units per hour per Production operative, scaled by their efficiency.
production.localSeconds30Timer-mode delivery time of local buyer sale.
production.exportSeconds45Timer-mode delivery time of export contract.
production.exportMinOnline2Org members who must be online to send export.
production.exportHijackChance0.18Chance export is hijacked in timer mode.
production.maxCatchupHoursCode default 168. Not in the shipped file.Max elapsed time worked out when nobody has touched bunker. Add key to change it. 0 removes limit.

stock.types sets the four lines: requires is the upgrade a type needs, speed multiplies production, supplyMult supply drain, cap max units, local and export unit prices before reputation and upgrade bonuses, cargo max units per sale mission.

Fieldammopartsprecisionheavy
labelAmmunitionWeapon PartsPrecision ComponentsHeavy Ordnance
requiresNoneequipmentstaffsecurity
speed1.21.00.80.6
supplyMult0.81.01.31.6
cap250200150100
local2400320044006000
export3100415057007800
cargo250200150100

Missions#

The controller is the player who started a mission; if they go offline, another online participant takes over. Default coordinates are starting points: check them with /bunkermission preview <zone|dropoff> <id|index> [spawnIndex].

OptionDefaultWhat it does
missions.mode'world''world' runs vehicle missions, 'timer' countdown with no vehicle.
missions.orderMode'truck''truck': ordering supplies starts pickup mission. 'instant': supplies arrive at once.
missions.externalRunsfalseTimer mode only. true: timer never completes supply run itself; call exports.smoke_bunker:finishSupplyRun.
missions.rerollCooldownSeconds20Cooldown for showing next missions.list job.
missions.blueprintDropChance0.5Chance finished supply run adds blueprintDrop to bunker's blueprints.
missions.blueprintDrop'Turret Servo Schematic'Research blueprint supply run can drop.
missions.blueprintItemDropChance0.25Chance finished supply run or settled sale also drops bp_* item into main stash.
missions.blueprintDropWeights{ ammo = 0, parts = 50, precision = 35, heavy = 15 }Weights of stock tier dropped bp_* item comes from; only unlocked tiers count.
missions.spawnDistance250.0Vehicle and guards spawn when controller is this close.
missions.approachEveryMs2000Controller client's vehicle request interval near pickup.
missions.foundDistance90.0Distance at which missions.list job counts as found.
missions.deadlineSeconds{ order = 1200, source = 1800, sale = 1500 }Time limit per mission kind: order truck supply order, source missions.list job, sale sale.
missions.controllerTimeoutSeconds60Mission fails when controller is offline this long and nobody can take over.
missions.abandonSeconds150Mission fails when no participant is near vehicle this long.
missions.abandonRadius400.0Radius that counts as near vehicle.
missions.deliver{ radius = 12.0, maxSpeed = 4.0, driveInSeconds = 45, hitchDistance = 15.0, doorRadius = 30.0 }Delivered when truck is within radius of target and slower than maxSpeed (m/s). Trailer run also needs cab within hitchDistance of trailer. Hatch stays open while truck is within doorRadius of entrance. driveInSeconds ends unload when no client reports back.
missions.refundOnFail{ order = true }Failed supply order refunds its price.
missions.orderVehicle{ 'supply', 'supply', 'supplyTrailer' }Vehicle per supply tier: index matches supplies.tiers, value is missions.vehicles key.
missions.orderZone{ 'city', 'city', 'docks' }Zone per supply tier; random spot of it is pickup.
missions.vehiclessupply = mule3, supplyTrailer = phantom with trailers2, sale = mule3, saleArmored = boxville5Vehicle models. supplyTrailer cab waits inside bunker (cabInBunker = true); saleArmored is for sales by bunkers with garage perk.
missions.zonesPools city, docks, guardedSpot pools with id, label, spawns. city: Mule pickups and sale drop-offs. docks: open lots for trailers. guarded: spots with their own guard positions (peds). One random spot per run. Map shows only radius circle with spot inside.
missions.cutscene{ name = 'hs4f_drp_off', entity = 'MP_1', maxSeconds = 90, skippable = true }Driver cutscene at sale's drop-off. entity is driver's role; stops after maxSeconds. skippable = true lets driver skip it with client cutscene.skipControl (E). Alternatives: hs4f_drp_cel, hs4_bch_end, tunf_drp_hand; preview with /bunkermission cutscene <name>.

missions.reveal sets which missions are tracked:

OptionDefaultWhat it does
reveal.delaySeconds30Seconds after start before tracking begins.
reveal.intervalSeconds5Seconds between blip updates. Sales use saleCircle.intervalSeconds.
reveal.risks{ HIGH = true }Risk levels that are tracked.
reveal.jobs{ 'police', 'sheriff', 'bcso', 'sasp', 'lspd', 'state', 'fib', 'ranger' }Jobs that see tracking.
reveal.otherOrgstrueMembers of other orgs see it too.
reveal.saleCircle{ radius = 300.0, intervalSeconds = 60 }Sales show radius search circle with truck somewhere inside, refreshed every intervalSeconds and moved only when truck leaves it.

missions.list holds the three jobs:

FieldJob 1Job 2Job 3
nameHIJACK CONVOYRAID LOCKUPSKIM AIRDROP
locationLOS SANTOSLS PORT & AIRPORTLOS SANTOS
riskMEDHIGHLOW
units507535
vehiclesupplysupplyTrailersupply
zoneguardeddockscity
crewMULE / 2 CREWPHANTOM + TRAILER / 3 CREWMULE / SOLO
seconds456030
FieldWhat it does
name, locationJob name and place in terminal.
riskLOW, MED or HIGH. Sets the guards (guards.byRisk), reinforcement chance and map tracking (reveal.risks).
unitsSupplies delivered.
vehicleKey of missions.vehicles.
zoneid of missions.zones pool; random spot of it is pickup.
crewVehicle and crew text on job card.
secondsTimer-mode countdown.

missions.guards sets the NPC guards of a missions.list job:

OptionDefaultWhat it does
guards.models's_m_y_blackops_01', 's_m_y_blackops_02', 'g_m_y_mexgoon_01'Ped models, one at random per guard.
guards.weapons'WEAPON_CARBINERIFLE', 'WEAPON_PISTOL', 'WEAPON_SMG'Weapons, one at random per guard.
guards.byRisk{ LOW = { 0, 0 }, MED = { 3, 5 }, HIGH = { 6, 9 } }Min and max guards per risk.
guards.accuracy, guards.health, guards.armour35, 220, 50Accuracy, health, armour of each guard.
guards.alertDistance40.0Distance at which guards notice you.
guards.reinforcementchance = { LOW = 0.0, MED = 0.25, HIGH = 0.6 }, vehicle = 'baller2', peds = 3, spawnDistance = 250.0When first guard dies, chance (by risk) decides if vehicle with peds more guards arrives, on road about spawnDistance from spot.

missions.sale sets sales:

OptionDefaultWhat it does
sale.minDistance1200.0Drop-off is at least this far from bunker.
sale.risk{ ['local'] = 'LOW', export = 'HIGH' }Risk per kind of sale.
sale.dropoffZone'city'Random spot of this zone is drop-off.
sale.dropoffRadius14.0Drop-off area size.
sale.chase{ delaySeconds = 45, vehicles = { LOW = 0, MED = 1, HIGH = 2 }, model = 'baller2', pedsPerVehicle = 3 }Chase cars sent delaySeconds into delivery; vehicles sets how many by risk, each model car carries pedsPerVehicle peds.
sale.hijackable{ ['local'] = false, export = true }Which sales rival org can steal. Member of another org who drives truck into their own bunker banks cargo and takes reputation.hijackDelta from seller. Hijackable sale ignores controllerTimeoutSeconds and abandonSeconds; fails only on timeout or destroyed truck.

Crews#

OptionDefaultWhat it does
group.requiredForMissionsfalsetrue: missions need crew. false: crew optional; without one every online org member takes part.
group.maxMembers6Max crew members.
group.rejoinSeconds300Disconnected member keeps their place this long.
group.inviteSeconds60Crew invite lifetime.
group.command'crew'Crew panel command.
group.hudKey'G'Key that shows or hides task list.
group.hudModifier19Control held with hudKey: 19 is left ALT, false the key alone.
group.hudCommand'taskhud'Command to move task list.
group.keynile.g. 'F6' adds crew panel key mapping players can rebind.

Research#

OptionDefaultWhat it does
research.staffSpeedBonus0.25Research speed added per Research operative.
research.baseSlots1Concurrent projects.
research.staffSlots2Slots with Staff upgrade.
research.startingBlueprints{ { name = 'MK2 Suppressor Schematic', qty = 1 } }Starting blueprints.
research.projectsSix projectsSee below.

hours is the duration with no Research staff. fast is the org-funds price to finish a running project at once. A blueprint project uses one of that blueprint when it starts. startsDone = true: a new bunker already has it. unlocks lists the items on its card; recipes open through their own unlockedBy or blueprint, not this list.

idnamehoursfastblueprintunlocks
r1MK II Barrel Rifling360NoneNone. startsDone.
r2Ballistic Armor Plating360Nonearmor_plate. startsDone.
r3Explosive Rounds9685000Noneammo_explosive
r4MK2 Suppressor7260000MK2 Suppressor Schematicsuppressor
r5Turret Servo Mod7270000Turret Servo Schematicturret_servo
r6Gas Mask Filter Variant4845000Filtration Schematicgasmask

Each project also has desc and enables card lines.

Staff#

OptionDefaultWhat it does
staff.wageCycleMinutes60Wage cycle length. Unpaid wages pause production and research.
staff.severanceHours8Dismissal costs hourly wage times this, from org funds.
staff.maxStaff8Max operatives per bunker.
staff.rehireFeeHours60Rehire fee: hourly wage times this.
staff.feeHours55Hire fee: hourly wage times this.
staff.candidateCount3Candidates offered at once.
staff.candidateRefreshHours6Hours between candidate refreshes.
staff.roles{ 'Production', 'Research', 'Guard' }Staff roles.
staff.startingSTF-1042 Marcus Vela (Production, wage = 220, eff = 91) and STF-1188 Dana Roth (Production, wage = 180, eff = 84)Operatives every new bunker starts with.
staff.firstNames, staff.lastNamesTwo lists of 16 namesCandidate name pools.
staff.wageRange{ Production = { 160, 260 }, Research = { 220, 340 }, Guard = { 120, 190 } }Candidate hourly wage by role.
staff.effRange{ 68, 99 }Candidate efficiency, percent.
staff.renderDistance40.0Staff peds exist within this distance of player inside.
staff.modelsProduction = 'mp_m_waremech_01', Research = 's_m_m_scientist_01', Guard = 's_m_y_blackops_01'Ped model per role.
staff.spotsA list of positions for each roleWork spots, filled in hire order. A machine is lathe, drill or mill (bunker machine), assemble_guns or load_clips (office chair) or weapon_test; with none ped stands guard with rifle. Give every role maxStaff spots so every hire is on floor.
staff.idleEverySeconds{ 8, 20 }Random idle animation interval.

staff.guard sets guard operatives, who fight from their post in a raid and never leave it.

OptionDefaultWhat it does
guard.postRadius2.5Distance guard may leave post for cover.
guard.engageRange60.0Raiders this close are attacked.
guard.accuracy, guard.health45, 200Accuracy and health of each guard operative.
guard.grenadeEverySeconds20Guard with grenades throws one this often.
guard.grenadeRange{ 8.0, 30.0 }Guard throws at raider in sight this far away.
guard.kitThree tracks of three tiersRaid kit, bought per guard tier by tier. Tier 1 is what every hire has.
TrackTier 1Tier 2Tier 3
weaponCarbine Rifle, 0Special Carbine MK2, 45000Combat MG MK2, 95000
armorNo Vest, 0Light Vest (armour 50), 20000Heavy Armor (armour 100), 50000
grenadesNo Grenades, 02 Grenades, 150004 Grenades, 30000

Each cell is the tier's label and price. weapon tiers set weapon (a ped weapon name), armor tiers armour, grenades tiers grenade count.

Reputation#

Reputation runs 0 to 100. A tier starts at min, bonus is the percent added to unit prices, note is its card line.

reputation.tiers nameminbonusnote
UNKNOWN00NO STANDING · BASE PRICES ONLY
KNOWN304BUYERS DEAL BUT HAGGLE
TRUSTED608BUYERS PAY A PREMIUM AND WAIT LONGER
PREFERRED8512BUYERS CALL YOU FIRST · PRIORITY CONTRACTS
OptionDefaultWhat it does
reputation.start0Starting reputation.
reputation.localDelta4Change after clean local sale.
reputation.exportDelta6Change after clean export.
reputation.hijackDelta-10Change when sale is lost: full value for export, half for local sale. Rival who banks hijacked sale gains the same.

Raids#

OptionDefaultWhat it does
raid.threshold70Bunker shows on other orgs' radar only while stock is above this percent of cap.
raid.minOnline2Org members who must be online to launch raid.
raid.gearCost45000Org funds spent to launch raid; refunded if restart or error cancels it.
raid.incomingSeconds45Length of simulated inbound raid. Debug tools only.
raid.cooldownSeconds1800Cooldown per attacker and target pair after raid.
raid.stolenFraction0.35Share of every stock type taken in successful raid.
raid.cashPerUnitMultiplier3Haul cash: stolen units times their stock type's local price times this.
raid.holdBase, raid.holdPerGuard, raid.holdBlastSealed, raid.holdPerCamDown0.30, 0.20, 0.15, -0.05Defence rating on radar: holdBase plus holdPerGuard per Guard operative, holdBlastSealed while blast doors are sealed, holdPerCamDown per broken camera, plus upgrades.security.hold.
raid.holdMin, raid.holdMax0.10, 0.90Defence rating limits.
raid.defenceLabelsNONE up to 0.30, LIGHT up to 0.50, MODERATE up to 0.70, HEAVY up to 1.0Rating labels.
raid.approachSeconds900Time to reach and breach target after launch.
raid.assaultSeconds600Time from first breach to finish hack.
raid.hackSeconds45Seconds hacker must survive next to laptop without break.
raid.hackRadius3.0Max hacker distance from laptop.
raid.deadHealth105Health at or below this counts as dead; hack resets.
raid.passSeconds900Raider entry pass validity.
raid.tileBase'https://wasabirobby.github.io/MAP/GTA-MAP-PNG/SAT/{z}/{x}/{y}.webp'Map tile URL for Acquire and Raid Radar maps (zoom 2 to 5). Empty turns tiles off and shows map notice.
raid.world{ x1 = -5744.4, x2 = 6792.4, y1 = 8307.7, y2 = -4000.0 }World corners of tile set.

raid.breach sets how raiders get through the entrance keypad:

OptionDefaultWhat it does
breach.hackItem'bunker_hackdevice'Item needed to hack keypad.
breach.consumeHackItemfalsetrue uses device up on every attempt.
breach.hackDifficulty{ 'easy', 'easy', 'medium' }ox_lib skill check rounds.
breach.hackSealedDifficulty{ 'easy', 'medium', 'medium', 'hard' }Rounds when blast doors are sealed (Security upgrade).
breach.hackKeys{ 'w', 'a', 's', 'd' }Skill check keys.
breach.hackMinSeconds2Hack result reported faster than this is refused.
breach.hackSecondsPerRound1.5Result faster than this per round is refused too.
breach.hackRetrySeconds60Cooldown for player after failed hack; owners get alarm.
breach.c4Item'bunker_c4'Used up when planted.
breach.c4FuseSeconds10Charge fuse.
breach.c4SealedExtraSeconds5Extra fuse with sealed blast doors.
breach.c4SafeRadius6.0Planter is warned to get this far away.

raid.guards sets the NPC guards inside a raided bunker, on top of the Guard operatives:

OptionDefaultWhat it does
guards.base2NPC guards at start.
guards.perGuardStaff0Extra NPC guards per Guard operative; 0 because operatives fight in person.
guards.perSecurityLevel1Extra NPC guards with Security upgrade.
guards.max8Max NPC guards.
guards.waveSeconds, guards.waveSize, guards.maxWaves120, 2, 2Every waveSeconds, waveSize more guards spawn if few are left, up to maxWaves waves.
guards.spawnsEight positionsSpawn points in reference coordinates. Placeholders: tune with /bunkercoords.

Marketplace and buyer terminals#

OptionDefaultWhat it does
market.feePct5Host fee percent, taken from seller's proceeds.
market.minUnit, market.maxUnit100, 5000000Min and max unit price of listing.
market.maxQty500Max items per listing.
market.maxListingsPerBunker20Max active listings per bunker.
market.qtyStep, market.unitStep5, 500Step of quantity and price buttons.
buyer.account'bank'Account dealer terminal buyer pays from: 'bank', 'cash' or 'money'.
buyer.maxDistance4.0Distance from terminal point to open it and buy.
buyer.allowAnywherefalsetrue needs no terminal point; use command or openBuyerTerminal export.
buyer.commandfalsee.g. 'bunkerbuyer' opens dealer terminal anywhere. Also needs allowAnywhere.
buyer.pointsLEGION SQUARE DEALER at vec4(195.17, -933.77, 30.69, 150.0), SANDY SHORES DEALER at vec4(1961.0, 3740.0, 32.34, 300.0)Dealer terminals. Positions are placeholders: check them in game.

Storage and placeable storage#

OptionDefaultWhat it does
storage.slots120Bunker stash slots.
storage.weight2000000Bunker stash capacity, grams.
storage.categoriesammo_rifle and armor_plate = 'MUNITIONS', blueprint_mk2 = 'BLUEPRINT', gasmask, thermite and lockpick_adv = 'GEAR', camera_part = 'PARTS', money_dirty = 'CASH', weaponPrefix = 'WEAPON_'Storage page category per item. Items starting with weaponPrefix are WEAPON, any other is MISC.
storage.itemValues{}Optional [item] = value: estimated unit value on Storage page. No value counts as 0.
storage.cameraPartItem'camera_part'Item used up to repair destroyed camera.
storage.lockerSlots, storage.lockerWeight30, 150000Each member's personal gun locker. Needs Gun Locker customization.
storage.ownUitruetrue: resource stash screen with rank rules, kits and allowances. false: inventory stash screen, which needs WITHDRAW permission.
storage.lockervec3(905.2, -3210.4, -98.2)Stash point inside bunker.
storage.uiDistance3.0Distance to stash point to use it. At terminal, interior.desk.maxDistance applies.
storage.playerMaxWeight120000Grams player may carry when taking from stash. false: no limit beyond inventory's own check.
storage.depositBlacklist{}[item] = true bars item from bunker.
storage.manageRole'OFFICER'Lowest role that edits withdraw ranks, caps, kits and allowances. Managers can also lift their own limits. 'OWNER' keeps officers limited.

storage.rules holds defaults copied into a bunker on the first use of its stash:

OptionDefaultWhat it does
rules.defaultRole'MEMBER'Lowest role that takes items of unlisted category freely.
rules.categoryRole{ WEAPON = 'OFFICER', BLUEPRINT = 'OFFICER', CASH = 'OFFICER' }Lowest role per category.
rules.dailyCap{ OFFICER = 100, MEMBER = 20, PROSPECT = 0 }Items role takes freely per day. -1 is unlimited. Owner is always unlimited.
rules.kitsGUARD KIT (id guard): minRole = 'MEMBER', cooldownMin = 60, 2 armor_plate and 2 ammo_rifleItem kits taken in one go. minRole is lowest role that can take one, cooldownMin minutes before member can retake it.
rules.allowances{}[identifier] = { { name, count } }: what one player may take of item per day, before role and cap rules apply. Set on stash screen.

placeables sets extra stashes bought on the terminal's Storage page. Each arrives in the main stash as an item that places the stash when used. The item names must exist in your inventory (see install/items_*.lua).

OptionDefaultWhat it does
placeables.deliverySeconds600Time until bought item reaches main stash.
placeables.maxPerBunker8Placed stashes per bunker.
placeables.minSpacing1.0Min distance between placed stashes.
placeables.buyRole, placeables.pickupRole'OFFICER', 'OFFICER'Lowest role that buys one, and that picks one up. Contents go with item.
placeables.placeDistance10.0Max distance from player to placed spot.
placeables.raidLootPct{ 30, 60 }Raiders get each stack with chance in this range, rolled once per stash. Rest moves to main stash.
placeables.typesFour typesSee below.
placeables.rackpanel = { halfW, minZ, maxZ, faceY }, shelf = { halfW, yMin, yMax, z }, strips, spotBarGun rack geometry in rack-local metres. Must match model.
placeables.rack.gap, placeables.rack.overlapScale, placeables.rack.boundsScale0.0, 0.65, 0.6Min weapon spacing; footprint scales for overlap (lower packs tighter) and for keeping weapon inside panel or shelf.
placeables.rack.camera{ dist = 3.1, z = 1.0, fov = 50.0 }Rack screen camera.
placeables.rack.defaultLights{ accentOn = true, color = { 255, 24, 16 }, brightness = 0.6, spot = 'warm' }Starting rack lights: accent strips on or off, RGB colour, brightness, spotlight ('warm', 'led' or 'off').
placeables.rack.spotColorswarm = { 255, 186, 120 }, led = { 214, 230, 255 }RGB per spotlight type.
placeables.rack.wallWeapons, placeables.rack.shelfWeapons45 and 10 weapon item namesWeapons that hang on wall, and heavy weapons that go on shelf only.
placeables.types keylabelpriceslotsweightmax
crate_smallSupply Crate25000202000004
gun_caseGun Case60000151500002
containerStorage Container120000508000002
gun_rackGun Rack90000NoneNone2
FieldWhat it does
itemInventory item it arrives as: bunker_ plus type key (bunker_crate_small, bunker_gun_case, bunker_container, bunker_gun_rack).
priceTerminal price.
slots, weightStash size; weight is in grams.
maxMax of this type per bunker, counting ones not placed yet.
modelPlaced prop. Models are placeholders.

defaultRole is the lowest role that opens a newly placed stash, MEMBER when unset; gun_case sets 'OFFICER'. gun_rack sets rack = true: a wall rack that shows its weapons, has no stash and can be picked up only when empty.

Workshop and item names#

OptionDefaultWhat it does
workshop.slots{ equipment = 1, staff = 1 }Concurrent crafting jobs: Equipment upgrade opens workshop with one slot, Staff upgrade adds one.
workshop.maxQty10Max batches per job.
workshop.cancelRefundPct50Percent of inputs returned when running job is cancelled.
workshop.maxCargo250Max units of crafted good per sale mission.
workshop.recipesSeven bunker specialsCustom items: ammo_rifle, armor_plate, ammo_explosive, suppressor, turret_servo, gasmask, thermite. Fields below.
workshop.goodsSeven goodsItems sellable through sale mission or listing, with local and export unit prices before reputation bonus.
Recipe fieldWhat it does
idRecipe id; replaces catalog recipe with same id.
categoryWorkshop filter it is listed under.
stockTypeStock type used: key of stock.types.
inputsCost of one batch: stock units, raw items from bunker stash, optional money from org account.
outputitem and count one batch makes.
secondsCrafting time of one batch.
unlockedBy, blueprintResearch id or bp_* item that unlocks it. With neither, no unlock is needed.

Raw item names in workshop.recipes are QBCore and ESX style and must exist in your inventory. A recipe whose output, after itemNames mapping, does not exist there is skipped with a console warning.

itemNames maps the ox_inventory names recipes use to your inventory's names; names without an entry pass through. lowerWeapons = true lower-cases WEAPON_ names.

TableInventoryDefault
itemNames.oxox_inventory{}
itemNames.jaksamjaksam_inventory{}
itemNames.tgianntgiann-inventory{ lowerWeapons = true }
itemNames.qbqb-inventory, ps-inventory and codem-inventorylowerWeapons = true and a list mapping ammo names (['ammo-9'] = 'pistol_ammo') and attachment names (['at_suppressor_light'] = 'pistol_suppressor')
itemNames.oneone_inventory{ lowerWeapons = true }
itemNames.codemv2codem-inventoryv2{}
itemNames.wasabiwasabi_inventory{}

Logs#

OptionDefaultWhat it does
logs.retainDays14Log rows older than this are deleted at start if sim.pruneLogsOnStart is true.

Catalog#

config/shared/catalog.lua lists a workshop recipe for every ox_inventory firearm (no melee or novelty weapons), attachment, skin, ammo and throwable, using the recipe fields. A recipe is open when it is a starter or its blueprint (a bp_* item learned at the workshop) is known. A config.workshop.recipes recipe with the same id wins.

catalog.blueprints lists each bp_* blueprint item with its label, tier (stock tier of its recipes) and unlocks (recipe ids). Learning a blueprint uses up the item.

Language#

To add a language, copy locales/en.json to locales/<code>.json, translate the values and set language to the code.

The locale file holds notifications, error messages, log lines, interact prompts and the terminal's ui_ labels. Other terminal text, such as confirmation dialogs and the Upgrades, Workshop, Crew, Stash and Range screens, is English and not in the file.

locales/en.json is not under escrow_ignore.