Configuration

configs/main.lua

Debug

• Type: boolean
• Default: false
• Description: Enables debug mode. Sets minGroupSize to 4 and policeRequired to 0 for testing. Set to false before going live.

configs/missions.lua

Configuration for the Warehouse Robbery mission.

Mission.startItem

• Type: string
• Default: "warehouse_entry"
• Description: Item consumed from the player's inventory when they join the queue.

---

Mission.queueName

• Type: string
• Default: "warehouse-robbery"
• Description: Internal queue identifier used by prp-bridge.

---

Mission.policeRequired

• Type: number
• Default: 4 (debug: 0)
• Description: Minimum number of on-duty police officers required to start the mission.

---

Mission.minGroupSize

• Type: number
• Default: 0 (debug: 4)
• Description: Minimum number of group members required to queue.

---

Mission.timeToFinish

• Type: number
• Default: 60
• Description: Time limit in minutes to complete the warehouse heist before the mission fails.

---

Mission.concurrentJobs

• Type: number
• Default: 2
• Description: Maximum number of simultaneous active Warehouse Robbery missions server-wide.

---

Mission.cooldown

• Type: number
• Default: 1.5
• Description: Cooldown in hours applied to all group members after a mission ends.

---

Mission.forceEntitySet

• Type: string | nil
• Default: nil
• Description: Force a specific faction theme for every mission ("cartel", "mob", or "syndicate"). Set to nil to randomize.

---

Mission.Alert

• Type: table
• Description: Police dispatch configuration.

Field	Default	Description
chance	30	Percentage chance (0–100) a dispatch alert fires when the warehouse is breached
code	"10-90"	Dispatch code sent to police
jobs	{ "police" }	Job names that receive the alert
blip.duration	600	How long the map blip is visible (seconds)
blip.flashing	true	Whether the blip flashes on the police map

---

Mission.BaseItemsInSafeStash

• Type: table[]
• Default: { { "bandage", 18–25 } }
• Description: Items always present in the warehouse safe stash in addition to rolled loot. Each entry is { itemName, count }.

---

Mission.Other.Items

• Type: table
• Description: Item names used internally by the mission.

Field	Default	Description
fuse	"warehouse_fuse"	Item added to inventory when a fuse is collected
bomb	"warehouse_bomb"	Bomb item name
requiredFuses	4	Number of fuses consumed to unlock a gate

---

Mission.Other.GUARDS

• Type: table
• Description: Warehouse guard combat configuration. Health and armor are applied when each guard ped spawns.

Field	Default	Description
WEAPONS	assault rifle, carbine, combat PDW, heavy pistol, SMG	Weapon pool assigned randomly to each guard
HEALTH	300	Maximum and current health applied to each warehouse guard
ARMOR	100	Armor value applied to each warehouse guard

Adjust HEALTH and ARMOR to match your server's weapon damage balance.

---

Loot Tables (WarehouseCfg.loot)

Three separate loot pools are defined in configs/warehouse.lua:

Pool	Rolls	Location
case	2 per case	21 cases scattered throughout the warehouse
box	2 per box	19 boxes throughout the warehouse
safe	5 per safe	4 safes requiring a 3-digit combination code

Each pool has COMMON, RARE, EPIC, and LEGENDARY tiers. Edit the table sub-keys under each pool to add, remove, or adjust loot items and quantities.

configs/smuggling.lua

Configuration for the Ocean Run smuggling mission.

SmugglingMission.startItem

• Type: string
• Default: "ocean_run_entry"
• Description: Item consumed when joining the Ocean Run queue.

---

SmugglingMission.queueName

• Type: string
• Default: "ocean-run"
• Description: Internal queue identifier.

---

SmugglingMission.policeRequired

• Type: number
• Default: 0
• Description: Minimum on-duty police officers required to start.

---

SmugglingMission.minGroupSize

• Type: number
• Default: 0 (debug: 4)
• Description: Minimum group members required to queue.

---

SmugglingMission.timeToFinish

• Type: number
• Default: 60
• Description: Overall mission time limit in minutes.

---

SmugglingMission.concurrentJobs

• Type: number
• Default: 1
• Description: Maximum simultaneous active Ocean Run missions server-wide.

---

SmugglingMission.cooldown

• Type: number
• Default: 120
• Description: Cooldown in minutes applied to all group members after a mission ends.

---

SmugglingMission.UplinkTime

• Type: number
• Default: 5
• Description: Duration in minutes of the NAS upload / defense phase.

---

SmugglingMission.BoatModel

• Type: hash
• Default: `dinghy4`
• Description: Vehicle model spawned for the group at the marina contact location.

SmugglingMission.TruckModel

• Type: hash
• Default: `squaddie`
• Description: Truck model spawned at Cayo Perico for transport to the server facility.

SmugglingMission.DirtBikeModel

• Type: hash
• Default: `manchez3`
• Description: Two dirt bikes spawned alongside the truck at the island.

---

SmugglingMission.Other.Items

• Type: table
• Description: Item names used internally by the Ocean Run mission.

Field	Default	Description
nas	"smuggling_nas"	NAS device item placed on the table in the server facility
hdd	"smuggling_hdd"	Hard drive item extracted from server racks
requiredHDDs	4	Number of hard drives required before the upload can start

---

SmugglingMission.Other.GUARDS

• Type: table
• Description: Ocean Run guard combat configuration. Health and armor are applied when each guard ped spawns.

Field	Default	Description
ISLAND.HEALTH	200	Health applied to island facility guards
ISLAND.ARMOR	100	Armor applied to island facility guards
BOAT.HEALTH	300	Health applied to boat shooter guards at the marina
BOAT.ARMOR	100	Armor applied to boat shooter guards at the marina

Adjust these values to match your server's weapon damage balance. Boat driver guards are not given custom health or armor.

---

SmugglingMission.loot

• Type: table
• Description: Loot given to players when they open the reward crate after the upload completes.
  • rolls (number) - number of rolls (default 12)
  • lootTable - tiered pool (COMMON, RARE, EPIC, LEGENDARY)
  • guaranteedRarities - guaranteed minimums per tier (default: RARE = 1, EPIC = 1)

---

SmugglingMission.TestCommand

• Type: table
• Description: Admin test command configuration.

Field	Default	Description
enabled	false	Set to true to enable the test command
name	"test_smuggling"	Command name (without /)
restricted	"group.admin"	Ace permission required to use the command