Configuration

All settings are managed in shared.lua.

Framework

Framework is auto-detected based on running resources. No manual configuration needed.

Detection order: ESX → QBox → QBCore → Ox Core → Standalone

Fuel System

-- Supported: 'default', 'LegacyFuel', 'ox_fuel', 'ps-fuel', 'cdn-fuel', 'lj-fuel',
--            'okokGasStation', 'ti_fuel', 'myFuel', 'x-fuel', 'BigDaddy-Fuel',
--            'hyon_gas_station', 'custom'
Config.FuelResource = 'default'

-- Custom fuel function (only used when Config.FuelResource = 'custom')
Config.GetCustomFuel = function(vehicle)
    return GetVehicleFuelLevel(vehicle)
end

Voice System

-- Supported: 'pma-voice', 'mumble-voip', 'saltychat', 'tokovoip', 'custom'
Config.VoiceResource = 'pma-voice'

-- Custom voice event (only used when Config.VoiceResource = 'custom')
Config.VoiceEvents = {
    talkingMode = 'pma-voice:setTalkingMode',
}

Death Detection

-- Supported: 'none', 'wasabi_ambulance', 'qb-ambulancejob', 'esx_ambulancejob', 'custom'
Config.DeathResource = 'wasabi_ambulance'

-- Custom death check function (only used when Config.DeathResource = 'custom')
Config.IsPlayerDead = function()
    return IsEntityDead(PlayerPedId())
end

Stungun Settings

Config.Stungun = {
    enabled = true,         -- Enable custom stungun ammo system
    maxAmmo = 2,            -- Max ammo count
    rechargeTime = 15000,   -- Recharge time (ms)
}

Keybinds

Config.Keybinds = {
    seatbelt = 'b',          -- Toggle seatbelt
    indicatorLeft = 'LEFT',  -- Left turn signal
    indicatorRight = 'RIGHT',-- Right turn signal
    warningLights = 'DOWN',  -- Hazard lights
    hudSettings = 'i',       -- Open HUD settings
}

Players can remap these in GTA Settings → Key Bindings.

Hidden GTA HUD Components

-- Ref: https://docs.fivem.net/natives/?_0x6806C51AD12B83B8
Config.HideHudComponents = { 6, 7, 8, 9 }

Electric Vehicle Detection

-- Vehicles with fPetrolTankVolume <= this value are treated as electric
Config.ElectricVehicleThreshold = 1.0

Heart Rate System

Config.HeartRate = {
    baseRate = 72,          -- Resting heart rate
    minRate = 60,           -- Minimum heart rate
    maxRate = 195,          -- Maximum heart rate
    spikeMin = 120,         -- Minimum during spike
    riseSpeed = 0.15,       -- Rise speed (0~1)
    fallSpeed = 0.02,       -- Fall speed (0~1)
    damageMultiplier = 0.8, -- Damage to heart rate factor
    decelThreshold = 30,    -- Sudden deceleration threshold
}

Notification System

-- Supported: 'ox_lib', 'qb', 'esx', 'custom'
Config.NotifyResource = 'ox_lib'

-- Custom notification function (only when 'custom')
Config.CustomNotify = function(title, description, type)
    -- your notification logic
end

Minimap Settings

Config.Minimap = {
    circleMapScale = 0.83,  -- Circle minimap mask scale (0.1~2.0)
}

Full Reference

Last updated: March 4, 2026