np_hud v0.1.0
A FiveM HUD built on the Nimbus UI design system: glossy grey squircle tiles, frosted glass lit from above, and Quicksand type.
It covers status tiles, voice, street and compass, a glass frame around the native minimap, a vehicle zone (speedometer, fuel, engine, seatbelt), a weapon card, a hotbar, toasts with key actions, interaction prompts, progress bars and server theming from one brand colour.
| In a vehicle | On foot |
|---|---|
 |  |
Theme: blue, tiles | Theme: violet, glass |
 |  |
At a glance
- Nothing is required: no database, no framework, no streamed assets.
- Frameworks: qbx / qb / esx, auto-detected, or standalone.
- Voice: pma-voice / saltychat / yaca, auto-detected, or none.
- Fuel: ox_fuel, LegacyFuel, cdn-fuel, ps-fuel, or the native fuel level.
- Replaces your framework's notify and progress bar, through exports or a few-line patch.
- Performance: each loop runs only while it has something to do (the vehicle loop only in a vehicle, the weapon loop only while armed).
Standalone vs framework
| Standalone | With qbx / qb / esx | |
|---|---|---|
| Health, armour, stamina, oxygen | ✓ | ✓ |
| Voice, street, compass, clock, weather, players | ✓ | ✓ |
| Vehicle, weapon, hotbar, notifications | ✓ | ✓ |
| Money, job | – | ✓ |
| Hunger, thirst | – | ✓ (ESX needs esx_status) |
| Stress | – | qbx / qb, ESX only with a stress status |
Quick example
lua
exports.np_hud:Notify('Saved', 'Your outfit was saved.', 'success', 3000)
exports.np_hud:ShowPrompt({ id = 'atm', icon = 'credit-card', keys = { { key = 'E', label = 'Use ATM' } } })
local ok = exports.np_hud:Progress({ label = 'Lockpicking', icon = 'unlock-keyhole', duration = 5000 })