Skip to content
⌘ K

Configuration

Main config structure and the settings most servers change

The main configuration file is 0r-hud-v3/config.lua.

Main Settings You Will Usually Change#

FieldWhat it controls
Config.DefaultHudSettings.bar_styleDefault bar style
Config.DefaultHudSettings.is_res_style_activeAlternative bar ordering/layout
Config.DefaultHudSettings.vehicle_hud_styleDefault vehicle HUD preset
Config.DefaultHudSettings.mini_mapMinimap style and only-in-vehicle behavior
Config.DefaultHudSettings.compassCompass enable state and only-in-vehicle behavior
Config.DefaultHudSettings.cinematicCinematic mode toggle
Config.DefaultHudSettings.vehicle_info.kmHKM/H or MPH
Config.DefaultHudSettings.client_infoTop-right info block visibility
Config.DefaultHudSettings.music_infoMusic widget toggle
Config.DefaultHudSettings.navigation_widgetNavigation widget toggle
Config.DefaultHudSettings.bar_colorsDefault colors for each status bar
Config.MoneySettingsCash/account item handling and extra currency
Config.ToggleSettingsMenuHUD settings keybind and command
Config.ToggleSeatBeltSeatbelt system and eject speed
Config.ToggleVehicleEngineEngine toggle keybind
Config.ToggleCinematicModeCinematic mode command/keybind
Config.ResetHudPositionsReset positions command
Config.HideGTAHudComponentsHide GTA HUD pieces
Config.HavePostalMapPostal map compatibility
Config.RefreshTimesRefresh intervals
Config.BarColorsColor picker palette
Config.ElectricVehiclesVehicles that should use electric fuel display

Default HUD Look#

Most visual customization starts in Config.DefaultHudSettings.

The most commonly changed parts are:

  • bar_style
  • vehicle_hud_style
  • mini_map.style
  • client_info.server_info.name
  • client_info.server_info.image
  • bar_colors

If you want the default UI to match your server brand, start here first.

Keybinds and Commands#

The current HUD version uses these sections:

  • Config.ToggleSettingsMenu
  • Config.ToggleSeatBelt
  • Config.ToggleVehicleEngine
  • Config.ToggleCinematicMode
  • Config.ResetHudPositions

That means the older docs based on OpenSettingsKeybind and Commands.HudSettings are outdated. Use the newer config sections above.

Money and Extra Currency#

If your cash is an item instead of framework money, edit:

lua
Config.MoneySettings

You can also show one extra currency in the top-right info panel by using:

  • item type
  • account type

Seatbelt and Vehicle Settings#

Use these sections for vehicle related behavior:

  • Config.ToggleSeatBelt
  • Config.ToggleVehicleEngine
  • Config.ElectricVehicles

Seatbelt eject speed is based on KM/H if vehicle_info.kmH = true.

Colors#

There are two color areas:

  • Config.DefaultHudSettings.bar_colors for default bar assignments
  • Config.BarColors for the color choices available in the settings menu

Extra Data Files#

These files also matter:

  • data/hud.lua contains the default HUD data model and supported style aliases
  • data/weapons.lua contains weapon display names used in the HUD

In most cases you should edit config.lua first and only touch these files if you specifically need to change defaults or weapon labels.

Localization#

This resource uses locale files in the locales/ folder. The active language is controlled through ox_lib.

Example:

cfg
set ox:locale "en"