> For the complete documentation index, see [llms.txt](https://zloma-scripts.gitbook.io/zloma-scripts/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://zloma-scripts.gitbook.io/zloma-scripts/zloma_hud-free-escrow/features.md).

# Features

## HUD Modules

zloma\_hud includes these main modules:

| Module           | Description                                                               |
| ---------------- | ------------------------------------------------------------------------- |
| Player status    | Health, armor, hunger, thirst, stress, and voice activity                 |
| Compass          | Direction and street/cross street display                                 |
| Server info      | Logo, player ID, time, ping, job, cash, and bank                          |
| Vehicle HUD      | Speed, RPM, fuel, gear, engine, seatbelt, headlights, cruise, and mileage |
| Weapon HUD       | Current weapon image, name, clip ammo, reserve ammo, and durability       |
| Radio HUD        | Radio channel and radio talking indicator                                 |
| Vehicle controls | Engine, lights, seatbelt, cruise, seats, doors, windows, hood, and trunk  |
| Minimap          | Custom radar assets and configurable visibility                           |

***

## In-Game Settings

Default command:

```
/hud
```

Players can configure:

* color theme
* car HUD style
* 3D perspective angle
* module visibility
* server info parts
* food/water/stress visibility modes
* layout position and scale

The layout editor supports dragging widgets and scrolling to scale them.

***

## Weapon HUD

The weapon HUD shows:

* weapon image
* weapon name
* clip ammo
* reserve ammo
* durability bar when inventory metadata is available

Durability support:

| Inventory      | Metadata                                                             |
| -------------- | -------------------------------------------------------------------- |
| `ox_inventory` | Reads current weapon metadata durability                             |
| `qb-inventory` | Reads item `info.quality`, `info.durability`, or metadata durability |

If no durability value is available, the bar falls back to the default accent style.

Durability colors:

| Durability     | Color           |
| -------------- | --------------- |
| Above `45%`    | HUD theme color |
| `45%` or lower | Yellow          |
| `20%` or lower | Red             |

***

## Resolution Scaling

The NUI automatically scales the HUD based on client resolution.

Reference behavior:

| Resolution     | Behavior                            |
| -------------- | ----------------------------------- |
| `2560x1440`    | Full reference size                 |
| `1920x1080`    | Slightly smaller modern size        |
| `1280x720`     | Much smaller to avoid oversized HUD |
| Between values | Fluidly interpolated                |

This keeps the HUD usable across common FiveM display resolutions without requiring separate config profiles.

***

## Vehicle Systems

The resource includes:

* seatbelt toggle and warning sounds
* seatbelt exit prevention
* crash/ejection thresholds
* cruise control
* vehicle controls menu
* fuel display through supported fuel systems
* persistent mileage tracking

Default controls:

| Action           | Default      |
| ---------------- | ------------ |
| HUD settings     | `/hud`       |
| Toggle HUD       | `/togglehud` |
| Seatbelt         | `B`          |
| Cruise control   | `J`          |
| Vehicle controls | `M`          |

***

## Stress System

The built-in stress system can:

* add stress for speeding
* add stress for shooting
* persist stress in MySQL
* apply high-stress visual effects
* support stress relief tablet items through `ox_inventory` or `qb-inventory`
* support admin stress removal
* bridge to a custom stress system

If you do not want zloma\_hud to manage stress, disable it or use the custom bridge in [Customization](/zloma-scripts/zloma_hud-free-escrow/customization.md).

***

## Radio Indicator

When `pma-voice` is running, zloma\_hud reads:

* `LocalPlayer.state.radioChannel`
* `pma-voice:radioActive`

The radio HUD appears when the player is on a radio channel and animates while the player is transmitting over radio.

When the vehicle HUD appears, the radio indicator moves above it with a small lift animation.

Server owners can disable the radio UI globally with `Config.RadioHud.enabled = false`.

Players can hide it from `/hud` when `Config.HudSettings.allow.radioHud = true`.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://zloma-scripts.gitbook.io/zloma-scripts/zloma_hud-free-escrow/features.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.