Skip to content

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.
FieldDefaultDescription
chance30Percentage 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.duration600How long the map blip is visible (seconds)
blip.flashingtrueWhether 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.
FieldDefaultDescription
fuse"warehouse_fuse"Item added to inventory when a fuse is collected
bomb"warehouse_bomb"Bomb item name
requiredFuses4Number of fuses consumed to unlock a gate

Loot Tables (WarehouseCfg.loot)

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

PoolRollsLocation
case2 per case21 cases scattered throughout the warehouse
box2 per box19 boxes throughout the warehouse
safe5 per safe4 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.
FieldDefaultDescription
nas"smuggling_nas"NAS device item placed on the table in the server facility
hdd"smuggling_hdd"Hard drive item extracted from server racks
requiredHDDs4Number of hard drives required before the upload can start

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.
FieldDefaultDescription
enabledfalseSet to true to enable the test command
name"test_smuggling"Command name (without /)
restricted"group.admin"Ace permission required to use the command