> For the complete documentation index, see [llms.txt](https://bl-scripts-1.gitbook.io/bl-scripts-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://bl-scripts-1.gitbook.io/bl-scripts-docs/~/revisions/6V50ZSjK7eKtXazngwLs/bl-hud-v1.md).

# BL HUD v1

## Overview

**BL HUD v1** provides a minimalistic and clean Heads-Up Display for FiveM servers. It replaces the default GTA V HUD with a custom one designed for RP use.

## Features

* Custom minimap integration
* Clean UI elements
* Client-side configuration
* Lightweight and performance-friendly
* Free to use

## Installation

1. Add `bl_hud_v1` to your `resources` directory.
2. Add `ensure bl_hud_v1` to your `server.cfg`.

## Configuration

* Edit `minimap.lua` or `client/client.lua` to customize visibility, style, or layout.

## Usage

The HUD loads automatically on player join.

## Troubleshooting

* Check if your server uses conflicting UI mods.
* Ensure client scripts are properly started.

## License

MIT License — free to use and modify.