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.