Features
NC-HUD provides a comprehensive set of HUD components, fully customizable with drag-and-drop positioning and theme support.
Component Preview
| Player Stats | Player Info | Speedometer |
|---|---|---|
 |
 |
 |
HUD Components
Player Stats
Health, Armor, Hunger, Thirst, Oxygen, Stress — displayed as icon-based SVG fill indicators with smooth animations.
Player Info
Server ID, In-game Time, Job (with grade), Cash & Bank balance — updates in real-time.
Speedometer
- Speed display (km/h or mph, toggleable)
- RPM bar with smooth interpolation
- Fuel gauge (supports 12+ fuel resources)
- Waypoint distance indicator
- Vehicle health bars (engine, body)
- Electric vehicle auto-detection with speed-based RPM simulation
Vehicle Status Icons
- Seatbelt (with flythrough windscreen protection)
- Headlights (off / on / high beam)
- Turn Signals (left / right)
- Hazard Lights
- Engine status
- Door Lock
- Handbrake
Minimap
Circular or square minimap overlay with compass directions, tick marks, and a location bar showing street name + postal code.
Compass
Directional heading (N/NE/E/SE/S/SW/W/NW) with nearest postal code display.
Weapon HUD
Current weapon name, ammo count (magazine / reserve), auto-hide when holstered. Includes custom crosshair overlay when aiming.
Heart Rate System
Dynamic heart rate simulation based on:
- Sprinting / cycling stamina
- Driving speed and sudden deceleration
- Damage taken
- Configurable parameters (base rate, spike thresholds, rise/fall speed)
Customization & Layout
In-game Settings Panel
Toggle individual HUD elements, adjust layout modes, and select themes via keybind (I).
Drag & Edit Mode
Freely reposition all HUD components via drag-and-drop. Positions are saved per-server.
Layout Modes
- COMBINED — Stats + Info grouped together
- SEPARATE — Each stat/info item individually positioned
Per-Server Settings
All positions and preferences saved per-server using KVP storage. Different settings on different servers.
Integrations
Multi-Framework Support
| Framework | Resource | Auto-Detected |
|---|---|---|
| QBCore | qb-core |
✅ |
| QBox | qbx_core |
✅ |
| ESX | es_extended |
✅ |
| Ox Core | ox_core |
✅ |
| Standalone | — | ✅ |
Fuel Systems
LegacyFuel, ox_fuel, ps-fuel, cdn-fuel, lj-fuel, okokGasStation, ti_fuel, myFuel, x-fuel, BigDaddy-Fuel, hyon_gas_station, or custom function.
Voice Systems
pma-voice, mumble-voip, saltychat, tokovoip, or custom event.
Death Detection
wasabi_ambulance, qb-ambulancejob, esx_ambulancejob, or custom function.
Notifications
ox_lib, QBCore, ESX, or custom function.
Theme System
External resources can register custom themes that completely override built-in HUD components.
- Register via
exports['nc-hud']:RegisterTheme() - Replace specific components (Stats, Info, Speedometer, Minimap, Compass, Weapon, Crosshair)
- Themes receive data via client events
- Dynamic load/unload on resource start/stop
See the Exports & Theme API page for details.
Stungun Ammo System
Custom ammo counter with automatic recharge:
- Configurable max ammo (default: 2)
- Auto-recharge after cooldown (default: 15 seconds)
- Notification on full recharge
Last updated: March 4, 2026