
Initializing
Secure Protocol Active
Was this page helpful?
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.
pma-voice, saltychat, or a custom handler/hudmenu command opens a live editor where each element can be dragged to any position; positions are saved per-playershowLogoHud(bool) export lets other resources show or hide the HUD programmatically/getDefHudStyle (name configurable) copies the current element positions to the server console / clipboard for use as a new DefaultStyle| Framework | Supported |
|---|---|
| ESX Legacy | ✅ |
| ESX (old) | ✅ |
| QBCore | ✅ |
| Voice system | Supported |
|---|---|
| pma-voice | ✅ |
| SaltyChat | ✅ |
| Custom / other | ✅ (via MBT.StatusRetriever.getMicStatus) |
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 voiceRefreshStats seconds) — reads health, armor, oxygen, current weapon and ammo from the game; sends updateStatusHud and weapon NUI messagesRefreshStatus seconds) — reads hunger and thirst via MBT.StatusRetriever; sends updateStatusHudMumbleIsPlayerTalking or listens to pma-voice / SaltyChat events; sends updateMicrophoneStatus (or the configured key) to toggle the HUD bars; the server ID is included in the toggle messageThe resource name must remain mbt_lhud exactly. The script verifies its own name on startup and stops itself if renamed.
/hudmenu opens the drag editor — the player drags elements, saves, and positions are persisted in the NUI