Skip to content

Theming ​

One brand colour themes the whole HUD. The NUI derives the tile ramp, accents and tinted glass from it.

All themes

Strength ​

StrengthWhat gets the brand colour
accentProgress bars, route and accent lines only
tiles+ the brand tiles
glass+ a tint on the glass surfaces

Server default ​

lua
Config.Theme = { brand = '#4f7bff', strength = 'tiles' }  -- brand = nil → neutral grey

At runtime ​

lua
exports.np_hud:SetTheme('#4f7bff', 'tiles')
exports.np_hud:SetTheme(nil)   -- back to neutral

You can theme per job or per event, for example blue tiles while on duty as police. A runtime theme stays active until the next hud:config that carries a theme.

Player preview ​

/hudtheme <#hex|reset|none> [accent|tiles|glass] previews a theme for the player who runs it only.

Design system ​

The visuals come from Nimbus UI in np_hud/design/: tokens, component CSS and preview pages. The NUI imports it unchanged. Read design/README.md before changing the look.

Design previews

ColoursIcon tilesLevel tilesMap and statusVehicleType

np_* FiveM resources