Heat System

Track your notoriety with law enforcement.

What is Heat?

Heat represents how much attention you've attracted from law enforcement. Higher heat means:

• Higher chance of police dispatch

• More aggressive police response

• Checkpoints more likely to search you

Heat Mechanics

Heat Scale

0 ████████████████████ 100
  └─ Safe ─────────── Hot ─┘

Heat Level	Status	Risk
0-20	Cool	Very Low
20-40	Warm	Low
40-60	Hot	Medium
60-80	Very Hot	High
80-100	Burning	Extreme

Heat Decay

Heat naturally decreases over time:

IllegalConfig.HeatSystem = {
    maxHeat = 100,
    heatDecayRate = 1,       -- Lose 1 heat
    heatDecayInterval = 60000 -- Every minute
}

Example: At 50 heat, it takes 50 minutes to fully cool down.

Gaining Heat

Actions That Increase Heat

Action	Heat Gained
Starting an illegal run	+15
Police spot you during run	+25
Failing a checkpoint	+35

Heat Multipliers by Risk

Risk tier affects how much heat you gain:

Risk Tier	Multiplier	Example (Run Start)
Low	0.5x	+7.5 heat
Medium	1.0x	+15 heat
High	1.5x	+22.5 heat
Extreme	2.0x	+30 heat

Police Dispatch Chances

Higher heat = higher chance of police dispatch during missions.

Heat Level	Dispatch Chance
0-20	0%
20-40	10%
40-60	25%
60-80	50%
80-100	75%

How Dispatch Works

1

Police Alert

Police alert is sent.

2

Officer Response

Officers respond to your location.

3

Map Blip

Blip appears on police map.

4

Evade or Complete

You must evade or complete quickly.

Heat Indicators

Visual Feedback

During illegal runs, heat is displayed:

Heat: ████████░░ 80%
Status: VERY HOT

Warning Messages

At high heat levels:

"Heat is rising. Lay low after this run." "Cops are sniffing around. Be careful."

Reducing Heat

Passive Decay

• Heat decays 1 point per minute

• No action required

• Works while online or offline

Criminal Faction Benefits

Higher faction rep provides heat reduction:

Faction Level	Heat Reduction
Distributor (Street Dealers)	-5%
Kingpin (Street Dealers)	-10%
Lieutenant (Arms Cartel)	0%
Commander (Arms Cartel)	-15%
Launderer (Money Syndicate)	-10%
Banker (Money Syndicate)	-20%
Specialist (Car Thieves)	0%
Mastermind (Car Thieves)	-25%

Strategic Heat Management

1

Low Heat Strategy

Best for consistent earnings:

• Do low-risk runs only

• Wait for heat to decay between runs

• Never exceed 40 heat

• Avoid checkpoints

2

High Risk/Reward Strategy

Maximum profit, maximum danger:

• Build faction rep first

• Do high/extreme runs

• Accept police encounters

• Have escape routes planned

Configuration

Server admins can adjust heat settings:

IllegalConfig.HeatSystem = {
    enabled = true,
    maxHeat = 100,
    heatDecayRate = 1,
    heatDecayInterval = 60000,

    heatGainPerRun = 15,
    heatGainOnPoliceSpotted = 25,
    heatGainOnCheckpointFailed = 35,

    dispatchChances = {
        [0] = 0,
        [20] = 10,
        [40] = 25,
        [60] = 50,
        [80] = 75,
    }
}

Tips

Cool Down Period

After a high-heat run, wait 30+ minutes before your next illegal run.

Do Legal Jobs Between

Legal deliveries don't affect heat and let it decay.

Don't Stack High-Risk Runs

Multiple extreme runs = 100 heat = 75% police chance every mission.

Build Faction Rep Early

Faction benefits provide permanent heat reduction.