# Integrations and Events

If you want to adapt the HUD to your own server setup, these are the most important files:

* Framework bridge: `modules/bridge/*`
* Fuel helper: `modules/utils/client.lua`
* Voice integration: `modules/voice/client.lua`
* Music integration: `modules/music/client.lua`
* Seatbelt logic and exports: `modules/seatbelt/client.lua`
* Vehicle control helpers: `modules/car_control/client.lua`

## Framework Integration

Files:

* `modules/bridge/client.lua`
* `modules/bridge/server.lua`
* `modules/bridge/esx/*`
* `modules/bridge/qb/*`
* `modules/bridge/qbx/*`

These files handle player loaded events, hunger/thirst/stress updates, and death status updates for supported frameworks.

If your framework is customized, this is the first place to adjust.

## Fuel Integration

File: `modules/utils/client.lua`

The HUD can read fuel from:

* `ox_fuel`
* `LegacyFuel`
* `cdn-fuel`
* `ps-fuel`

If you use another fuel script, update `Utils.GetVehicleFuelLevel(vehicle)`.

## Voice Integration

File: `modules/voice/client.lua`

Supported by default:

* `pma-voice`
* `SaltyChat`

This file controls:

* Radio channel display
* Talking range display

If your voice script is different, update this file.

## Music Integration

File: `modules/music/client.lua`

The built-in music widget uses `xsound`.

If you do not want music support, disable `Config.DefaultHudSettings.music_info.active`.

If you want different music behavior, this is the file to edit.

## Manual Gear and Minimap Editing

These optional integrations are used directly by the HUD:

* `hrsgears`
* `edit_mini_map`

Manual gear is controlled through `modules/car_control/client.lua`.

Live minimap placement is triggered from `client.lua` through:

```lua
exports['edit_mini_map']:usePlacer(...)
```

## Exports

The actual current exports are:

```lua
exports['0r-hud-v3']:ToggleVisible(state)
exports['0r-hud-v3']:SetSeatBeltState(state)
exports['0r-hud-v3']:GetCurrentSeatBeltState()
```

Common usage:

```lua
exports['0r-hud-v3']:ToggleVisible(false)
```

## Events

Useful client events supported by the HUD:

```lua
TriggerEvent('0r-hud-v3:client:setVehicleNitroValue', nitroValue)
TriggerEvent('hud:client:UpdateNitrous', hasNitro, level, state)
TriggerEvent('seatbelt:client:ToggleSeatbelt')
```

There is also support for:

* `pma-voice:setTalkingMode`
* `SaltyChat_RadioChannelChanged`
* `SaltyChat_VoiceRangeChanged`
* `0r-hud:Client:SetManualGear`

## UI Customization

If you want to edit the UI itself, the source is under:

```lua
ui/dev
```

Build it after editing:

```bash
npm install
npm run build
```


---

# 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/integrations-and-events.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.