All configuration is done inside config.lua, which is open-source and excluded from escrow.
Framework
Variable
Type
Default
Description
Config.Framework
string
"qbcore"
Active framework. Accepted values: "qbcore", "esx".
Config.CoreName
string
Auto-resolved
Internal resource name of the framework core. Resolved automatically from Config.Framework. Do not change unless using a custom fork.
lua
Config.Framework = "qbcore" -- "qbcore" or "esx"Config.CoreName = Config.Framework == 'qbcore' and 'qb-core' or 'es_extended'
HUD behavior
Variable
Type
Default
Description
Config.ForceLogin
boolean
true
When true, the HUD auto-detects the player login state by polling framework data instead of waiting for login events. Recommended to keep enabled.
Config.HideRadar
boolean
true
Hides the radar/minimap when the player is on foot. The minimap reappears automatically when entering a vehicle.
Config.AlwayShowCarHud
boolean
false
When true, the vehicle HUD (speed, fuel) stays visible even when not in a vehicle.
Config.DisableMapModifications
boolean
false
Disables the minimap repositioning and clip type changes. Enable this if you use a custom minimap resource.
Config.kph
boolean
false
When true, vehicle speed is displayed in km/h. When false, speed is displayed in mph.
Death system
Variable
Type
Default
Description
Config.AutoDeath
boolean
true
Automatically detects player death via gameEventTriggered and shows the death timer on screen. Set to false if you want to trigger the death screen manually using the showDeath(time) export from your ambulance script.
If Config.AutoDeath = false, you are responsible for calling exports['origen_hud']:showDeath(time) from your ambulance or laststand script when the player enters a death state, and exports['origen_hud']:hideDeath() when they are revived.
Fuel system
Variable
Type
Default
Description
Config.FuelSystem
string
"standalone"
Fuel data source for the vehicle HUD.
Value
Behavior
"standalone"
Uses the native GTA V fuel level via GetVehicleFuelLevel. No extra dependency needed.
"legacyfuel"
Reads fuel from the LegacyFuel resource via exports['LegacyFuel']:GetFuel(vehicle).