# 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:

```lua
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

{% stepper %}
{% step %}

### Police Alert

Police alert is sent.
{% endstep %}

{% step %}

### Officer Response

Officers respond to your location.
{% endstep %}

{% step %}

### Map Blip

Blip appears on police map.
{% endstep %}

{% step %}

### Evade or Complete

You must evade or complete quickly.
{% endstep %}
{% endstepper %}

## 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

{% stepper %}
{% step %}

### 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
  {% endstep %}

{% step %}

### High Risk/Reward Strategy

Maximum profit, maximum danger:

* Build faction rep first
* Do high/extreme runs
* Accept police encounters
* Have escape routes planned
  {% endstep %}
  {% endstepper %}

## Configuration

Server admins can adjust heat settings:

```lua
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

{% hint style="success" %}
Cool Down Period

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

{% hint style="success" %}
Do Legal Jobs Between

Legal deliveries don't affect heat and let it decay.
{% endhint %}

{% hint style="warning" %}
Don't Stack High-Risk Runs

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

{% hint style="info" %}
Build Faction Rep Early

Faction benefits provide permanent heat reduction.
{% endhint %}
