HUD · QBCore Framework

qb-hud

QBCore's bundled HUD — the default status icons, speedometer and minimap frame on a stock install.

qb-hud is what a fresh QBCore server shows before anybody changes anything. It is deliberately plain, which makes it a good baseline and a common first thing to replace. It matters here because it owns the area immediately around the minimap and because its settings decide whether the map is drawn at all in certain states.

Official documentation Repository All resources

Why servers run it

It is already installed and it works.
Small and readable, so it is an easy first script to edit while learning.
Its minimap handling is a useful reference for how the radar is shown and hidden.

Installing qb-hud

1. It is already there
Stock QBCore ships it. ensure after qb-core.
2. Replace rather than stack
If you install ps-hud or another HUD, stop qb-hud first.

Working examples

Hiding the radar cleanly

-- The radar is a HUD component, not part of the map resource.
DisplayRadar(false)     -- hide
DisplayRadar(true)      -- show

What goes wrong

DisplayRadar(false) somewhere in a script is the usual reason a minimap 'disappeared' after installing something unrelated.

Editing config.lua then restarting only qb-hud is fine — this one does not live in qb-core's shared tables.

qb-hud — questions people ask

Why did my minimap vanish after installing a script?

Something called DisplayRadar(false) and never turned it back on. It is usually a loading, cutscene or death script. Search your resources for DisplayRadar.

Runs alongside

ps-hud

The most widely installed custom HUD on QBCore servers: circular status rings, a compass, a speedometer and a minimap frame that matches them.

qb-core (QBCore)

The roleplay framework most new FiveM servers are built on, with the largest modern script ecosystem and a one-click txAdmin recipe.