❓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:

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.

-- If its a model
[`t20`] = {
     ["carhud"] = true,
},

-- 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:

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

💸 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.

// 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.

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 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:

[`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:

[`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.

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.
```
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.
```
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.

[`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.

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.

["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.

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.

First, I will post a few videos and screenshots here as evidence related to the issue.
Evidences: https://streamable.com/94ugd3 - https://streamable.com/hpspj6 - https://streamable.com/yj0548 - https://streamable.com/9tl257 - https://streamable.com/d4rlar

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:

NUI Interface is crashing! · Issue #70 · Xogy/xsoundGitHub

🎨 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.

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

PreviousKeybinds NextWais Jobpack

Last updated 25 days ago

🚗 Car

🌎 Map

Enable Oulsen Postals in fxmanifest.lua

💸 Money

🎨 Settings menu & Customization Overlay

📋 Others

‼️Hud disappears in an instant

🎨 Change, Export / Import Customizations

Export Customizations

Import Customizations

Who developed it / How can I get help

Enable Oulsen Postals in `fxmanifest.lua`