Configuration
configs/main.lua
Debug
- Type:
boolean - Default:
false - Description: Enables debug mode. Sets
minGroupSizeto4andpoliceRequiredto0for testing. Set tofalsebefore 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 tonilto 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 |
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.loot
- Type:
table - Description: Loot given to players when they open the reward crate after the upload completes.
rolls(number) - number of rolls (default12)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 |