illegal Configuration

High risk, high reward underground delivery system.

---

What Are Illegal Runs?

Illegal runs are an alternative mission system for players who want more danger and bigger payouts. Transport contraband for criminal organizations while avoiding police attention.

---

Key Differences from Legal Jobs

Aspect	Legal Jobs	Illegal Runs
Base Pay	$50-$150	$2,500-$20,000
Risk Level	Low	Low to Extreme
Police	None	Active threat
Heat	None	Accumulates
Checkpoints	None	Random spawns
Factions	Courier factions	Criminal organizations

---

Requirements

Minimum Rank

IllegalConfig.RequireMinimumRank = 5

You must be at least Rank 5 to access illegal runs.

Police Requirement (Optional)

IllegalConfig.RequireMinimumCops = 0

Server admins can require minimum police online.

Cooldown

IllegalConfig.CooldownBetweenRuns = 300  -- 5 minutes

Must wait between runs to prevent spam.

---

The Black Market Hub

Location

The hub is located in Vespucci:

• Coordinates: 1383.99, -2079.58, 52.0

• Blip: Skull icon (hidden until close)

• NPC: Gang member

Finding the Hub

1

Approach the Area

The blip only appears when you're nearby.

2

Spot the Blip

Look for the skull icon on your map.

3

Interact with NPC

Approach the gang member to interact.

---

Core Systems

Heat System

Track your notoriety with law enforcement

Risk Tiers

Low, Medium, High, and Extreme difficulties

Criminal Factions

Build reputation with 4 criminal organizations

Checkpoints

Random police checkpoints to avoid

Job Types

6 unique illegal delivery types

---

Risk vs Reward

Low Risk

• Payment: $2,500 base

• Police Chance: 5%

• Example: Stolen goods fencing

Medium Risk

• Payment: $5,000 base

• Police Chance: 15%

• Example: Drug smuggling

High Risk

• Payment: $10,000 base

• Police Chance: 30%

• Example: Weapon trafficking

Extreme Risk

• Payment: $20,000 base

• Police Chance: 50%

• Example: Human smuggling

---

Distance Bonuses (Illegal)

Illegal runs have higher distance bonuses:

IllegalConfig.DistanceBonus = {
    bonusPerKM = 15,          -- $15/km (vs $5 legal)
    xpBonusPerKM = 5,         -- 5 XP/km (vs 2 legal)
    maxMultiplier = 2.5,      -- Higher cap
    longHaulThreshold = 5.0   -- 5km for long haul
}

Job Multipliers

Job Type	Multiplier
Drug Smuggling	1.5x
Weapon Trafficking	2.0x
Stolen Goods	1.2x
Money Laundering	1.8x
Human Smuggling	2.5x
Exotic Cars	2.2x

---

Encrypted Phone

During illegal runs, you receive encrypted messages:

Start Messages

"Package is ready at the spot. Move quickly." "Cargo secured. Pickup location sent to your GPS."

Delivery Messages

"Buyer is waiting at the drop. No delays." "Drop zone confirmed. Complete the transaction."

Warning Messages

"Heat is rising. Lay low after this run." "Checkpoint reported nearby. Find another route."

Success Messages

"Clean delivery. Payment transferred." "Smooth operation. Reputation improved."

---

Item Rewards

Beyond cash, illegal runs can reward items:

Low Risk Rewards

• Weed brick (1-3, 60% chance)

• Lockpick (1-2, 40% chance)

Medium Risk Rewards

• Coke brick (1-2, 50% chance)

• Pistol (1, 30% chance)

• Advanced lockpick (1-2, 40% chance)

High Risk Rewards

• Meth brick (2-4, 60% chance)

• SMG (1, 40% chance)

• Electronic kit (1-2, 50% chance)

Extreme Risk Rewards

• Heroin brick (3-6, 70% chance)

• Assault rifle (1, 50% chance)

• Trojan USB (1, 30% chance)

---

Tips for Success

Watch Your Heat

High heat = high police chance. Let it cool down between runs.

Plan Your Route

Checkpoints spawn on major roads. Know alternative routes.

Build Criminal Rep

Higher faction rep = better payouts and reduced heat.

Ghost Driver Skill

The "Ghost Driver" skill reduces police detection range.