General information

Most errors can occur due to a bad update (poor patch) or through code editing, always try to use the default resource if you get errors not found within this section.

Where can I configure the HUD?

All server-wide defaults are in config.lua. Players can override most settings per-player via the in-game /settings command, unless the admin locks a section in config.lua.

How do I change the theme color?

Change Config.HighlightColor and Config.HighlightSecondaryColor in config.lua to any hex color. These drive the default accent across the HUD.

How do I switch between KM/H and MPH?

Set SpeedUnit = "kmh" or SpeedUnit = "mph" in config.lua.

How do I disable the seatbelt module?

Set Config.Seatbelt.enabled = false in config.lua. The keybind, animation, export, and the speedometer’s seatbelt indicator will all be disabled.

How do I disable the integrated stress system?

Set Config.Stress.integrated = false. The HUD will then read stress directly from your framework’s player metadata instead of running its own decay thread and effects.

How do I add my own language?

Copy one of the files in locales/ (e.g. en-US.json) to your own locale code (e.g. de-DE.json) and translate the values. Then set Config.Locale = "de-DE" in config.lua.

Which frameworks are supported?

QBCore, ESX, Qbox, and standalone. Set Config.Framework to "auto", "qbcore", "esx", or "qbox".