MBT Logo HUD

MBT Logo HUD replaces the default GTA HUD with a fully customizable interface built around your server's branding. Every element — logo, health bar, armor, hunger, thirst, oxygen, stress, weapon display, microphone indicator and server ID — is draggable through an in-game settings menu so you can place everything exactly where you want it.

The minimap can be made circular and hidden while on foot, and the weapon HUD shows the weapon icon and ammo counts for every GTA V weapon out of the box.

Features

• Custom logo — display your server logo (PNG, GIF or WebM) as part of the HUD; size is configurable
• Stat bars — health, armor, hunger, thirst, oxygen (underwater / sprint stamina), and optional stress
• Weapon HUD — icon + clip ammo + total remaining ammo for all GTA V weapons; melee weapons hide the ammo display automatically
• Microphone indicator — shows voice activity and proximity range; supports pma-voice, saltychat, or a custom handler
• Server ID — shows the player's server ID in the HUD
• Drag-to-position settings menu — /hudmenu command opens a live editor where each element can be dragged to any position; positions are saved per-player
• Round minimap — replaces the square GTA radar with a circular one
• Minimap hidden on foot — minimap only appears when the player is in a vehicle
• Configurable refresh rates — separate intervals for fast stats (health/armor/weapon) and slow stats (hunger/thirst/stress)
• Export — showLogoHud(bool) export lets other resources show or hide the HUD programmatically
• Admin style dump — /getDefHudStyle (name configurable) copies the current element positions to the server console / clipboard for use as a new DefaultStyle
• Multi-framework — ESX Legacy, ESX (old), QBCore

Supported Frameworks

Supported Voice Systems

How it works

1. On player load the NUI fires nuiIsReady → Init() loads the minimap scaleform, hides the default radar, sends the config (MBT.Preferences) to the NUI, then starts three threads: stats, status and voice
2. Stats thread (every RefreshStats seconds) — reads health, armor, oxygen, current weapon and ammo from the game; sends updateStatusHud and weapon NUI messages
3. Status thread (every RefreshStatus seconds) — reads hunger and thirst via MBT.StatusRetriever; sends updateStatusHud
4. Voice thread — polls MumbleIsPlayerTalking or listens to pma-voice / SaltyChat events; sends updateMicrophoneStatus
5. The player presses PAGEDOWN (or the configured key) to toggle the HUD bars; the server ID is included in the toggle message
6. /hudmenu opens the drag editor — the player drags elements, saves, and positions are persisted in the NUI