[SUGGESTION] Feature Addition: Toggle HUD Command

[LawProductions]

The problem

I noticed qb-hud currently lacks a native way to programmatically hide/show the HUD, which is crucial for developers creating immersive UI experiences.

Ideal solution

This adds a new command /togglehud that allows players to completely hide/show the HUD and minimap. This feature is useful for:

Cinematic gameplay/screenshots
Reducing screen clutter when needed
Role-playing scenarios
Content creation

Changes Made

Added server-side command /togglehud with player state tracking
Added client-side toggle functionality
Added export ToggleHud for other resources to use
Properly handles minimap visibility based on vehicle state and menu settings
Includes server-side notifications for command usage

Implementation Details

Maintains existing HUD settings when re-enabling
Respects vehicle/on-foot minimap rules
Doesn't interfere with existing HUD functionality
Clean implementation using existing NUI messages
Lightweight addition with minimal overhead

Testing

Tested functionality in the following scenarios:

On foot/in vehicle transitions
Menu setting interactions
Multiple toggle cycles
Export usage from other resources
Different notification states

NEW CLIENT CODE:

local QBCore = exports['qb-core']:GetCoreObject()
local PlayerData = QBCore.Functions.GetPlayerData()
local config = Config
local speedMultiplier = config.UseMPH and 2.23694 or 3.6
local seatbeltOn = false
local cruiseOn = false
local showAltitude = false
local showSeatbelt = false
local nos = 0
local stress = 0
local hunger = 100
local thirst = 100
local cashAmount = 0
local bankAmount = 0
local nitroActive = 0
local harness = 0
local hp = 100
local armed = 0
local parachute = -1
local oxygen = 100
local dev = false
local playerDead = false
local showMenu = false
local showCircleB = false
local showSquareB = false
local Menu = config.Menu
local CinematicHeight = 0.2
local w = 0
local radioActive = false
local isPauseMenuActive = false
local hudHidden = false

-- HUD VISIBILITY

local function shouldDisplayRadar()
if hudHidden then return false end
if isPauseMenuActive then return false end
if Menu.isHideMapChecked then return false end
if Menu.isCinematicModeChecked then return false end

local player = PlayerPedId()
local vehicle = GetVehiclePedIsIn(player, false)

if IsPedInAnyVehicle(player) and not IsThisModelABicycle(vehicle) then
    return true
end

return Menu.isOutMapChecked

end

-- HUD Visibility Toggle Function
local function ToggleHudVisibility()
hudHidden = not hudHidden

if hudHidden then
    SendNUIMessage({
        action = 'hudtick',
        show = false
    })
    SendNUIMessage({
        action = 'car',
        show = false
    })
    SendNUIMessage({
        action = 'baseplate',
        show = false
    })
    DisplayRadar(false)
else
    if not isPauseMenuActive then
        SendNUIMessage({
            action = 'hudtick',
            show = true
        })
        DisplayRadar(shouldDisplayRadar())
    end
end

end

-- Export Functions
exports('ToggleHud', function()
ToggleHudVisibility()
end)

exports('SetHudState', function(state)
if hudHidden ~= not state then
ToggleHudVisibility()
end
DisplayRadar(shouldDisplayRadar())
end)

exports('IsHudHidden', function()
return hudHidden
end)

-- Event Handlers
RegisterNetEvent('qb-hud:client:ToggleHud', function()
ToggleHudVisibility()
end)

DisplayRadar(false)

local function CinematicShow(bool)
SetBigmapActive(true, false)
Wait(0)
SetBigmapActive(false, false)
if bool then
for i = CinematicHeight, 0, -1.0 do
Wait(10)
w = i
end
else
for i = 0, CinematicHeight, 1.0 do
Wait(10)
w = i
end
end
end

local function loadSettings(settings)
for k, v in pairs(settings) do
if k == 'isToggleMapShapeChecked' then
Menu.isToggleMapShapeChecked = v
SendNUIMessage({ test = true, event = k, toggle = v })
elseif k == 'isCinematicModeChecked' then
Menu.isCinematicModeChecked = v
CinematicShow(v)
SendNUIMessage({ test = true, event = k, toggle = v })
elseif k == 'isChangeFPSChecked' then
Menu[k] = v
local val = v and 'Optimized' or 'Synced'
SendNUIMessage({ test = true, event = k, toggle = val })
else
Menu[k] = v
SendNUIMessage({ test = true, event = k, toggle = v })
end
end
QBCore.Functions.Notify(Lang:t('notify.hud_settings_loaded'), 'success')
Wait(1000)
TriggerEvent('hud:client:LoadMap')
end

local function saveSettings()
SetResourceKvp('hudSettings', json.encode(Menu))
end

local function hasHarness(items)
local ped = PlayerPedId()
if not IsPedInAnyVehicle(ped, false) then return end

local _harness = false
if items then
    for _, v in pairs(items) do
        if v.name == 'harness' then
            _harness = true
        end
    end
end

harness = _harness

end

RegisterNetEvent('QBCore:Client:OnPlayerLoaded', function()
Wait(2000)
local hudSettings = GetResourceKvpString('hudSettings')
if hudSettings then loadSettings(json.decode(hudSettings)) end
PlayerData = QBCore.Functions.GetPlayerData()
Wait(3000)
SetEntityHealth(PlayerPedId(), 200)
end)

RegisterNetEvent('QBCore:Client:OnPlayerUnload', function()
PlayerData = {}
end)

RegisterNetEvent('QBCore:Player:SetPlayerData', function(val)
PlayerData = val
end)

AddEventHandler('onResourceStart', function(resourceName)
if GetCurrentResourceName() ~= resourceName then return end
Wait(2000)
local hudSettings = GetResourceKvpString('hudSettings')
if hudSettings then loadSettings(json.decode(hudSettings)) end
end)

AddEventHandler('pma-voice:radioActive', function(data)
radioActive = data
end)

-- Callbacks & Events
RegisterCommand('menu', function()
Wait(50)
if showMenu then return end
TriggerEvent('hud:client:playOpenMenuSounds')
SetNuiFocus(true, true)
SendNUIMessage({ action = 'open' })
showMenu = true
end)

RegisterNUICallback('closeMenu', function(_, cb)
Wait(50)
TriggerEvent('hud:client:playCloseMenuSounds')
showMenu = false
SetNuiFocus(false, false)
cb('ok')
end)

RegisterKeyMapping('menu', 'Open Menu', 'keyboard', config.OpenMenu)

-- Reset hud
local function restartHud()
TriggerEvent('hud:client:playResetHudSounds')
QBCore.Functions.Notify(Lang:t('notify.hud_restart'), 'error')
if IsPedInAnyVehicle(PlayerPedId()) then
Wait(2600)
SendNUIMessage({ action = 'car', show = false })
SendNUIMessage({ action = 'car', show = true })
end
Wait(2600)
SendNUIMessage({ action = 'hudtick', show = false })
SendNUIMessage({ action = 'hudtick', show = true })
Wait(2600)
QBCore.Functions.Notify(Lang:t('notify.hud_start'), 'success')
end

RegisterNUICallback('restartHud', function(_, cb)
Wait(50)
restartHud()
cb('ok')
end)

RegisterCommand('resethud', function()
Wait(50)
restartHud()
end)

RegisterNUICallback('resetStorage', function(_, cb)
Wait(50)
TriggerEvent('hud:client:resetStorage')
cb('ok')
end)

RegisterNetEvent('hud:client:resetStorage', function()
Wait(50)
if Menu.isResetSoundsChecked then
TriggerServerEvent('InteractSound_SV:PlayOnSource', 'airwrench', 0.1)
end
QBCore.Functions.TriggerCallback('hud:server:getMenu', function(menu)
loadSettings(menu); SetResourceKvp('hudSettings', json.encode(menu))
end)
end)

-- Notifications
RegisterNUICallback('openMenuSounds', function(_, cb)
Wait(50)
Menu.isOpenMenuSoundsChecked = not Menu.isOpenMenuSoundsChecked
TriggerEvent('hud:client:playHudChecklistSound')
saveSettings()
cb('ok')
end)

RegisterNetEvent('hud:client:playOpenMenuSounds', function()
Wait(50)
if not Menu.isOpenMenuSoundsChecked then return end
TriggerServerEvent('InteractSound_SV:PlayOnSource', 'monkeyopening', 0.5)
end)

RegisterNetEvent('hud:client:playCloseMenuSounds', function()
Wait(50)
if not Menu.isOpenMenuSoundsChecked then return end
TriggerServerEvent('InteractSound_SV:PlayOnSource', 'catclosing', 0.05)
end)

RegisterNUICallback('resetHudSounds', function(_, cb)
Wait(50)
Menu.isResetSoundsChecked = not Menu.isResetSoundsChecked
TriggerEvent('hud:client:playHudChecklistSound')
saveSettings()
cb('ok')
end)

RegisterNetEvent('hud:client:playResetHudSounds', function()
Wait(50)
if not Menu.isResetSoundsChecked then return end
TriggerServerEvent('InteractSound_SV:PlayOnSource', 'airwrench', 0.1)
end)

RegisterNUICallback('checklistSounds', function(_, cb)
Wait(50)
TriggerEvent('hud:client:checklistSounds')
cb('ok')
end)

RegisterNetEvent('hud:client:checklistSounds', function()
Wait(50)
Menu.isListSoundsChecked = not Menu.isListSoundsChecked
TriggerEvent('hud:client:playHudChecklistSound')
saveSettings()
end)

RegisterNetEvent('hud:client:playHudChecklistSound', function()
Wait(50)
if not Menu.isListSoundsChecked then return end
TriggerServerEvent('InteractSound_SV:PlayOnSource', 'shiftyclick', 0.5)
end)

RegisterNUICallback('showOutMap', function(_, cb)
Wait(50)
Menu.isOutMapChecked = not Menu.isOutMapChecked
TriggerEvent('hud:client:playHudChecklistSound')
saveSettings()
cb('ok')
end)

RegisterNUICallback('showOutCompass', function(_, cb)
Wait(50)
Menu.isOutCompassChecked = not Menu.isOutCompassChecked
TriggerEvent('hud:client:playHudChecklistSound')
saveSettings()
cb('ok')
end)

RegisterNUICallback('showFollowCompass', function(_, cb)
Wait(50)
Menu.isCompassFollowChecked = not Menu.isCompassFollowChecked
TriggerEvent('hud:client:playHudChecklistSound')
saveSettings()
cb('ok')
end)

RegisterNUICallback('showMapNotif', function(_, cb)
Wait(50)
Menu.isMapNotifChecked = not Menu.isMapNotifChecked
TriggerEvent('hud:client:playHudChecklistSound')
saveSettings()
cb('ok')
end)

RegisterNUICallback('showFuelAlert', function(_, cb)
Wait(50)
Menu.isLowFuelChecked = not Menu.isLowFuelChecked
TriggerEvent('hud:client:playHudChecklistSound')
saveSettings()
cb('ok')
end)

RegisterNUICallback('showCinematicNotif', function(_, cb)
Wait(50)
Menu.isCinematicNotifChecked = not Menu.isCinematicNotifChecked
TriggerEvent('hud:client:playHudChecklistSound')
saveSettings()
cb('ok')
end)

-- Status
RegisterNUICallback('dynamicHealth', function(_, cb)
Wait(50)
TriggerEvent('hud:client:ToggleHealth')
cb('ok')
end)

RegisterNetEvent('hud:client:ToggleHealth', function()
Wait(50)
Menu.isDynamicHealthChecked = not Menu.isDynamicHealthChecked
TriggerEvent('hud:client:playHudChecklistSound')
saveSettings()
end)

RegisterNUICallback('dynamicArmor', function(_, cb)
Wait(50)
Menu.isDynamicArmorChecked = not Menu.isDynamicArmorChecked
TriggerEvent('hud:client:playHudChecklistSound')
saveSettings()
cb('ok')
end)

RegisterNUICallback('dynamicHunger', function(_, cb)
Wait(50)
Menu.isDynamicHungerChecked = not Menu.isDynamicHungerChecked
TriggerEvent('hud:client:playHudChecklistSound')
saveSettings()
cb('ok')
end)

RegisterNUICallback('dynamicThirst', function(_, cb)
Wait(50)
Menu.isDynamicThirstChecked = not Menu.isDynamicThirstChecked
TriggerEvent('hud:client:playHudChecklistSound')
saveSettings()
cb('ok')
end)

RegisterNUICallback('dynamicStress', function(_, cb)
Wait(50)
Menu.isDynamicStressChecked = not Menu.isDynamicStressChecked
TriggerEvent('hud:client:playHudChecklistSound')
saveSettings()
cb('ok')
end)

RegisterNUICallback('dynamicOxygen', function(_, cb)
Wait(50)
Menu.isDynamicOxygenChecked = not Menu.isDynamicOxygenChecked
TriggerEvent('hud:client:playHudChecklistSound')
saveSettings()
cb('ok')
end)

-- Vehicle
RegisterNUICallback('changeFPS', function(_, cb)
Wait(50)
Menu.isChangeFPSChecked = not Menu.isChangeFPSChecked
TriggerEvent('hud:client:playHudChecklistSound')
saveSettings()
cb('ok')
end)

RegisterNUICallback('HideMap', function(_, cb)
Wait(50)
Menu.isHideMapChecked = not Menu.isHideMapChecked
DisplayRadar(shouldDisplayRadar())
TriggerEvent('hud:client:playHudChecklistSound')
saveSettings()
cb('ok')
end)

RegisterNetEvent('hud:client:LoadMap', function()
Wait(50)
-- Credit to Dalrae for the solve.
local defaultAspectRatio = 1920 / 1080 -- Don't change this.
local resolutionX, resolutionY = GetActiveScreenResolution()
local aspectRatio = resolutionX / resolutionY
local minimapOffset = 0
if aspectRatio > defaultAspectRatio then
minimapOffset = ((defaultAspectRatio - aspectRatio) / 3.6) - 0.008
end
if Menu.isToggleMapShapeChecked == 'square' then
RequestStreamedTextureDict('squaremap', false)
if not HasStreamedTextureDictLoaded('squaremap') then
Wait(150)
end
if Menu.isMapNotifChecked then
QBCore.Functions.Notify(Lang:t('notify.load_square_map'))
end
SetMinimapClipType(0)
AddReplaceTexture('platform:/textures/graphics', 'radarmasksm', 'squaremap', 'radarmasksm')
AddReplaceTexture('platform:/textures/graphics', 'radarmask1g', 'squaremap', 'radarmasksm')
-- 0.0 = nav symbol and icons left
-- 0.1638 = nav symbol and icons stretched
-- 0.216 = nav symbol and icons raised up
SetMinimapComponentPosition('minimap', 'L', 'B', 0.0 + minimapOffset, -0.047, 0.1638, 0.183)

    -- icons within map
    SetMinimapComponentPosition('minimap_mask', 'L', 'B', 0.0 + minimapOffset, 0.0, 0.128, 0.20)

    -- -0.01 = map pulled left
    -- 0.025 = map raised up
    -- 0.262 = map stretched
    -- 0.315 = map shorten
    SetMinimapComponentPosition('minimap_blur', 'L', 'B', -0.01 + minimapOffset, 0.025, 0.262, 0.300)
    SetBlipAlpha(GetNorthRadarBlip(), 0)
    SetBigmapActive(true, false)
    SetMinimapClipType(0)
    Wait(50)
    SetBigmapActive(false, false)
    if Menu.isToggleMapBordersChecked then
        showCircleB = false
        showSquareB = true
    end
    Wait(1200)
    if Menu.isMapNotifChecked then
        QBCore.Functions.Notify(Lang:t('notify.loaded_square_map'))
    end
elseif Menu.isToggleMapShapeChecked == 'circle' then
    RequestStreamedTextureDict('circlemap', false)
    if not HasStreamedTextureDictLoaded('circlemap') then
        Wait(150)
    end
    if Menu.isMapNotifChecked then
        QBCore.Functions.Notify(Lang:t('notify.load_circle_map'))
    end
    SetMinimapClipType(1)
    AddReplaceTexture('platform:/textures/graphics', 'radarmasksm', 'circlemap', 'radarmasksm')
    AddReplaceTexture('platform:/textures/graphics', 'radarmask1g', 'circlemap', 'radarmasksm')
    -- -0.0100 = nav symbol and icons left
    -- 0.180 = nav symbol and icons stretched
    -- 0.258 = nav symbol and icons raised up
    SetMinimapComponentPosition('minimap', 'L', 'B', -0.0100 + minimapOffset, -0.030, 0.180, 0.258)

    -- icons within map
    SetMinimapComponentPosition('minimap_mask', 'L', 'B', 0.200 + minimapOffset, 0.0, 0.065, 0.20)

    -- -0.00 = map pulled left
    -- 0.015 = map raised up
    -- 0.252 = map stretched
    -- 0.338 = map shorten
    SetMinimapComponentPosition('minimap_blur', 'L', 'B', -0.00 + minimapOffset, 0.015, 0.252, 0.338)
    SetBlipAlpha(GetNorthRadarBlip(), 0)
    SetMinimapClipType(1)
    SetBigmapActive(true, false)
    Wait(50)
    SetBigmapActive(false, false)
    if Menu.isToggleMapBordersChecked then
        showSquareB = false
        showCircleB = true
    end
    Wait(1200)
    if Menu.isMapNotifChecked then
        QBCore.Functions.Notify(Lang:t('notify.loaded_circle_map'))
    end
end

end)

RegisterNUICallback('ToggleMapShape', function(_, cb)
Wait(50)
if not Menu.isHideMapChecked then
Menu.isToggleMapShapeChecked = Menu.isToggleMapShapeChecked == 'circle' and 'square' or 'circle'
Wait(50)
TriggerEvent('hud:client:LoadMap')
end
TriggerEvent('hud:client:playHudChecklistSound')
saveSettings()
cb('ok')
end)

RegisterNUICallback('ToggleMapBorders', function(_, cb)
Wait(50)
Menu.isToggleMapBordersChecked = not Menu.isToggleMapBordersChecked
if Menu.isToggleMapBordersChecked then
if Menu.isToggleMapShapeChecked == 'square' then
showSquareB = true
else
showCircleB = true
end
else
showSquareB = false
showCircleB = false
end
TriggerEvent('hud:client:playHudChecklistSound')
saveSettings()
cb('ok')
end)

RegisterNUICallback('dynamicEngine', function(_, cb)
Wait(50)
Menu.isDynamicEngineChecked = not Menu.isDynamicEngineChecked
TriggerEvent('hud:client:playHudChecklistSound')
saveSettings()
cb('ok')
end)

RegisterNUICallback('dynamicNitro', function(_, cb)
Wait(50)
Menu.isDynamicNitroChecked = not Menu.isDynamicNitroChecked
TriggerEvent('hud:client:playHudChecklistSound')
saveSettings()
cb('ok')
end)

-- Compass
RegisterNUICallback('showCompassBase', function(_, cb)
Wait(50)
Menu.isCompassShowChecked = not Menu.isCompassShowChecked
TriggerEvent('hud:client:playHudChecklistSound')
saveSettings()
cb('ok')
end)

RegisterNUICallback('showStreetsNames', function(_, cb)
Wait(50)
Menu.isShowStreetsChecked = not Menu.isShowStreetsChecked
TriggerEvent('hud:client:playHudChecklistSound')
saveSettings()
cb('ok')
end)

RegisterNUICallback('showPointerIndex', function(_, cb)
Wait(50)
Menu.isPointerShowChecked = not Menu.isPointerShowChecked
TriggerEvent('hud:client:playHudChecklistSound')
saveSettings()
cb('ok')
end)

RegisterNUICallback('showDegreesNum', function(_, cb)
Wait(50)
Menu.isDegreesShowChecked = not Menu.isDegreesShowChecked
TriggerEvent('hud:client:playHudChecklistSound')
saveSettings()
cb('ok')
end)

RegisterNUICallback('changeCompassFPS', function(_, cb)
Wait(50)
Menu.isChangeCompassFPSChecked = not Menu.isChangeCompassFPSChecked
TriggerEvent('hud:client:playHudChecklistSound')
saveSettings()
cb('ok')
end)

RegisterNUICallback('cinematicMode', function(_, cb)
Wait(50)
if Menu.isCinematicModeChecked then
CinematicShow(false)
Menu.isCinematicModeChecked = false
if Menu.isCinematicNotifChecked then
QBCore.Functions.Notify(Lang:t('notify.cinematic_off'), 'error')
end
DisplayRadar(1)
else
CinematicShow(true)
Menu.isCinematicModeChecked = true
if Menu.isCinematicNotifChecked then
QBCore.Functions.Notify(Lang:t('notify.cinematic_on'))
end
end
TriggerEvent('hud:client:playHudChecklistSound')
saveSettings()
cb('ok')
end)

RegisterNetEvent('hud:client:ToggleAirHud', function()
showAltitude = not showAltitude
end)

RegisterNetEvent('hud:client:UpdateNeeds', function(newHunger, newThirst) -- Triggered in qb-core
hunger = newHunger
thirst = newThirst
end)

RegisterNetEvent('hud:client:UpdateStress', function(newStress) -- Add this event with adding stress elsewhere
stress = newStress
end)

RegisterNetEvent('hud:client:ToggleShowSeatbelt', function()
showSeatbelt = not showSeatbelt
end)

RegisterNetEvent('seatbelt:client:ToggleSeatbelt', function() -- Triggered in smallresources
seatbeltOn = not seatbeltOn
end)

RegisterNetEvent('seatbelt:client:ToggleCruise', function() -- Triggered in smallresources
cruiseOn = not cruiseOn
end)

RegisterNetEvent('hud:client:UpdateNitrous', function(nitroLevel, bool)
nos = nitroLevel
nitroActive = bool
end)

RegisterNetEvent('hud:client:UpdateHarness', function(harnessHp)
hp = harnessHp
end)

RegisterNetEvent('qb-admin:client:ToggleDevmode', function()
dev = not dev
end)

local prevPlayerStats = { nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil }

local function updatePlayerHud(data)
local shouldUpdate = false
for k, v in pairs(data) do
if prevPlayerStats[k] ~= v then
shouldUpdate = true
break
end
end
prevPlayerStats = data
if shouldUpdate then
SendNUIMessage({
action = 'hudtick',
show = data[1],
dynamicHealth = data[2],
dynamicArmor = data[3],
dynamicHunger = data[4],
dynamicThirst = data[5],
dynamicStress = data[6],
dynamicOxygen = data[7],
dynamicEngine = data[8],
dynamicNitro = data[9],
health = data[10],
playerDead = data[11],
armor = data[12],
thirst = data[13],
hunger = data[14],
stress = data[15],
voice = data[16],
radio = data[17],
talking = data[18],
armed = data[19],
oxygen = data[20],
parachute = data[21],
nos = data[22],
cruise = data[23],
nitroActive = data[24],
harness = data[25],
hp = data[26],
speed = data[27],
engine = data[28],
cinematic = data[29],
dev = data[30],
radioActive = data[31],
})
end
end

local prevVehicleStats = { nil, nil, nil, nil, nil, nil, nil, nil, nil, nil }

local function updateVehicleHud(data)
local shouldUpdate = false
for k, v in pairs(data) do
if prevVehicleStats[k] ~= v then
shouldUpdate = true
break
end
end
prevVehicleStats = data
if shouldUpdate then
SendNUIMessage({
action = 'car',
show = data[1],
isPaused = data[2],
seatbelt = data[3],
speed = data[4],
fuel = data[5],
altitude = data[6],
showAltitude = data[7],
showSeatbelt = data[8],
showSquareB = data[9],
showCircleB = data[10],
})
end
end

local lastFuelUpdate = 0
local lastFuelCheck = {}

local function getFuelLevel(vehicle)
local updateTick = GetGameTimer()
if (updateTick - lastFuelUpdate) > 2000 then
lastFuelUpdate = updateTick
lastFuelCheck = math.floor(exports['LegacyFuel']:GetFuel(vehicle))
end
return lastFuelCheck
end

-- HUD Update loop
-- UPDATED TO RESPECT THE HUD HIDDEN STATE
CreateThread(function()
local wasInVehicle = false
while true do
if Menu.isChangeFPSChecked then
Wait(500)
else
Wait(50)
end

    if LocalPlayer.state.isLoggedIn then
        local show = not hudHidden
        local player = PlayerPedId()
        local playerId = PlayerId()
        
        -- Check pause menu state
        local currentPauseState = IsPauseMenuActive()
        if currentPauseState ~= isPauseMenuActive then
            isPauseMenuActive = currentPauseState
            if isPauseMenuActive then
                show = false
            end
            DisplayRadar(shouldDisplayRadar())
        end

        -- If pause menu is active, hide HUD elements
        if isPauseMenuActive then
            show = false
            SendNUIMessage({
                action = 'hudtick',
                show = false
            })
            SendNUIMessage({
                action = 'car',
                show = false
            })
            Wait(100)
            goto continue
        end

        local weapon = GetSelectedPedWeapon(player)
        if not config.WhitelistedWeaponArmed[weapon] then
            if weapon ~= `WEAPON_UNARMED` then
                armed = true
            else
                armed = false
            end
        end

        playerDead = IsEntityDead(player) or PlayerData.metadata['inlaststand'] or PlayerData.metadata['isdead'] or false
        parachute = GetPedParachuteState(player)

        -- Stamina
        if not IsEntityInWater(player) then
            oxygen = 100 - GetPlayerSprintStaminaRemaining(playerId)
        end
        
        -- Oxygen
        if IsEntityInWater(player) then
            oxygen = GetPlayerUnderwaterTimeRemaining(playerId) * 10
        end

        local talking = NetworkIsPlayerTalking(playerId)
        local voice = 0
        if LocalPlayer.state['proximity'] then
            voice = LocalPlayer.state['proximity'].distance
        end

        local vehicle = GetVehiclePedIsIn(player)
        if not (IsPedInAnyVehicle(player) and not IsThisModelABicycle(vehicle)) then
            updatePlayerHud({
                show,
                Menu.isDynamicHealthChecked,
                Menu.isDynamicArmorChecked,
                Menu.isDynamicHungerChecked,
                Menu.isDynamicThirstChecked,
                Menu.isDynamicStressChecked,
                Menu.isDynamicOxygenChecked,
                Menu.isDynamicEngineChecked,
                Menu.isDynamicNitroChecked,
                GetEntityHealth(player) - 100,
                playerDead,
                GetPedArmour(player),
                thirst,
                hunger,
                stress,
                voice,
                LocalPlayer.state['radioChannel'],
                talking,
                armed,
                oxygen,
                parachute,
                -1,
                cruiseOn,
                nitroActive,
                harness,
                hp,
                math.ceil(GetEntitySpeed(vehicle) * speedMultiplier),
                -1,
                Menu.isCinematicModeChecked,
                dev,
                radioActive
            })
        end

        -- Vehicle HUD
        if IsPedInAnyHeli(player) or IsPedInAnyPlane(player) then
            showAltitude = true
            showSeatbelt = false
        end

        if IsPedInAnyVehicle(player) and not IsThisModelABicycle(vehicle) then
            if not wasInVehicle then
                wasInVehicle = true
                DisplayRadar(shouldDisplayRadar())
            end

            local engineHealth = GetVehicleEngineHealth(vehicle)
            if engineHealth ~= engineHealth then
                engineHealth = 0
            end

            updatePlayerHud({
                show,
                Menu.isDynamicHealthChecked,
                Menu.isDynamicArmorChecked,
                Menu.isDynamicHungerChecked,
                Menu.isDynamicThirstChecked,
                Menu.isDynamicStressChecked,
                Menu.isDynamicOxygenChecked,
                Menu.isDynamicEngineChecked,
                Menu.isDynamicNitroChecked,
                GetEntityHealth(player) - 100,
                playerDead,
                GetPedArmour(player),
                thirst,
                hunger,
                stress,
                voice,
                LocalPlayer.state['radioChannel'],
                talking,
                armed,
                oxygen,
                GetPedParachuteState(player),
                nos,
                cruiseOn,
                nitroActive,
                harness,
                hp,
                math.ceil(GetEntitySpeed(vehicle) * speedMultiplier),
                (engineHealth / 10),
                Menu.isCinematicModeChecked,
                dev,
                radioActive
            })

            updateVehicleHud({
                show,
                isPauseMenuActive,
                seatbeltOn,
                math.ceil(GetEntitySpeed(vehicle) * speedMultiplier),
                getFuelLevel(vehicle),
                math.ceil(GetEntityCoords(player).z * 0.5),
                showAltitude,
                showSeatbelt,
                showSquareB,
                showCircleB
            })

            showAltitude = false
            showSeatbelt = true
        else
            if wasInVehicle then
                wasInVehicle = false
                SendNUIMessage({
                    action = 'car',
                    show = false,
                    seatbelt = false,
                    cruise = false,
                })
                seatbeltOn = false
                cruiseOn = false
                harness = false
            end
            DisplayRadar(shouldDisplayRadar())
        end
        
        ::continue::
    else
        SendNUIMessage({
            action = 'hudtick',
            show = false
        })
        DisplayRadar(false)
    end
end

end)

-- Low fuel
CreateThread(function()
while true do
if LocalPlayer.state.isLoggedIn then
local ped = PlayerPedId()
if IsPedInAnyVehicle(ped, false) and not IsThisModelABicycle(GetEntityModel(GetVehiclePedIsIn(ped, false))) then
if exports['LegacyFuel']:GetFuel(GetVehiclePedIsIn(ped, false)) <= 20 then -- At 20% Fuel Left
if Menu.isLowFuelChecked then
TriggerServerEvent('InteractSound_SV:PlayOnSource', 'pager', 0.10)
QBCore.Functions.Notify(Lang:t('notify.low_fuel'), 'error')
Wait(60000) -- repeats every 1 min until empty
end
end
end
end
Wait(10000)
end
end)

-- Money HUD

local Round = math.floor

RegisterNetEvent('hud:client:ShowAccounts', function(type, amount)
if type == 'cash' then
SendNUIMessage({
action = 'show',
type = 'cash',
cash = Round(amount)
})
else
SendNUIMessage({
action = 'show',
type = 'bank',
bank = Round(amount)
})
end
end)

RegisterNetEvent('hud:client:OnMoneyChange', function(type, amount, isMinus)
cashAmount = PlayerData.money['cash']
bankAmount = PlayerData.money['bank']
SendNUIMessage({
action = 'updatemoney',
cash = Round(cashAmount),
bank = Round(bankAmount),
amount = Round(amount),
minus = isMinus,
type = type
})
end)

-- Harness Check

CreateThread(function()
while true do
Wait(1000)

    local ped = PlayerPedId()
    if IsPedInAnyVehicle(ped, false) then
        hasHarness(PlayerData.items)
    end
end

end)

-- Stress Gain

if not config.DisableStress then
CreateThread(function() -- Speeding
while true do
if LocalPlayer.state.isLoggedIn then
local ped = PlayerPedId()
if IsPedInAnyVehicle(ped, false) then
local veh = GetVehiclePedIsIn(ped, false)
local vehClass = GetVehicleClass(veh)
local speed = GetEntitySpeed(veh) * speedMultiplier
local vehHash = GetEntityModel(veh)
if config.VehClassStress[tostring(vehClass)] and not config.WhitelistedVehicles[vehHash] then
local stressSpeed
if vehClass == 8 then -- Motorcycle exception for seatbelt
stressSpeed = config.MinimumSpeed
else
stressSpeed = seatbeltOn and config.MinimumSpeed or config.MinimumSpeedUnbuckled
end
if speed >= stressSpeed then
TriggerServerEvent('hud:server:GainStress', math.random(1, 3))
end
end
end
end
Wait(10000)
end
end)

CreateThread(function() -- Shooting
    while true do
        if LocalPlayer.state.isLoggedIn then
            local ped = PlayerPedId()
            local weapon = GetSelectedPedWeapon(ped)
            if weapon ~= `WEAPON_UNARMED` then
                if IsPedShooting(ped) and not config.WhitelistedWeaponStress[weapon] then
                    if math.random() < config.StressChance then
                        TriggerServerEvent('hud:server:GainStress', math.random(1, 3))
                    end
                end
            else
                Wait(1000)
            end
        end
        Wait(0)
    end
end)

end

-- Stress Screen Effects

local function GetBlurIntensity(stresslevel)
for _, v in pairs(config.Intensity['blur']) do
if stresslevel >= v.min and stresslevel <= v.max then
return v.intensity
end
end
return 1500
end

local function GetEffectInterval(stresslevel)
for _, v in pairs(config.EffectInterval) do
if stresslevel >= v.min and stresslevel <= v.max then
return v.timeout
end
end
return 60000
end

CreateThread(function()
while true do
local ped = PlayerPedId()
local effectInterval = GetEffectInterval(stress)
if stress >= 100 then
local BlurIntensity = GetBlurIntensity(stress)
local FallRepeat = math.random(2, 4)
local RagdollTimeout = FallRepeat * 1750
TriggerScreenblurFadeIn(1000.0)
Wait(BlurIntensity)
TriggerScreenblurFadeOut(1000.0)

        if not IsPedRagdoll(ped) and IsPedOnFoot(ped) and not IsPedSwimming(ped) then
            SetPedToRagdollWithFall(ped, RagdollTimeout, RagdollTimeout, 1, GetEntityForwardVector(ped), 1.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0)
        end

        Wait(1000)
        for _ = 1, FallRepeat, 1 do
            Wait(750)
            DoScreenFadeOut(200)
            Wait(1000)
            DoScreenFadeIn(200)
            TriggerScreenblurFadeIn(1000.0)
            Wait(BlurIntensity)
            TriggerScreenblurFadeOut(1000.0)
        end
    elseif stress >= config.MinimumStress then
        local BlurIntensity = GetBlurIntensity(stress)
        TriggerScreenblurFadeIn(1000.0)
        Wait(BlurIntensity)
        TriggerScreenblurFadeOut(1000.0)
    end
    Wait(effectInterval)
end

end)

-- Minimap update
CreateThread(function()
while true do
SetBigmapActive(false, false)
SetRadarZoom(1000)
Wait(500)
end
end)

local function BlackBars()
DrawRect(0.0, 0.0, 2.0, w, 0, 0, 0, 255)
DrawRect(0.0, 1.0, 2.0, w, 0, 0, 0, 255)
end

CreateThread(function()
local minimap = RequestScaleformMovie('minimap')
if not HasScaleformMovieLoaded(minimap) then
RequestScaleformMovie(minimap)
while not HasScaleformMovieLoaded(minimap) do
Wait(1)
end
end
while true do
if w > 0 then
BlackBars()
DisplayRadar(0)
SendNUIMessage({
action = 'hudtick',
show = false,
})
SendNUIMessage({
action = 'car',
show = false,
})
end
Wait(0)
end
end)

-- Compass
function round(num, numDecimalPlaces)
local mult = 10 ^ (numDecimalPlaces or 0)
return math.floor(num + 0.5 * mult)
end

local prevBaseplateStats = { nil, nil, nil, nil, nil, nil, nil }

local function updateBaseplateHud(data)
local shouldUpdate = false
for k, v in pairs(data) do
if prevBaseplateStats[k] ~= v then
shouldUpdate = true
break
end
end
prevBaseplateStats = data
if shouldUpdate then
SendNUIMessage({
action = 'baseplate',
show = data[1],
street1 = data[2],
street2 = data[3],
showCompass = data[4],
showStreets = data[5],
showPointer = data[6],
showDegrees = data[7],
})
end
end

local lastCrossroadUpdate = 0
local lastCrossroadCheck = {}

local function getCrossroads(player)
local updateTick = GetGameTimer()
if updateTick - lastCrossroadUpdate > 1500 then
local pos = GetEntityCoords(player)
local street1, street2 = GetStreetNameAtCoord(pos.x, pos.y, pos.z)
lastCrossroadUpdate = updateTick
lastCrossroadCheck = { GetStreetNameFromHashKey(street1), GetStreetNameFromHashKey(street2) }
end
return lastCrossroadCheck
end

-- Compass Update loop

CreateThread(function()
local lastHeading = 1
local heading
while true do
if Menu.isChangeCompassFPSChecked then
Wait(50)
else
Wait(0)
end
local show = true
local player = PlayerPedId()
local camRot = GetGameplayCamRot(0)
if Menu.isCompassFollowChecked then
heading = tostring(round(360.0 - ((camRot.z + 360.0) % 360.0)))
else
heading = tostring(round(360.0 - GetEntityHeading(player)))
end
if heading == '360' then heading = '0' end
if heading ~= lastHeading then
if IsPedInAnyVehicle(player) then
local crossroads = getCrossroads(player)
SendNUIMessage({
action = 'update',
value = heading
})
updateBaseplateHud({
show,
crossroads[1],
crossroads[2],
Menu.isCompassShowChecked,
Menu.isShowStreetsChecked,
Menu.isPointerShowChecked,
Menu.isDegreesShowChecked,
})
else
if Menu.isOutCompassChecked then
SendNUIMessage({
action = 'update',
value = heading
})
SendNUIMessage({
action = 'baseplate',
show = true,
showCompass = true,
})
else
SendNUIMessage({
action = 'baseplate',
show = false,
})
end
end
end
lastHeading = heading
end
end)

NEW SERVER CODE:

local QBCore = exports['qb-core']:GetCoreObject()
local ResetStress = false
local hiddenStates = {} -- Added Variable to track hud toggle state (On/Off)

QBCore.Commands.Add('cash', 'Check Cash Balance', {}, false, function(source, _)
local Player = QBCore.Functions.GetPlayer(source)
local cashamount = Player.PlayerData.money.cash
TriggerClientEvent('hud:client:ShowAccounts', source, 'cash', cashamount)
end)

QBCore.Commands.Add('bank', 'Check Bank Balance', {}, false, function(source, _)
local Player = QBCore.Functions.GetPlayer(source)
local bankamount = Player.PlayerData.money.bank
TriggerClientEvent('hud:client:ShowAccounts', source, 'bank', bankamount)
end)

QBCore.Commands.Add('dev', 'Enable/Disable developer Mode', {}, false, function(source, _)
TriggerClientEvent('qb-admin:client:ToggleDevmode', source)
end, 'admin')

RegisterNetEvent('hud:server:GainStress', function(amount)
if Config.DisableStress then return end
local src = source
local Player = QBCore.Functions.GetPlayer(src)
local Job = Player.PlayerData.job.name
local JobType = Player.PlayerData.job.type
local newStress
if not Player or Config.WhitelistedJobs[JobType] or Config.WhitelistedJobs[Job] then return end
if not ResetStress then
if not Player.PlayerData.metadata['stress'] then
Player.PlayerData.metadata['stress'] = 0
end
newStress = Player.PlayerData.metadata['stress'] + amount
if newStress <= 0 then newStress = 0 end
else
newStress = 0
end
if newStress > 100 then
newStress = 100
end
Player.Functions.SetMetaData('stress', newStress)
TriggerClientEvent('hud:client:UpdateStress', src, newStress)
TriggerClientEvent('QBCore:Notify', src, Lang:t('notify.stress_gain'), 'error', 1500)
end)

RegisterNetEvent('hud:server:RelieveStress', function(amount)
if Config.DisableStress then return end
local src = source
local Player = QBCore.Functions.GetPlayer(src)
local newStress
if not Player then return end
if not ResetStress then
if not Player.PlayerData.metadata['stress'] then
Player.PlayerData.metadata['stress'] = 0
end
newStress = Player.PlayerData.metadata['stress'] - amount
if newStress <= 0 then newStress = 0 end
else
newStress = 0
end
if newStress > 100 then
newStress = 100
end
Player.Functions.SetMetaData('stress', newStress)
TriggerClientEvent('hud:client:UpdateStress', src, newStress)
TriggerClientEvent('QBCore:Notify', src, Lang:t('notify.stress_removed'))
end)

QBCore.Functions.CreateCallback('hud:server:getMenu', function(_, cb)
cb(Config.Menu)
end)

local function ToggleHudForPlayer(source, shouldHide)
TriggerClientEvent('qb-hud:client:ToggleHud', source, shouldHide)
end

exports('ToggleHudForPlayer', ToggleHudForPlayer)

QBCore.Commands.Add('togglehud', 'Toggle HUD visibility', {}, false, function(source)
hiddenStates[source] = not hiddenStates[source]
if hiddenStates[source] then
TriggerClientEvent('QBCore:Notify', source, 'HUD Hidden', 'error')
else
TriggerClientEvent('QBCore:Notify', source, 'HUD Visible', 'success')
end

-- Trigger the client event to actually toggle the HUD
TriggerClientEvent('qb-hud:client:ToggleHud', source)

end)

-- Add player cleanup when they disconnect
AddEventHandler('playerDropped', function()
local source = source
hiddenStates[source] = nil
end)

[Alivemonstor]

please instead make a pull request rather than an issue if you're looking to add code to the repo

[LawProductions]

please instead make a pull request rather than an issue if you're looking to add code to the repo

I tried to make a pull request but for some reason it has not let me.

[LawProductions]

Wait nvm, Got it to work apologies. working on it now.