Configuration

Shared (config/main.lua)

Debug

• Type: boolean
• Default: false
• Description: Enables debug mode. When true, lowers CaptureSpeed and ContestSpeed to 1, sets PrepTime to 15 s, TimeForWin to 25 s, and minimalPlayersToStart to 2. Set to false before going live.

Client & Server (config/config.lua)

CaptureSpeed

• Type: number
• Default: 0.1 (debug: 1)
• Description: Progress added per 100 ms tick when one team is actively delivering to a point. At 0.1, a point takes approximately 16–17 seconds to fully capture.

ContestSpeed

• Type: number
• Default: 0.1 (debug: 1)
• Description: Progress removed per 100 ms tick when both teams have delivered to the same point (contested state).

PrepTime

• Type: number (seconds)
• Default: 300 (debug: 15)
• Description: Time in seconds given to players to reach their starting point before the race begins.

NeededToWin

• Type: number
• Default: 4
• Description: Number of points a team must fully capture to trigger the win countdown.

TimeForWin

• Type: number (seconds)
• Default: 120 (debug: 25)
• Description: How long a team must maintain their winning lead (≥ NeededToWin points captured) before the match ends and rewards are distributed.

StartingNpc

• Type: table
• Description: Configuration for the queue NPC(s) players interact with to join the match.

Field	Type	Description
models	hash[]	Array of ped models randomly assigned to each spawned NPC
randomLocation	boolean	If true, only one NPC spawns at a random location; if false, an NPC spawns at every location in the array
scenario	string	Ambient scenario played by the NPC (e.g. WORLD_HUMAN_WINDOW_SHOP_BROWSE)
locations	vector4[]	Array of possible NPC spawn positions with heading

Items

• Type: table
• Description: Item names used during the race.

Key	Default	Description
controlCrate	"point_control_crate"	The delivery crate placed into dead drop stashes

Mission

• Type: table
• Description: Core mission parameters registered with prp-bridge.

Field	Type	Default	Description
name	string	"point-control"	Internal mission identifier
timeout	number	60	Queue timeout in seconds
cooldown	number	60	Per-player cooldown after a match (seconds)
label	string	"Point Control"	Mission name shown in the NPC menu
desc	string	-	Mission description shown in the NPC menu
minimalPlayersToStart	number	8 (debug: 2)	Minimum queued players required to launch a match
policeRequired	number	0	Minimum online police required
concurrentMissions	number	1	Maximum simultaneously active matches
startItem	string	"point_control_contract"	Item consumed when joining the queue; refunded on leave

Mission.loot

• Type: table
• Description: Reward configuration for the winning team.
  • rolls (number) - number of loot rolls (default 16)
  • table - tiered loot pool with COMMON, RARE, EPIC, and LEGENDARY entries; each entry has name, min, and max

TestingCommand

• Type: table
• Description: Admin command for bypassing the queue during testing.

Field	Default	Description
enabled	true	Set to false to disable the command entirely
command	"startrace"	Command name (without /)
restricted	"group.admin"	Permission required to use the command

Locations

• Type: table
• Description: Named map sets. One is randomly selected per match. Each map set contains:
  • start - array of 2 starting point entries (one per team), each with coords (vector3) and a crate prop (model, pos, rot)
  • points - array of 6 dead drop capture point entries, each with coords (vector3) and a crate prop

Three map sets are defined by default: default, north, and mid.

ConvertPed

• Type: table
• Description: NPC that converts drug bricks into a point_control_contract.

Field	Type	Description
model	hash	Ped model for the NPC
requiredItem	string	Item the player must hold to access the conversion (default "point_control_plans")
coords	vector4	NPC spawn position and heading
itemPoints	table<string, number>	Map of drug brick item names to their point value
requiredPoints	number	Total brick points needed (default 160)
rewardItem	string	Item given on successful conversion (default "point_control_contract")

TurnOnMission

• Type: table
• Description: One-time map delivery gate that must be completed before missions can start (resets on resource restart).

Field	Type	Description
requiredItem	string	Item consumed when activating the gate (default "point_control_map")
target.coords	vector3	Position of the delivery target zone
target.size	vector3	Size of the target zone box
target.rotation	number	Rotation of the target zone

MapColours

• Type: table
• Description: Blip colour and radius settings for map factions/states displayed during a match.

Key	Blip Colour	Radius
weave	26	18
apex	17	47
neutral	55	62