bat_hud

Lightweight ESX HUD for FiveM: status indicators, speedometer, voice range, saved player settings, and optional bigmap toggle. https://youtu.be/y3q1pZ0h6ZU

Features

• Status HUD: voice, hunger, thirst, stamina (circle / bar / dots)
• Flexible positioning: next to minimap, above minimap, left or right center
• Configurable logo (left / right / random)
• Vehicle speedometer with fuel/battery, engine, handbrake, lock, high beams
• Engine toggle keybind (default M), engine stays off until toggled
• Double-press bigmap (default Z (on german keybord its Y))
• Voice support for yaca-voice and pma-voice
• Optional hunger/thirst via esx_status
• Per-player settings stored in MySQL (/hudsettings)
• Locales: English (default) and German

Dependencies

Resource	Required
es_extended	Yes
ox_lib	Yes
oxmysql	Yes
esx_status	Only if Config.Needs = true
yaca-voice or pma-voice	Match Config.Voice

Installation

1. Drop bat_hud into your resources folder.
2. Import sql/bat_hud.sql (optional | table is also created on resource start).
3. Add to server.cfg:

ensure oxmysql
ensure ox_lib
ensure es_extended
ensure bat_hud

4. Edit client/config.lua to your needs.
5. Restart the server / ensure bat_hud.

Configuration

client/config.lua:

Config.Locale = 'en'          -- 'en' | 'de'
Config.Needs = true           -- hunger/thirst (needs esx_status)
Config.Voice = 'yaca-voice'   -- 'yaca-voice' | 'pma-voice'
Config.PmaVoiceRanges = { 3.0, 7.0, 15.0 }  -- match pma-voice voiceModes

Logo path, opacity, size and HUD spacing offsets are also configurable there.

Commands & keybinds

Action	Default
Open HUD settings	/hudsettings
Toggle engine	M
Toggle bigmap (double press)	Z

Keybinds can be changed in Settings → Key Bindings → FiveM.

Locales

Translations live in locales/. Default is English. Switch with:

Config.Locale = 'de'

To add a language, copy locales/en.lua, rename it, fill the keys, and add the file to fxmanifest.lua under shared_scripts.

Need help?

Contact us on Discord

---

Made with ♥️ by Batchcore Systems