Skip to content

F.A.Q

🚗 Car#

Fuel does not display correctly / It doesn't work
  • For this go to wais-hudv6/config.lua.
  • Go to Config.GetVehicleFuel Function and put export for your Custom Fuel script, if any, and return this value with return. Example:
text
Config.GetVehicleFuel = function(vehicle)
    -- Original one
    --return GetVehicleFuelLevel(vehicle) or 0.0 
    
    return exports["my_fuel_script_name"]:GetFuelLevelFuncName(vehicle)
end
Blocking the belt, carhud or music system in some vehicles or classes
  • For this go to wais-hudv6/config.lua.
  • Go to Config.BlacklistedVehicles table and add the vehicle or class as in the examples.
  • lua
    -- If its a model
    [`t20`] = {
         ["carhud"] = true,
    },
    
  • lua
    -- If its class
    [13] = {
        ["belt"] = true,
        ["music"] = true,
        ["carhud"] = true,
    },
    
Deactivating the music system
  • For this go to wais-hudv6/config.lua.
  • In the Config.MusicSystem table, find the variable [‘disable’] and set it to true.
  • Now the music system in the car control menu will be completely disabled (including events and codes).
Nearby location Add/Remove
  • For this go to wais-hudv6/bridge/editable/location.lua.
  • Find the category of the location you want to add or delete, then add the new location by going one below the last vector3 in the category, then put a comma at the end of the vector3 you added. Find the location in delete vector3 and delete it with the comma at the end
Change Default Fuel Type
  • For this go to wais-hudv6/web/public/config.json.
  • Find the variable ‘fuelType’ and change the place between the quotes on the right side. Types: litres or gallons

🌎 Map#

Minimap becomes invisible / disappears and comes back
  • For this go to wais-hudv6/config.lua.
  • If you are using a postal map, find the Config.PostalMap table and set the [‘enabled’] variable to true. This will fix the map disappearance.
How to keep the map always active ( Show map on foot or Always )
  • For this go to wais-hudv6/config.lua.
  • Find the variable Config.ShowMapOnFoot = false and make it true.
Show Postal Shortly?
  • For this go to wais-hudv6/config.lua.
  • Go to the Config.PostalMap table and set the [‘showNearPostal’] variable to true.
Change Default Map Type
  • For this go to wais-hudv6/web/public/config.json.
  • Find ‘mapType’ for the map type and change the ‘square’ between the quotes on the right side. Types: square, circle.
Postal Addresses Wrong
  • Compatible with this postalmap
  • If you think the postals are wrong, you may be using a different postalmap.
  • For the correct result, you can install the latest postal map from the link above.
  • If you do not want to install it, you can get the locations of your own postal addresses.
  • ( wais-hudv6/bridge/editable/postal.lua )
Map is not positioned / Map Animation does not appear

Recommended resolutions to use this feature:

1280x720\ 1366x768\ 1920x1080\ 2560x1440

Map animation and positioning work at this resolution. Other intermediate screen resolutions are not yet supported. Stabilisation will be done with future updates.

Disable Map Animation
  • For this go to wais-hudv6/config.lua.
  • Find the value Config.DisableMapAnimation = false and then change the false value to true.
Oulsen Satellite Map Postals Setup

Enable Oulsen Postals in fxmanifest.lua#

In the shared_scripts section, make sure:

  • 'bridge/editable/oulsen_satmap_postals.lua', is uncommented
  • 'bridge/editable/postal.lua', is commented out

Example:

lua
shared_scripts {
    'config.lua',
    'locales/*.lua',
    'bridge/editable/location.lua',
    'bridge/editable/weapons.lua',
    --'bridge/editable/postal.lua',                    -- DISABLED
    'bridge/editable/oulsen_satmap_postals.lua',       -- ENABLED
    'bridge/framework.lua',
    '@ox_lib/init.lua',
}
  • And just add this file to bridge/editable

View attachment on original documentation Oulsen Satellite Map Postals Setup

💸 Money#

Cash / Money is showing 0
  • For this go to wais-hudv6/config.lua.
  • If money is item in your inventory, go to Config.MoneySettings and set [‘isItem’] variable to true. ( In ox_inventory, money is not an item. )
  • Your money will now appear in the hud information section.
Change Money Prefix and Symbol
  • For this go to wais-hudv6/web/public/config.json.
  • Find the Money table and change the text between the quotes on the right side of the ‘prefix’ and ‘symbol’ variables.
  • json
    // Like example we changed symbol $ to € and dot to comma.
    "money": {
        "prefix": ",",
        "symbol": "€"
    },
    
Enable Black Money
  • For this go to wais-hudv6/config.lua.
  • Go to the Config.BlackMoney table and find the [“display”] = false variable. Change the value from false to true so that it will now appear in the right column.
Black Money is showing 0
  • For this go to wais-hudv6/config.lua.

For Item:

  • Go to the Config.BlackMoney table.
  • Find the [“isItem”] = false variable and change the value from false to true.
  • Find the variable [“name”] = “YOUR_BLACKMONEY_ITEM_NAME” and replace YOUR_BLACKMONEY_ITEM_NAME with your item name

For Account:

  • This procedure is typically performed for ESX.
  • Go to the es_extended/shared/main.lua file, find the account name associated with Black Money in the Config.Accounts table, and replace the value “black_money” in the [‘account’] = “black_money” variable.

🎨 Settings menu & Customization Overlay#

Changes For Everyone!
  • All settings are user-specific, but I've added a feature that lets you share them with others.

CUSTOMIZATOINS TO EVERYONE

Disable Settings Menu
  • To do this, go to the wais-hudv6/config.lua file.
  • Go to the Config.Commands table and find the [“settings”] table.
  • Replace the false value in the [“disabled”] =`` ``false, option with true.
Disable Customization Overlay
  • To do this, go to the wais-hudv6/config.lua file.
  • Go to the Config.Commands table and find the [“editor”] table.
  • Replace the false value in the [“disabled”] =`` ``false, option with true.
Lock The Changes & Admin Settings
  • Configure all settings on your server at a convenient time and transfer them.
  • After that, go back to Settings and disable the Customization Overlay.
  • This way, once administrators or developers make changes, they will take effect across the entire server. After that, no one will be able to change them.

📋 Others#

Debug Prints
  • For this go to wais-hudv6/config.lua.
  • Find the variable Config.ShowDebug = false and make it true.
Timer Location
  • For this go to wais-hudv6/web/public/config.json.
  • Find the variable ‘timerLocation’ and change the data on the right side. Replace ‘en-US’ with the shortcode for your country or the main language supported by the server.
  • Shortcodes can be found here
Change Language
  • For this go to wais-hudv6/config.lua.
  • Then find Config.Language = ‘en’ and type a valid language file name ( ar, cz, ro, it, fr, fr, de, en )
Status Alerts ( Hunger Thirst )
  • For this go to wais-hudv6/config.lua.
  • Find the variable Config.SendStatusAlert = false and make it true
Statuses Shows 0 ( ESX )
  • This error usually occurs because you have customized esx_status or because it is outdated.
  • Visit here to download the status script.
  • Another common issue is that the “esx_status:onTick” event has been modified. Therefore, reset the script to its default state.
  • Another problem is that the status data is empty. In such cases, you need to process the status data by eating or drinking something using scripts such as esx_basicneeds.
Custom Weapon and Image addition
  • For this go to wais-hudv6/bridge/editable/weapons.lua.
  • At the bottom of the file we will add a new table as below. Thanks to this table, the weapon name will appear in hud:
  • lua
    [`your_weapon_name`] = {label = 'Your Weapon Label'},
    
  • To add a photo of the weapon, you need a ‘Hash’ type expansion of your weapon name. Use here for this
  • After typing your weapon name correctly on this site, you will find the hash address of your weapon. Copy this hash address and go to: wais-hudv6/web/public/images/weapons
  • Drag the weapon photo here and then paste the hash address you copied into the file name. Afterwards, you can see the weapon photo in the hud by restarting the script after the refresh command.
  • NEW Method: You can do this without converting to hash. You can add a new image with the weapon name, then find the table for that weapon in weapons.lua and specify the custom image name. Like this:
  • text
    [`weapon_unarmed`] = {label = 'Fists', image = 'WEAPON_UNARMED'},
    
Use Stress System
  • You can see the stress system next to the health bars by making the Config.StressSystem variable true. You should use an additional script to increase or decrease your stress.
  • qb-stress
Change Server Logo
  • For this go to wais-hudv6/web/public/images.
  • In this file, you will see the “server-logo.png” file
  • Place your own server logo here. Then delete the server-logo.png file and rename the file you dragged over to “server-logo.png”
Disable Right Corner
  • For this go to wais-hudv6/config.lua.
  • To do this, locate the Config.DisableRightCorner = false variable and change the false value to true.
Resmon Value

Note: As is well known, scripts in FiveM run on a single core. Therefore, your processor's architecture and single-core performance directly affect the resmon value.

On older or lower-frequency processors, the code takes longer to execute, so the resmon value naturally appears higher.\ On newer, high-performance processors, the same code runs much faster, so the resmon value may appear lower (even 0.00).

Since not all processors have the same structure or speed, it is not possible to achieve a 0.00 ms resmon value on every system — this is entirely due to hardware differences.

This situation has nothing to do with the written code or script optimization; the difference is entirely dependent on the processor's power and architecture.

The Resmon values were recorded in an environment where the computer was under the lightest load and usage was minimal.

text
Tested system components:

Intel Core i7 12700H
Nvidia GeForce RTX 3050
2x8 16GB 3200 MHZ DDR4 Ram
500 GB SSD
Maximum Armor higher than 100
  • For this go to wais-hudv6/config.lua.
  • If your maximum armor level is above 100, you should write it here. This way, the HUD bar will act accordingly.
  • 📛📛 ATTENTION: Does not modify or set player data. It is only an offset setting for visual appearance.
  • lua
    Config.MaxArmourValue = 100
    
Disable Location / Widget
  • For this go to wais-hudv6/config.lua.
  • If you set it to true, the location and compass will not be displayed. If the nearby postal address is also not visible, the element there will be automatically hidden. If set to false, the Compass and Location will be displayed.
  • lua
    Config.DisableLocationInfo = true
    
Hide Specific Weapons Images
  • To do this, go to the wais-hudv6/bridge/editable/weapons.lua file.
  • Find the table for the weapon whose photo you want to hide. Add the hide = true variable.
lua
[`weapon_unarmed`] = {label = 'Fists', image = 'WEAPON_UNARMED', hide = true}
Hide GTA Hud, Street Name, Weapon Ammo Etc.

The Hud script does not automatically hide certain default GTA components, as this reduces performance and increases resmon usage. Therefore, you can hide them using the methods below.

ESX:

  • Go to this file: es_extended/shared/config/adjustments.lua
  • Find the components in the Config.RemoveHudComponents table, change their values from false to true, and restart the server. This will hide them.

QBCORE:

  • Go to this file: qb-smallresources/config.lua
  • Go to the Config.Disable table and add the ID of the HUD component you want to hide to the hudComponents table.

QBOX:

  • Go to this file: qbx_smallresources/qbx_hudcomponents/config.lua
  • Go to the hudComponents table and add the ID of the component you want to hide here.
lua
1 : WANTED_STARS
2 : WEAPON_ICON
3 : CASH
4 : MP_CASH
5 : MP_MESSAGE
6 : VEHICLE_NAME
7 : AREA_NAME
8 : VEHICLE_CLASS
9 : STREET_NAME
10 : HELP_TEXT
11 : FLOATING_HELP_TEXT_1
12 : FLOATING_HELP_TEXT_2
13 : CASH_CHANGE
14 : RETICLE
15 : SUBTITLE_TEXT
16 : RADIO_STATIONS
17 : SAVING_GAME
18 : GAME_STREAM
19 : WEAPON_WHEEL
20 : WEAPON_WHEEL_STATS
21 : HUD_COMPONENTS
22 : HUD_WEAPONS
Disable CarControl Tabs
  • For this go to wais-hudv6/config.lua.
  • Go to the Config.Commands table and find the carcontrol table.
  • You can hide the tabs in the tabs table by setting them to true, or make them available by setting them to false.
text
["carcontrol"] = {
    ["key"] = "Q", -- Q ( RADIO KEYBIND )
    ["command"] = "carcontrol", -- Command to open car control menu
    ["disabled"] = false, -- If you set this variable to `true`, car control menu will be completely disabled.
    ["openevent"] = "wais:hudv6:client:openCarControl", -- Event to open car control menu
    ["disableKey"] = false, -- If you set this variable to `true`, the keymapping system will be disabled and only command or event will be used to open car control menu.
    ["description"] = "Open Car Control Menu", -- Description of the command
    ["mouseControl"] = false, -- Allows you to control both the mouse and keyboard simultaneously. If you set it to `true`, you can control car control without splitting the game. If set to `false`, the game will split because your keyboard will only focus on car control.
    ["tabs"] = {
        --[[
            If you set it to `false`, the tab will be enabled.
            If you set it to `true`, the tab will be disabled. 
        ]]

        ["music"] = Config.MusicSystem.disable, -- Music tab allows you to control the music system in your vehicle. If you set it to `true`, the music tab will be completely disabled.
        ["nearby"] = false, -- Nearby tabs show nearby banks, gas stations, and other important locations.
        ["carmenu"] = false, -- Car menu tab allows you to control your vehicle's doors, hood, trunk, and other features. If you set it to `true`, the car menu tab will be completely disabled.
    }
},
QS Crime Creator Integration
  • To do this, go to the qs-crime-creator/custom/client.lua file.
  • Go to the last line of the file and paste the code below. Then restart the script.
  • text
    AddEventHandler('wais:get:crime', function(value, cb)
        if value == nil or value == 0 then return cb(nil) end
        local organization = OrganizationManager:get(value)
        cb(organization.label)
    end)
    

‼️Hud disappears in an instant#

If you're reading this headline, I know you're in a difficult situation. I was experiencing the same issue on my own server. However, this issue is not related to HUD. The entire user interface is crashing.

I have confirmed that the issue stems from YouTube's updated APIs.

The system crashes due to a memory leak in the car radio script on a live server with 400 users.

The scripts that typically play the biggest role in causing this issue are:

  • Car radio scripts. Music broadcast to everyone via YouTube inside the vehicle.
  • Scripts that function as sound libraries, such as xSound.

At this point, the most appropriate solutions, as I have implemented on my own server, are to disable these and similar scripts or to disconnect from YouTube.

A GitHub issue has been created regarding xSound, and there are cases worldwide where such issues have caused Chromium to crash:

https://www.reddit.com/r/firefox/comments/1ol0m0a/new_memory_leakui_hang_using_youtube/

https://github.com/Xogy/xsound/issues/70


🎨 Change, Export / Import Customizations#

Export Customizations#

  • Use the /hud command to change elements and some options.
  • Press PageUp to open editor mode (Default Key)
  • Once all changes are complete, scroll down a bit in the “General” tab using /hud and click the ‘Export’ button in the “Export Customizations” option.

Import Customizations#

  • Paste the JSON data you copied into an IDE, delete the top and bottom { } brackets, and copy the remaining data.
  • Replace the copied data with the data here: wais-hudv6/web/public/Config.json
  • If you do something wrong in this section, the hud will be damaged or will not work. Please watch the video.

https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmOhVROw9E3kpmAG3JYVe%2Fuploads%2F1WZhksSwEVJUr7HRxrAK%2F2026-01-09%2014-44-45.mp4?alt=media&token=43e5e411-cc68-4229-b8bf-aeb85fdfd32d


A lot of things aren’t working properly / Distance Etc.#

  • If you're using AntiCheat scripts like Waveshield or Fiveguard, you need to register the wais scripts.
  • You'll usually encounter errors such as: “Distance Check,” “You're Not in the Car,” or “You're Not in the Area.”

There are no more available yet, please open a ticket if the topics here are not suitable for what you are looking for.

Who developed it / How can I get help#

You can recognise our script developers by the short names of the script. Scripts with short name ‘Wais’ are made by Ayazwai.

You can visit our Discord address to ask questions in your mind / To get support