Skip to content

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 false before 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 (0 in 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; 20 seconds 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; 20 seconds 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 ped
    • boat (vector4) - spawn position and heading of the transport boat
    • guards (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 menus
    • location (vector4) - position and heading of the airfield operator ped
    • truck.model (hash) - vehicle model spawned for the truck transport stage
    • truck.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 menus
    • description (string) - short description shown in menus
    • requiredContractItem (string) - item that must be in the player's inventory to unlock this mission in the queue menu
    • items (table) - list of { name, count } entries that must be loaded into the boat trunk before departure
    • cnc (table) - list of { name, count } items given to the player when collecting a finished CNC operation

TruckTransport

onlineMembers

  • Type: number
  • Default: 3 (0 in debug mode)
  • Description: Minimum group size required to receive the truck transport notification from another group's mission.

totalOrgs

  • Type: number
  • Default: 2 (9999 in 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. count can 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 contains COMMON, RARE, and/or EPIC sub-tables, each listing { name, min, max } reward records.
RarityDraw chance
COMMONHigh
RAREMedium
EPICLow