Configuration · origen_hud

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