F5 StudioF5 Studio
Skip to main content

Troubleshooting

HUD does not appear at all​

Possible causes

  • The framework was not detected, so nothing feeds the HUD, or the framework's "player loaded" event fired before the resource was ready.
  • Another HUD is still running, or the pause menu / cinematic mode is active.

Fix

  1. Make sure gta6_hud starts after qb-core, qbx_core or es_extended. Detection runs once at start and prints a warning to the client console when it finds nothing.
  2. Stop qb-hud, qbx_hud or esx_hud.
  3. Run /resethud. If the HUD comes back, the start order was the problem.
  4. Open /hudmenu and make sure "Włącz tryb kinowy" (cinematic mode) is off.

Hunger, thirst or stress stay at 100 / 0​

QBCore: the values come from player metadata and the hud:client:UpdateNeeds / hud:client:UpdateStress events sent by qb-core and qb-smallresources. Check that those resources run and that the HUD started after qb-core.

QBox: the values come from the hunger, thirst and stress state bags on the player. If your qbx resources use different keys, adapt client/adapter_qbx.lua.

ESX: hunger and thirst come from esx_status:onTick. Make sure esx_status is running; set only Config.Display = false there, do not stop the resource. Stress does not exist on ESX.

Money block never shows​

The block is only visible during a balance change and for a few seconds after /cash or /bank. That is the intended GTA VI behaviour. On ESX there are no commands; the block appears only when an account balance changes.

Minimap is the default GTA V shape, or two masks flicker​

Possible causes

  • gta6_minimap is running next to gta6_hud, so two resources stream the same minimap.gfx, minimap.ytd and gta6_graphics.ytd.
  • Another resource resets the radar (SetMinimapComponentPosition, DisplayRadar) after this one.
  • The gta6_graphics texture dictionary did not load within 5 s.

Fix

  1. Stop gta6_minimap.
  2. Restart the resource (restart gta6_hud), which re-runs the minimap setup.
  3. Disable the minimap handling in the other HUD.

Minimap is not visible on foot​

By design. Turn on "Minimapa widoczna także poza pojazdem" in /hudmenu.

Seatbelt or cruise control never change (ESX)​

esx_cruisecontrol calls the SeatbeltState and CruiseControlState exports on the resource named in its config. Set HudResource = 'gta6_hud' in esx_cruisecontrol/config.lua and restart both resources.

Fuel is always 100% or wrong​

The HUD first tries exports['LegacyFuel']:GetFuel(vehicle). If your fuel script is neither LegacyFuel nor declares provide 'LegacyFuel', the HUD reads GetVehicleFuelLevel, which some fuel scripts do not keep in sync. Either add the provide line to your fuel resource or change the export call in client/player.lua (function getFuelLevel).

Money and ammo use a fallback font​

Pricedown is loaded from fonts.cdnfonts.com and Inter from Google Fonts at runtime. If the client cannot reach those hosts, the NUI falls back to Impact and Segoe UI. Both stylesheet links sit after app.js, so an unreachable host only delays the font, never the HUD itself. Allow the hosts, or bundle the fonts in html/fonts and point index.html / style.css at the local files.

Notifications from the HUD do not show​

HUD.Notify sends to exports.gta6_notify:Notify whenever gta6_notify is started, on every framework. Only when that resource is missing or stopped does it fall back to the framework's notify function (QBCore.Functions.Notify, exports.qbx_core:Notify, ESX.ShowNotification), and without a framework it then does nothing.

So if the HUD's own notifications look like the framework's cards, gta6_notify is not running. Check the server console for its start-up and run /gta6notify success to confirm.

The navigation pill shows no distance​

By design, and only for the instructions "Keep Straight" and "Follow the route". The native measures the distance to the next junction, not to the next manoeuvre, so on a straight road it counts down to zero at every side street. A distance is shown only for real turns.

Stress does not go up​

  • Config.DisableStress must be false.
  • Stress exists on QBCore and QBox only.
  • A job type or name in Config.WhitelistedJobs (leo, ambulance by default) never gains stress.
  • Driving stress needs a vehicle class enabled in Config.VehClassStress and the speed threshold in the unit selected by Config.UseMPH.

Sounds go through interact-sound. Without it the HUD skips them silently. The sound names (monkeyopening, catclosing, shiftyclick, airwrench) must exist in that resource.

Weapon block missing or native counter visible​

  • Config.CustomWeaponHud must be true; false unloads client/weapon.lua and shows the native counter.
  • gta6_weaponhud must not run next to gta6_hud.
  • A weapon without an icon shows only numbers; add its spawn name to Config.WeaponIcons and a PNG to html/weapons.

Still need help?​