ESX/QB permission group allowed to run the style dump command.
MBT.GetStyleCommand
string
"getDefHudStyle"
Name of the admin command that outputs the current element positions as a table (copied to clipboard). Paste the result into to change the default layout for all players.
Maximum health values for male and female freemode peds. Used to normalise the health bar to 0–100%. If your server uses custom health values, update these to match.
Each key maps to an element's default position as { x, y } pixels from the anchor origin. The anchor entry is { left, top, right, bottom } and defines the drag area bounds.
To get the correct values for your layout, use the /getDefHudStyle admin command after positioning elements with /hudmenu.
Other fields
Field
Type
Default
Description
MicrophoneTalkingColor
string
"#4ee70b"
CSS hex colour the microphone icon turns when the player is actively talking.
UseStress
boolean
false
Set to true if your server has a stress system; enables the stress bar and activates .
Current hunger percentage. Default preset uses esx_status.
getThirst
number 0–100
Current thirst percentage. Default preset uses esx_status.
getMicStatus
—
Used only when . Send manually inside this function.
Weapons Table
MBT.Weapons = { [453432689] = { Type = 'handguns', Name = 'pistol' }, -- ...}
Maps GTA weapon hashes to their display type and icon name. The NUI uses Name to look up the weapon image from html/assets/weapons/<name>.png. The script ships with all vanilla GTA V weapons pre-configured. To add a custom weapon:
MBT.Weapons[YOUR_WEAPON_HASH] = { Type = 'handguns', Name = 'myweapon' }
Then place html/assets/weapons/myweapon.png in the assets folder.
Type value
Description
'melee'
Hides ammo counters; only the weapon icon is shown.
MBT.HandleNotify = function(data) -- data.text — key in MBT.Labels -- data.icon — Font Awesome class string -- data.type -- "info" / "error" / "success"end
Replace the body with your server's notification system. Called for HUD-internal messages (settings saved, HUD reset, etc.). The default implementation uses ESX.ShowNotification / QBCore.Functions.Notify.
Labels
MBT.Labels = { ["must_open"] = "HUD must be opened to open the settings menu", ["hud_refreshed"] = "HUD has been refreshed", ["settings_saved"] = "The settings have been saved!", ["hud_reset"] = "HUD has been reset!", ["check_console"] = "Settings have been generated and are available on your OS clipboard [CTRL-V]",}
All visible notification strings. Edit to translate or customise the messages shown by the HUD system.
true
When true, the HUD automatically opens on the first player spawn.
MBT.DefaultHUDTrigger
boolean
true
When true, showLogoHud(true) is called automatically when the HUD system finishes loading.
If set to a key string (e.g. "F6"), a hotkey is also bound to /hudmenu. Requires EnableHudMenuCommand = true.
DefaultStyle
MBT.Preferences.DefaultStyle
MBT.MinimapZoom
number
0.24
Zoom level used for the minimap component position (SetMinimapComponentPosition). Lower = more zoomed in.
MBT.MinimapVehicleZoom
number
1150
Radar zoom level applied when the player enters a vehicle (SetRadarZoom).
(
false
)
MBT.StatusRetriever.getMicStatus
"thirst"
] = {
204
,
90
},
["stress"] = { 12, 90 },
["oxygen"] = { 177, 22 },
["microphone"] = { 109, 3 },
["server-id"] = { 43, 28 },
},
MicrophoneTalkingColor = "#4ee70b",
UseStress = false,
}
Type
string
"Image"
"Image" for static images and GIFs; "Video" for WebM files.
Size
number
120
Logo size in pixels.
MBT.StatusRetriever.getStress
MBT.VoiceHandler = false
updateMicrophoneStatus
getStress
number 0–100
Used only when MBT.Preferences.UseStress = true. Return the current stress level from your stress system.
