Usage

Mission Flow

Phase 1 – Preparation

The mission requires two preparation steps before queuing is possible.

1. Decrypt the Pendrive

1. Obtain an ar_pendrive_a (Encrypted Pendrive).
2. Travel to the Decrypt Terminal (marked on the map).
3. Interact with the terminal. Complete the keyBuilder minigame.
4. Wait through the 2-minute decrypt progress bar - do not move or it will cancel.
5. On success you receive an ar_pendrive_b (Decrypted Pendrive). The source pendrive loses 20% durability; it breaks and is not returned if durability hits zero.

2. Exchange Drugs for a Supply Drop Pass

1. Collect enough bricked drugs - the default exchange requires 90 points worth (cocaine_mission_brick = 30 pts, mdma_brick = 30 pts, pure_meth_brick_* = 5–15 pts depending on quality).
2. Also have the ar_pendrive_b in your inventory.
3. Find one of the three Supply Drop Handler NPCs and interact → Obtain Supply Drop Pass.
4. You receive one ar_start_item (Supply Drop Pass).

TIP

The same NPC offers a second exchange: ar_pendrive_b alone (no drugs required) for a Drug Race Contract (60 pts of drugs needed). You can also buy a Snitch for $5,000 cash.

Phase 2 – Queue

1. Form a group with your crew (4–8 members).
2. Head to the Starting NPC blip on the map.
3. Interact with the NPC → select Supply Drop to join the queue. The ar_start_item is consumed on entry.
4. Wait for the queue to pop (requires a minimum number of police online and a free drop location).

Phase 3 – The Airdrop

Once the mission starts:

Pilot (group leader)

1. A blip appears at the airport. Travel there and interact with the pilot NPC → Get Plane to spawn the cargo plane. A parachute is added to your inventory.
2. Fly toward the drop zone radius blip. When you enter the area the hatch controls appear:

Key	Action
[E]	Open / close cargo hatch
[X]	Drop a crate (hatch must be open)

3. Open the hatch and press [X] to drop each crate. A crate with a parachute animates down to the nearest available target coordinate. The number of remaining crates is shown in a notification.
4. After the last crate drops, press [E] to Order Plane Out - the plane auto-pilots away and despawns after 15 seconds.

WARNING

If the plane engine health drops critically low while you are airborne the mission fails immediately for your team.

Ground team (remaining members)

• After the mission starts you receive a notification to wait for the crates to land.
• Once all crates are dropped a radius blip marks the drop zone on your map.
• Crates become openable after their individual timers expire (default 5 minutes from drop time).
• Interact with a crate → Open crate → complete the 10-second progress bar to collect loot.

Phase 4 – Securing the Loot

• The team that loots the majority of crates wins the mission.
• Police (configured jobs) who arrive on scene can also open and loot crates.
• Enemy groups can contest the drop by looting crates before your team does.
• The mission ends when all crates have been looted. The winning side receives a success notification; the losing side (if there's one) receives a failure notification.

Crate Loot

Each crate rolls 6 times against the loot table with a guaranteed minimum of 1 Common and 1 Rare drop.

Tier	Example Rewards
Common	Money bands (15–35), gun crafting components, blueprint fragments
Rare	Weapon parts, money bands (25–40), Tier 1 improvement kits, advanced goggle blueprints
Epic	Weapon blueprints (FNX, Pistol .50, Heavy Pistol), Tier 1 (×4–5) and Tier 2 (×1–2) improvement kits
Legendary	SMG blueprint, money bands (50–80), Tier 2 improvement kits (×1–3)

All weapon-related loot receives a scratched serial metadata flag automatically.

Snitch System

A player who has purchased a Snitch from the Convert Ped NPC will receive an anonymous SMS with the exact coordinates of the drop zone the moment the last crate is dropped.

Police Dispatch

On the first crate drop, a dispatch alert is sent to all online officers:

Field	Value
Code	10-XX
Title	Unauthorized Air Drops
Blip	Radius blip centred near the drop zone (flashing, 10-minute duration)

Configuration

Option	Default	Description
Config.Debug	true	Enables debug logging; set to false in production
Config.Mission.timeout	60	Queue timeout in seconds
Config.Mission.cooldown	60	Per-player mission cooldown in seconds
Config.Mission.minimalGroupSize	4	Minimum group members required to queue
Config.Mission.maximalGroupSize	8	Maximum group members allowed
Config.Mission.policeRequired	2	Minimum police online before the queue executes
Config.Mission.concurrentMissions	3	Maximum simultaneous active missions
Config.Mission.crateCount	3	Number of crates dropped per mission
Config.Mission.crateOpenTime	300	Seconds after drop before a crate can be opened
Config.CrateLoot.lootTableRolls	6	Number of loot rolls per crate
Config.CrateLoot.policeReward	50000	(Reserved) Cash reward value for police loot seizure
Config.Decrypt.decryptTime	120	Pendrive decrypt progress bar duration in seconds
Config.StartingNpc.randomLocation	false	If true, pick one random NPC spawn; if false, spawn at all configured locations

Admin

Command	Access	Description
/startaerial	group.admin	Immediately starts a Supply Drop mission for your current group (requires a free location)

TIP

The admin command is controlled by Config.Testing in config.lua. Set Config.Testing.enabled = false to disable it on live servers.