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.

circle-exclamation

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

Setting
What it does

CountDrainInterval

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

circle-info

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.

Last updated