NC-HUD
A fully customizable, theme-based HUD for FiveM.
Forked from Afterlife-HUD and reworked with new features, multi-framework support, and an external theme system.
Open Source — Licensed under GPL v3
Overview
NC-HUD replaces the default GTA HUD with a modern React-based UI featuring draggable components, multiple layout modes, and a powerful theme system that lets external resources completely override HUD components.
Key Features
- Player Stats — Health, Armor, Hunger, Thirst, Oxygen, Stress (SVG fill indicators)
- Player Info — Server ID, In-game Time, Job, Cash & Bank balance
- Speedometer — Speed (km/h or mph), RPM bar, Fuel gauge, Waypoint distance, Vehicle status bars
- Vehicle Status Icons — Seatbelt, Headlights, Turn Signals, Hazard Lights, Engine, Door Lock, Handbrake
- Minimap — Circular minimap overlay with compass directions, street name + postal code
- Compass — Directional heading with nearest postal code
- Weapon HUD — Weapon name, ammo count (magazine / reserve), auto-hide on holster
- Crosshair — Custom crosshair overlay when aiming
- Heart Rate System — Dynamic heart rate based on sprinting, driving, damage, and deceleration
- Drag & Edit Mode — Freely reposition all HUD components
- Layout Modes — Combined (grouped) or Separate (individual positioning)
- In-game Settings Panel — Toggle elements, adjust layout, select themes (keybind:
I) - Theme System — External resources can register custom themes via exports
- Electric Vehicle Support — Auto-detection with speed-based RPM simulation
- Stungun Ammo System — Custom ammo counter with recharge mechanic
- Per-Server Settings — Positions and preferences saved per-server via KVP
Multi-Framework Support
| Framework | Resource |
|---|---|
| QBCore | qb-core |
| QBox | qbx_core |
| ESX | es_extended |
| Ox Core | ox_core |
| Standalone | — |
Framework is auto-detected, no manual configuration needed.
Requirements
| Resource | Required |
|---|---|
| ox_lib | ✅ |
| Framework (any above) | ✅ (one of) |
Quick Start
ensure ox_lib
ensure nc-hud
Links
- GitHub: github.com/noxcore/nc-hud
- Discord: discord.gg/noxcore
Changelog
v1.1.0 — March 4, 2026
- Speedometer MPH Fix — Corrected mph conversion factor from
2.2to2.23694inmodules/speedometer.luafor accurate speed display (previously ~1.7% off). - nc-carcontrol Compatibility — Works alongside nc-carcontrol cruise control; both reference the same speed conversion standards.
Credits
- Original: AfterLifeStudio/Afterlife-Hud
- Rework: NOX (discord.gg/noxcore)
Last updated: March 4, 2026