Configuration
All configuration is done in config.lua at the root of the resource.
General
Debug
- Type:
boolean - Default:
false - Description: Enables debug logging and bypasses group and minimum-member requirements. Set to
falsebefore going live.
Mission
name
- Type:
string - Default:
"gun_smuggling" - Description: Internal identifier used for the queue system.
label
- Type:
string - Default:
"Gun Smuggling" - Description: Display label shown in queue and UI menus.
phoneNumber
- Type:
string - Default: Randomly generated on resource start
- Description: The phone number used to send mission messages to group members.
policeRequired
- Type:
number - Default:
0 - Description: Minimum number of online police officers required before the mission can be started.
concurrentMissions
- Type:
number - Default:
1 - Description: Maximum number of simultaneous active smuggling missions allowed server-wide.
timeout
- Type:
number - Default:
60 * 25(25 minutes) - Description: Time in seconds before an active mission is automatically failed and cleaned up.
groupMembers.min
- Type:
number - Default:
2(0in debug mode) - Description: Minimum number of group members required to queue for a mission.
groupMembers.max
- Type:
number - Default:
4 - Description: Maximum number of group members allowed in the mission.
Timers
CNC
- Type:
number - Default:
60 * 5(5 minutes;20seconds in debug mode) - Description: How long the CNC machine takes to process gun parts into a gun crate.
Airfield
- Type:
number - Default:
60 * 15(15 minutes;20seconds in debug mode) - Description: How long the airfield operator takes to remove the tracker from a gun crate.
BoatModel
- Type:
hash - Default:
dinghy - Description: Vehicle model spawned as the transport boat at the pickup location.
ResetCommand
enabled
- Type:
boolean - Default:
true - Description: Whether the admin reset command is registered.
command
- Type:
string - Default:
"reset_smuggling" - Description: The chat command name used to force-reset all active missions.
restriction
- Type:
string - Default:
"group.admin" - Description: Ace permission required to use the reset command.
Alert
jobs
- Type:
table<string> - Default:
{ 'police' } - Description: Jobs that receive the police dispatch alert when a truck transport begins.
code
- Type:
string - Default:
"10-90" - Description: Dispatch alert code shown to officers.
title
- Type:
string - Default:
"Gun Smuggling in Progress" - Description: Dispatch alert title shown to officers.
description
- Type:
string - Default:
"A truck has been reported transporting illegal firearms." - Description: Dispatch alert body text.
blip.sprite
- Type:
number - Default:
110 - Description: Map blip sprite shown to officers during truck transport.
blip.size
- Type:
number - Default:
4 - Description: Scale of the officer dispatch blip.
blip.color
- Type:
number - Default:
3 - Description: Colour of the officer dispatch blip (GTA blip colour index).
QueuePed
model
- Type:
string - Default:
"s_m_y_dealer_01" - Description: Ped model for the queue NPC at the docks.
coords
- Type:
vector4 - Description: World position and heading of the queue ped.
Scene
ped.model
- Type:
hash - Default:
MP_M_WeapWork_01 - Description: Ped model for the CNC Operator NPC.
ped.location
- Type:
vector4 - Description: World position and heading of the CNC Operator ped.
ped.animation
- Type:
string - Default:
"WORLD_HUMAN_LEANING" - Description: Scenario animation played by the CNC Operator ped.
cnc.location
- Type:
vector3 - Description: World position of the CNC machine interact zone.
Items
crate
- Type:
string - Default:
"gun_smuggling_crate" - Description: Item name for the gun crate produced by the CNC machine.
LOCATIONS
- Type:
table - Description: Array of coastal pickup locations. Each entry defines:
ped(vector4) - position and heading of Natalia's contact pedboat(vector4) - spawn position and heading of the transport boatguards(table<vector4>) - positions of hostile guard peds spawned when the group departs
Only one location is assigned per active mission. A location cannot be reused until the mission ends.
AIRFIELDS
- Type:
table - Description: Array of airfield / tracker-removal locations. Each entry defines:
label(string) - display name shown in dispatch alerts and menuslocation(vector4) - position and heading of the airfield operator pedtruck.model(hash) - vehicle model spawned for the truck transport stagetruck.location(vector4) - spawn position and heading of the truck
One airfield is randomly assigned per mission.
DROP_OFFS
- Type:
table - Description: Array of drop-off zones near the CNC machine. Each entry defines:
center(vector3) - centre point of the drop-off zone; players must approach within 75 m to progress to the next stage
SafeHouses
- Type:
table<vector4> - Description: Array of safe house locations where truck transport missions are completed. One is randomly chosen per transport. Players must be within 20 m of the parked truck when handing in the crate.
MISSIONS
- Type:
table - Description: Array of mission definitions. Each entry defines:
label(string) - display name shown in menusdescription(string) - short description shown in menusrequiredContractItem(string) - item that must be in the player's inventory to unlock this mission in the queue menuitems(table) - list of{ name, count }entries that must be loaded into the boat trunk before departurecnc(table) - list of{ name, count }items given to the player when collecting a finished CNC operation
TruckTransport
onlineMembers
- Type:
number - Default:
3(0in debug mode) - Description: Minimum group size required to receive the truck transport notification from another group's mission.
totalOrgs
- Type:
number - Default:
2(9999in debug mode) - Description: Minimum number of active organisations required for the truck notification to broadcast.
trackerTimeout
- Type:
number - Default:
60 * 10(10 minutes) - Description: How long the police tracker blip stays active after the truck transport begins.
guaranteedRewards
- Type:
table - Description: Per-mission fixed loot tables. Index corresponds to the mission index in
MISSIONS. Each entry is a list of{ itemId, count }records.countcan be a number or a{ min, max }table for a random range.
rewardCount
- Type:
number - Default:
2 - Description: Number of random bonus rewards drawn from the rarity pool on mission completion.
rewards
- Type:
table - Description: Per-mission rarity-tiered bonus reward pools. Index corresponds to the mission index in
MISSIONS. Each entry containsCOMMON,RARE, and/orEPICsub-tables, each listing{ name, min, max }reward records.
| Rarity | Draw chance |
|---|---|
| COMMON | High |
| RARE | Medium |
| EPIC | Low |