The settings panel is part of the NUI. Open it with the key from Config.OpenMenu (default I) or with /hudmenu. Close it with the × button or Escape. While it is open the HUD has NUI focus with the cursor visible.
The switch labels come from the option_* keys in locales/<code>.lua, so they follow the language set in the config. The tables below use the default English labels; with Config.Locale = 'pl' the same switches read in Polish.
Actions
| Button | Effect |
|---|
| Restart HUD | Closes the menu and runs the same sequence as /resethud: a "restarting" notification, every change cache is cleared, the settings and the config message are sent to the NUI again and the minimap is set up, then a "HUD started" notification. There are no artificial delays |
| Restore defaults | Deletes the gta6_hud_settings KVP, reloads every switch from Config.Menu (which also switches cinematic mode off if it was on), pushes them to the NUI and re-runs the minimap setup |
Map
| Label | Effect |
|---|
| Show minimap outside vehicles | Keeps the radar on while on foot. Off by default, so the radar shows only while driving |
| Hide minimap in vehicles | Turns the radar off while driving |
Compass
| Label | Effect |
|---|
| Show compass outside vehicles | Shows the strip on foot, without street names |
| Compass follows the camera | Heading from the gameplay camera instead of the ped |
| Direction strip | Shows or hides the N / E / S / W ruler |
| Street names | Shows or hides the two street names |
| Pointer | The pink centre marker on the strip |
| Degrees | The numeric heading between the street names |
| Compass in power saving mode | Samples the heading every 50 ms instead of every frame |
Status bars: hide when full
| Label | Effect |
|---|
| Health (hide in vehicle when full) | On: inside a vehicle the bar follows the timeout and threshold rules from the config. Off: the bar is always visible, the same as Config.ShowFullHealthInVehicle |
| Armor (hide when 0) | On: hidden at 0 armour. Off: always visible |
| Stamina and oxygen | On: hidden at 100. Off: always visible |
| Hunger | On: the timeout and ≤ 30 rules apply. Off: always visible |
| Thirst | Same as hunger |
| Stress (hide when 0) | On: the timeout and ≥ 75 rules apply. Off: always visible |
Vehicle
| Label | Effect |
|---|
| Whole HUD in power saving mode | Player and vehicle data every 500 ms instead of 50 ms. It slows the whole player loop, not just the speedometer. The navigation pill has its own thread and is not affected |
| Engine: hide when healthy | On: the engine chip is faded above 95% health. Off: always highlighted with the ring |
| Nitro: hide when empty | On: nitro bar only above 0. Off: also at 0 |
| Low fuel alert | Enables the notification at ≤ 20% fuel |
Sounds and notifications
Sounds are played through interact-sound (server event InteractSound_SV:PlayOnSource) and are skipped silently when that resource is not running.
| Label | Effect |
|---|
| Menu open sound | monkeyopening on open, catclosing on close |
| HUD reset sound | airwrench on restart and restore |
| Toggle sound | shiftyclick on every switch |
| Cinematic mode notifications | Sends the cinematic_on / cinematic_off locale string when cinematic mode changes |
Cinematic mode
| Label | Effect |
|---|
| Enable cinematic mode | Black bars across the top and bottom tenth of the screen, radar off, HUD elements hidden. Saved with the other settings, so it survives a reconnect until switched off |
Where the settings are stored
Every change writes the whole switch table as JSON to the client-side KVP gta6_hud_settings. The NUI reports itself ready with the nuiReady callback as soon as the page has loaded, and the HUD answers by reading that KVP and pushing every value plus the config message. The adapters repeat this two seconds after the player loads. Without a KVP the values from Config.Menu are used. There is no server-side storage.
