Skip to main content

What is FR Hub?

FR Hub (v1.5.4) is FiveRank's free HUD for FiveM. It completely replaces GTA V's native status bar with a modern, clean, and highly configurable interface designed from day one for roleplay servers.

A HUD that adapts to the server, not the other way around.


What's included?

8 animated stat rings

Each ring displays a stat in real time with a smooth circular fill animation:

RingDataRequires
❤️ HealthCharacter health %GTA native
🛡️ ArmorEquipped armor %GTA native
🍖 HungerHunger levelESX / QBCore / QBox
💧 ThirstThirst levelESX / QBCore / QBox
🧠 StressStress levelQBCore / QBox
StaminaSprint enduranceGTA native
🌊 OxygenSubmersion timeGTA native (only while underwater)
🎙️ VoiceActive proximity levelpma-voice

Rings without available data are automatically hidden to preserve the HUD layout.


Floating speedometer + speed limiter

Appears only for the driver when entering any vehicle (passengers see only the stat rings):

  • Speed — km/h or mph (configurable).
  • Gear — from R to 8th, updated every 50 ms.
  • Fuel — auto-detects ps-fuel, LegacyFuel, ox_fuel, qs-fuel, cdn-fuel, hfuel, or the native system. Orange LED + chime at ≤20% (reserve warning).
  • Seatbelt — visual indicator + progressive warning sound + proportional ejection on impact without a seatbelt.
  • Speed limiter — press LSHIFT (configurable, rebindable in FiveM Settings) to lock the current speed as the maximum. Active red chip when engaged. Press again to release. Disables automatically when changing or exiting a vehicle.

Live location info

Visible at all times (configurable from /hub):

  • Street — current street name.
  • Zone — map zone (Vinewood, Sandy Shores…).
  • Compass — cardinal direction (N, NE, E, SE, S, SW, W, NW).
  • Clock — in-game time (hour:minute).

Circular minimap

Replaces GTA V's native rectangular minimap. Includes stream files (minimap.gfx, minimap.ytd, circlemap.ytd) that remove the vehicle health/armor bars directly in the scaleform. Visibility modes: Always / In vehicle only / Never (configurable from /hub).


Functional weapon and radio wheels

The native HUD suppression still allows the weapon wheel (TAB) and radio wheel (Q) to work correctly. FR Hub intelligently re-enables DisplayHud while those keys are held.


Native crosshair + ammo counter

When equipping any weapon (except fists) or aiming/firing, FR Hub automatically re-enables the native GTA crosshair and weapon icon + bullet counter. They hide again when the weapon is holstered. No extra configuration required.


Live settings panel (/hub)

The /hub command opens an overlay panel where each player can configure:

  • Which rings to show.
  • Speed units (km/h / mph).
  • Speed limiter: enable/disable.
  • Minimap visibility: always / in vehicle / never.
  • Location info: clock, compass, enable/disable.
  • Server logo: show/hide.
  • HUD language (es/en/pt/fr/de).

Changes are saved per player with SetResourceKvp (KVP) — no database, no SQL tables.


Commands

CommandAction
/hudInstantly hides or shows the entire HUD.
/hubOpens the personal settings panel.
B keyFastens/unfastens the seatbelt (rebindable in FiveM Settings → Key Bindings).
LSHIFT keyActivates/deactivates the speed limiter (rebindable).

Technical specs

Multi-frameworkAuto-detects ESX, QBCore, qbx_core and standalone.
5 official languagesES, EN, PT, FR, DE — changeable per player from /hub.
No dependenciesNo MySQL, no ox_lib, no external requirements.
Per-player persistenceNative FiveM KVP.
Speed limiterConfigurable: key, minimum km/h, enable/disable.
Physical seatbeltProportional ejection based on deceleration delta.
Fuel warningOrange LED + sound at ≤20%.
Location infoStreet, zone, compass, clock — toggleable from /hub.
Native wheelsWeapons (TAB) and radio (Q) work without conflicts.
Crosshair + ammoNative reticle and bullets visible when equipping a weapon.
Stream assetsminimap.gfx + circlemap.ytd remove vehicle bars.
Driver onlySpeedometer shown only for the driver; passengers see rings.
Custom brandingSVG/PNG/WEBP logo + server label.
100% client-sideNo server load.

Compatibility with other FiveRank resources

FR Hub is compatible and coexists without conflicts with:

  • fiverank_guard — web staff panel.
  • fiverank_intro — welcome screen.
  • fiverank_deck — cinematic pause menu.
  • fr_vehicle_aim — first-person aim in vehicles.

About FiveRank

FR Hub is a free release by the FiveRank team for the FiveM community.

Next step

Installation