Nitro System

📄 Config file: shared/nitro_config.lua

This file controls the nitro boost system — hold-to-use timing, overuse warnings, and overheat mechanics. Nitro is a hold-to-activate system where holding too long causes catastrophic engine failure.

---

Hold & Overheat

Config.Nitro = {
    MaxHoldTime = 6000,
    WarnStartTime = 4000,
    OverheatEngineHealth = 200.0,
}

Setting	What it does
MaxHoldTime	Maximum time (in milliseconds) the player can continuously hold nitro before the engine fails. 6000 = 6 seconds.
WarnStartTime	How far into a continuous hold (in ms) the warning beeps start playing. 4000 = warnings begin at 4 seconds.
OverheatEngineHealth	The health level (0-1000) the engine is set to when the nitro system overheats. 200.0 will instantly break the engine and cause it to smoke heavily.

If the player does not release nitro before MaxHoldTime, a blast effect occurs and the vehicle's engine is instantly damaged to the OverheatEngineHealth level. This prevents nitro abuse and adds a risk/reward mechanic.

---

Warning Beeps

Config.Nitro = {
    WarnBeepInterval = 400,
    WarnSound        = "Beep_Red",
    WarnSoundSet     = "DLC_HEIST_HACKING_SNAKE_SOUNDS",
}

Setting	What it does
WarnBeepInterval	Time (in ms) between warning beeps. 400 = beeps every 0.4 seconds.
WarnSound	GTA sound name for the warning beep.
WarnSoundSet	GTA sound set that contains the warning sound.

---

Nitro Drain

Config.Nitro = {
    CountDrainInterval = 1000,
}

Setting	What it does
CountDrainInterval	How often (in ms) one nitro charge is consumed while holding. 1000 = drains 1 charge per second.

Nitro charges are managed through the main mechanic system. Players install nitro bottles through the customs menu or by using a nitro canister item directly.