> 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/customization.md).

# Customization

zloma\_hud exposes open customization files for server-specific bridges:

```
client/cl_customization.lua
server/sv_customization.lua
```

These files are not escrowed.

***

## Client Notify Bridge

Use `ZlomaCustomNotify.send` if you want to replace `ox_lib` notifications for client-side HUD messages.

```lua
function ZlomaCustomNotify.send(data)
  exports["your_notify"]:Notify(
    data.title or "HUD",
    data.description or "",
    data.type or "inform"
  )

  return true
end
```

Return `true` when your custom notify handled the message.

Return `false` to let zloma\_hud use its fallback behavior.

***

## Server Notify Bridge

Use `ZlomaCustomNotifyServer.send` for server-triggered messages.

```lua
function ZlomaCustomNotifyServer.send(source, data)
  TriggerClientEvent("your_notify:client:send", source, data)
  return true
end
```

***

## Custom Stress Bridge

If your server already has a stress system, enable:

```lua
Config.StressSystem.useCustomStress = true
```

Then implement any needed functions.

Client:

```lua
function ZlomaCustomStress.getStress()
  return exports["your_stress"]:GetStress()
end

function ZlomaCustomStress.setStress(value)
  exports["your_stress"]:SetStress(value)
  return true
end

function ZlomaCustomStress.addStress(amount)
  exports["your_stress"]:AddStress(amount)
  return true
end

function ZlomaCustomStress.relieveStress(amount)
  exports["your_stress"]:RemoveStress(amount)
  return true
end
```

Server:

```lua
function ZlomaCustomStressServer.getStress(source)
  return exports["your_stress"]:GetStress(source)
end

function ZlomaCustomStressServer.setStress(source, value)
  exports["your_stress"]:SetStress(source, value)
  return true
end
```

Return `true` from setter/action functions when your custom system handled the request.

***

## Custom Mileage Bridge

If another resource owns mileage storage, enable:

```lua
Config.VehicleMileage.useCustomMileage = true
```

Client:

```lua
function ZlomaCustomMileage.getMileageByEntity(vehicle)
  return exports["your_mileage"]:GetVehicleMileage(vehicle)
end

function ZlomaCustomMileage.getMileageByPlate(plate)
  return exports["your_mileage"]:GetMileageByPlate(plate)
end

function ZlomaCustomMileage.setMileage(vehicle, plate, mileageKm)
  exports["your_mileage"]:SetMileage(plate, mileageKm)
  return true
end
```

Server:

```lua
function ZlomaCustomMileageServer.getMileageByPlate(plate)
  return exports["your_mileage"]:GetMileageByPlate(plate)
end

function ZlomaCustomMileageServer.setMileageByPlate(plate, mileageKm)
  exports["your_mileage"]:SetMileageByPlate(plate, mileageKm)
  return true
end
```

Mileage is stored internally in kilometers. If your external system stores miles, convert before returning or saving.


---

# 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/customization.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.