# Setup

This page covers the minimum setup required to get the HUD running correctly: dependencies, optional integrations, and `server.cfg` start order.

## Required Dependencies

* [ox\_lib](https://github.com/overextended/ox_lib/releases)
* [xsound](https://github.com/Xogy/xsound/releases/tag/1.4.3)
* `es_extended`, `qb-core`, or `qbx_core`

## Optional Integrations

These are optional but supported by the resource:

* `hrsgears` for manual gear support
* `edit_mini_map` for live minimap positioning
* `ox_fuel`, `LegacyFuel`, `cdn-fuel`, or `ps-fuel` for fuel reading
* `pma-voice` or `SaltyChat` for voice and radio display

## Recommended server.cfg Start Order

```lua
start ox_lib
start xsound
start framework -- es_extended, qb-core, or qbx_core
-- optional resources
start hrsgears
start edit_mini_map
start 0r-hud-v3
```

{% hint style="info" %}
There is no SQL import step for this resource.
{% endhint %}

## Streamed Files

The HUD package includes minimap related streamed files:

* `stream/minimap.gfx`
* `stream/minimap.ytd`
* `stream/circlemap.ytd`
* `stream/rectangle.ytd`

Do not remove them if you want the included minimap styles to work correctly.

## Final Checklist

After setup, verify these points:

* `ox_lib` and `xsound` start without errors
* `0r-hud-v3` starts without errors
* The HUD becomes visible after player load
* The settings menu opens with your configured key or command
* Vehicle HUD, voice widget, and minimap display work correctly in game


---

# Agent Instructions: 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://docs.0resmon.org/0resmon/0r-resources/0r-hud-v3/setup.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.