prp-gun-smuggling

prp-gun-smuggling is a multi-stage group crime script centred around smuggling illegal firearms. Players obtain a contract, transport gun parts by boat to a drop-off contact, process them through a CNC machine into a finished gun crate, strip the tracker at an airfield, and finally drive a truck to a safe house to collect weapon-part rewards.

Features

Contracts & Queue System

• Contract items - four mission tiers each requiring a different contract item (gun_smuggling_contract_smg, gun_smuggling_contract_smg_large, gun_smuggling_contract_rifle, gun_smuggling_contract_chaos); only contracts in the player's inventory appear as options
• Queue ped - talk to contact at the docks to select a mission type and enter the server-wide queue
• Group requirement - players must be in a group to queue; the queue system prevents double-queuing within the same group
• Concurrent missions - configurable limit on how many missions can run simultaneously server-wide

Boat Transport (Stage 1–2)

• Dynamic spawn locations - one of three coastal locations is randomly assigned per mission; the exact spot is sent via an in-game phone message
• Boat spawn - a dinghy is spawned for the group once they are near the pickup point; all group members receive vehicle keys
• Cargo loading - gun parts must be placed in the boat's trunk before departure; the ped at the destination confirms the load
• Drop-off blip - on departure a map blip marks the drop-off shack; it auto-removes after five minutes

CNC Processing (Stage 3)

• CNC Operator ped - hand over the transported gun parts at the scene NPC; progress is tracked per item type
• CNC Machine - interact with the machine to monitor processing; a progress bar shows time remaining (default 5 minutes)
• Gun crate output - once the machine finishes, collect a gun_smuggling_crate with an active tracker tag

Airfield Tracker Removal (Stage 4)

• Airfield operator peds - one of three clothing-store locations (Grapeseed, Zancudo, Paleto) is randomly assigned per mission
• Tracker removal - hand the tracker-tagged crate to the airfield ped; it enters a timed removal queue (default 15 minutes)
• Progress display - the airfield menu shows a progress bar and time remaining; collect the de-tracked crate once finished

Truck Transport & Police Alert (Stage 5)

• Truck spawn - after collecting the de-tracked crate, start the truck transport at the airfield ped; a unique vehicle model spawns per airfield
• GPS waypoint - entering the truck triggers a notification and sets the GPS to the assigned safe house
• Police dispatch alert - a 10-90 alert fires with vehicle plate, driver name, and origin location; officers receive a live map blip updated every 10 seconds for up to 10 minutes
• Tracker timeout - the tracker blip on police maps auto-disables after the timeout expires

Safe House Delivery & Rewards (Stage 6)

• Safe house peds - four possible safe house locations; the correct one is determined per transport mission
• Proximity check - the player must be within 20 m of the transport truck when handing over the crate
• Guaranteed loot - each mission tier has a fixed loot table (gun part components, blueprints, ammo, military gun parts)
• Random bonus loot - tiered rarity pool (COMMON / RARE / EPIC) of weapon blueprints drawn on completion

Mission Types

Mission	Contract Item	Reward Focus
SMG Gun Parts	gun_smuggling_contract_smg	SMG blueprints & components
Large SMG Gun Parts	gun_smuggling_contract_smg_large	Medium SMG blueprints & components
Rifle Gun Parts	gun_smuggling_contract_rifle	Rifle blueprints & components
Rifle+ Gun Parts	gun_smuggling_contract_chaos	Rifle components (higher quantities)

Admin Tools

• Reset command - /reset_smuggling (configurable) forces all active missions to end immediately; useful if a mission gets stuck
• Debug mode - Config.Debug = true removes group and minimum-member requirements for easier testing

Requirements

• oxmysql
• ox_lib
• prp-bridge