Common Errors

Common Errors — Interface | Quasar Store | Quasar Store

The HUD never appears after spawning

Interface starts when the framework reports the character as loaded — esx:playerLoaded or QBCore:Client:OnPlayerLoaded — or through qs-multicharacter. A multicharacter or spawn selector that skips those events should call exports['qs-interface']:Initialize() once the player is in the world. /openui confirms the HUD itself works.

The first-time setup cannot be clicked, or sits under another screen

Another UI holds the mouse — usually a loading screen that never closed, or a spawn menu. Close it before calling Initialize, or set Config.SkipFirstTimeHudSetup = true so players start on the default HUD and use F9 later.

Two HUDs, or the old bars still show

Another HUD resource is still running — esx_hud, qb-hud, ps-hud or a speedometer. Remove it from server.cfg; it may also be started by a category folder.

A widget was dragged off-screen

/resethud puts every widget back without touching the styles.

Hunger and thirst always show 0

On ESX they come from esx_status (with esx_basicneeds); make sure both run. On QBCore they come from the player's metadata, which needs the core's standard hud:client:UpdateNeeds event. A custom needs system is wired in getStatus in the client bridge.

The fuel gauge is stuck or wrong

Without a supported fuel script, the vehicle's native level is read. A script that stores fuel elsewhere needs a one-function bridge — see Integrations. If yours is supported, make sure it starts before qs-interface.

The voice ring never changes size

Interface fell back to standalone voice: pma-voice or saltychat started after it, or is renamed. Fix the start order or add the name to voiceChatList.

The minimap disappears on foot, or its frame does not line up

Hiding the minimap on foot is Config.HideRadar. For a frame that sits off the map, adjust Config.MapBorder for that shape. For a frame shown or hidden at the wrong time, type qs_mapdebug in the F8 console: it prints every condition it checked — often another script hiding the radar, which SetMapBorderVisible can follow.

Stress never rises

It ships off: set Config.Stress = true. Jobs in Config.DisableJobsStress never gain it, so test it as a civilian. On ESX, the stress column must exist — import esx.sql.

Every player's HUD reset after a restart

Config.InitEditorEveryTime is on, or qs:showcase is set to true — showcase mode forgets the HUD at every login. Layouts are otherwise kept by each player's game client, so clearing the FiveM cache also clears them.

Installation and Start-up#

Common Errors

Installation and Start-up#

The HUD#

The Chat#

VIP Tags and Logs#