Skip to main content

Common issues

The HUD doesn't appear when I connect​

  • Check that the resource is running: restart fr_hub and look at the console — it should show [fr_hub] v1.5.4 — FiveRank HUD ready.
  • Make sure the ensure fr_hub line is in your server.cfg and is placed after your framework.
  • If you have another HUD active (esx_hud, qb-hud, nh-hud…), disable it — only one HUD can run at a time.

Hunger / thirst / stress rings always appear empty or at 0​

  • Hunger and thirst only work with ESX, QBCore or QBox. In standalone mode they are hidden automatically.
  • Stress only works with QBCore or QBox.
  • If you are using one of those frameworks and the value is still 0, check that Config.Framework is not forced to 'standalone'.

The voice ring doesn't appear or is always at max​

  • The voice ring requires pma-voice. If you use another voice system (mumble-voip, saltychat…) the ring will not receive data and will be hidden.
  • Confirm that pma-voice is started before fr_hub in your server.cfg.

The speedometer always shows 0% fuel​

Auto-detection failed. Specify your fuel script in config.lua:

Config.FuelScript = 'ps-fuel'  -- or 'LegacyFuel', 'ox_fuel', etc.

If you don't use any fuel script, set 'native' to use GTA's native system (will always show 100%).

The seatbelt doesn't work​

  • Check that Config.Seatbelt.enabled = true.
  • Ejection only occurs when the speed at the moment of impact exceeds Config.Seatbelt.ejectSpeed. Try lowering that value to confirm it works.
  • If you see the seatbelt indicator but ejection doesn't happen, another resource may be capturing the collision events first.

The minimap is still rectangular / I see the GTA vehicle health bars​

  • The native bars are hidden when the player is in a vehicle with fr_hub active. If you still see them, another resource may be restoring them.
  • Search your resources for calls to DisplayRadar, DisplayHud or SetRadarBigmapEnabled that may be interfering.

The /hub panel doesn't open​

  • Check that the hub command is not being captured by another resource. If there is a conflict, change the command name in client/menu.lua (line RegisterCommand('hub', ...)).
  • Restart the resource after making the change.

The HUD language doesn't change​

  • Confirm that Config.Locale in config.lua is one of es | en | pt | fr | de (lowercase).
  • Restart the resource: restart fr_hub.
  • If a player has a language saved in their KVP, that takes priority. The player can reset it by opening /hub → Settings.

Console error: attempt to index a nil value (global 'ESX')​

The ESX bridge initialised before ESX was ready. Make sure ensure fr_hub appears after ensure es_extended in server.cfg.

Console error: fr_hub: framework bridge not found​

Config.Framework is forced to a framework that is not installed. Change it to 'auto' or set it to the framework you actually have.

Still having issues?​

Open a ticket from the panel (fiverank.gg/support)
or join the Discord.