Concept HUD (concept_hud)

Use this guide with the product page and the included CHANGELOG.md for your installed version and release history. Requires Concept Bridge.

Clean by default. Fully configurable per server and per player. A React HUD for FiveM that reads every framework through the Concept Bridge (concept_bridge), so it runs on OX, Qbox, QB, ESX or standalone, with no code changes. Configs and locales stay open; Cfx Asset Escrow protects the core logic.

Delivery

1. Buy with the Buy on Tebex button on this page.
2. Check out with the same Cfx.re account that owns your server license key.
3. Download the asset from Cfx Portal → Granted Assets.
4. Updates land on the same Keymaster asset, so you don't need to buy it again.

Requirements

There is no framework mode to set. The bridge resolves the providers you run:

Install

1. Download the Concept Bridge and place the concept_bridge folder in your resources directory. See the bridge installation guide for dependencies and provider setup.

2. Place the concept_hud folder in your resources directory. The UI ships prebuilt, so there is no build step.

3. Add the resources to server.cfg in this order (framework and inventory first, so the bridge can detect them):

ensure oxmysql
ensure ox_lib
ensure qbx_core            # your framework: ox_core / qb-core / qbx_core / es_extended
ensure ox_inventory        # your inventory
ensure concept_bridge    # Concept Bridge
ensure concept_hud

Standalone servers (no framework): skip the framework line. The bridge's built-in default provider backs money / job / needs with seed values until you push real data through the exports.

4. Give your admins access to the server policy editor:

add_ace group.admin concept_hud.admin allow
add_principal identifier.license:YOUR_LICENSE_HERE group.admin

Prefer a custom ACE name? Set setr concept_hud:adminAce my.custom.ace and grant that instead.

5. refresh, then ensure concept_hud.

First-start checklist

1. In game, run /hudbridgestatus. It needs the command.hudbridgestatus ACE, so grant that to testers (add_ace group.admin command allow covers it). The command prints what the bridge resolved and whether it detected the required bridge modules, for example fork=true framework=ox_core inventory=ox_inventory weapons=ox_inventory fuel=ox_fuel seatbelt=none voice=pma-voice.
2. Confirm money, job and needs move with your framework, F10 opens the player settings, Y (hold or tap) peeks, and /hudadmin opens the policy editor (with ACE).
3. Players rebind keys under pause menu → Settings → Key Bindings → FiveM: Open HUD settings (F10) and HUD details (hold or tap) (Y).

Player settings (F10)

• Enable or disable any feature your server allows players to edit.
• Set each feature's When display mode.
• Reorder the vitals and money stacks (when the server allows it).
• Adjust HUD position with pixel offsets and 9-point anchors (when allowed).
• Pick a personal speed unit.
• Everything previews live and autosaves to client KVP.

If saving fails, the panel reports the failure. Closing offers Retry save or Discard & close; discarding does not save the pending edits. Resetting personal settings also reports write failures.

Display modes

Each feature can use a mode that fits how it should appear:

Critical band. Set it in the admin panel under Vitals (default 10%). Health, hunger, thirst, stamina, oxygen and vehicle engine/fuel appear when remaining is at or below the threshold; stress appears when it is at or above 100 − threshold; armor ignores 0 (unequipped).

Typical defaults: money onPeekOrChange; ID and job onPeek; health, hunger and thirst always; stress, stamina and oxygen onPeekOrChange; vehicle chrome + status icons inVehicle (always is coerced to inVehicle).

Admin policy editor

Open it with the Admin button in the F10 panel, or /hudadmin directly. Access is ACE-gated end-to-end (concept_hud.admin by default, override with setr concept_hud:adminAce); the server re-checks permission on every save.

• Server-wide defaults for every feature, accent colour, hide on pause / death, map / peek / vehicle defaults.
• Vitals and money order, plus "players may reorder" flags.
• HUD region defaults, plus "players may adjust position" flags.
• Saves to data/server_policy.json and broadcasts live to all clients.

When another admin saves while your draft is open, a conflicting save keeps your draft for review and reports that the server policy changed. Review the current defaults before saving again.

The HUD seeds the live policy file from config.lua on first start and keeps the previous copy as data/server_policy.json.bak. Keep the resource folder writable. Some hosting panels mount resources read-only, which blocks policy saves. Policy layers, from low to high: config.lua → data/server_policy.json → client KVP (only where the server allows).

In-game controls

Players rebind F10 and Y under pause menu → Settings → Key Bindings → FiveM.

Features

Money

Cash, bank and dirty money with a count-up animation that scales with the amount, a gain/spend color pulse, a floating +/- delta and a ring that tracks the count. Rows slide instead of jumping when one appears or hides, and the dirty row hides at $0 unless you turn that off.

Identity and voice

Server ID with job title and grade (peek by default). The voice badge shows whisper, normal and shouting range and brightens while you talk. Voice and server ID have independent display settings: voice set to Always stays visible when the ID is set to On peek or disabled. Voice's On change modes react to talking and range changes.

Vitals

Health (with armor beside it when worn), hunger | thirst, stamina, oxygen and stress. The stack is fully reorderable, and each bar can hide until it changes or goes critical.

Weapon

The equipped weapon and ammo (clip / reserve) show only while something is in hand. The money stack moves down to make room automatically.

Vehicle

An enter card with make and model, a compact speed + RPM readout, and engine / fuel / seatbelt icons that flash when something drops or the belt is off.

Map and district

The native GTA radar in a rounded frame that lines up at every resolution, with street names and a district pill that waits until you have settled in a new area (no spam on borders). Vehicle-only by default; set an item such as gps to unlock it on foot.

Settings panels

Player panel (F10): toggle features, pick display modes, reorder vitals and money, move each HUD block with anchors and pixel offsets, and choose km/h or mph. Everything previews live and autosaves.

Admin panel (/hudadmin): server-wide defaults for every feature, what players may change, accent color, critical band, map and vehicle behaviour. Saving applies to every player instantly.

Configuration

config.lua carries first-install basics; you tune everything else live in the admin panel. The most useful keys:

Poll rates and the deep minimap geometry are fixed, tuned internals in shared/config_defaults.lua. Explicit opt-ins such as Config.Minimap.Blips and Config.Minimap.allowBigmap can be set in config.lua to override those defaults.

Money accounts and items

Config.Money = {
    cashAccount = 'cash',
    cashAccountFallback = 'money',
    bankAccount = 'bank',
    dirtyAccount = 'black_money',
    dirtyAccountFallback = 'dirty_money',
    dirtyItems = {
        { item = 'markedbills', mode = 'worth', meta = 'worth' },
        { item = 'black_money', mode = 'count' },
    },
    dirtyShowWhenZero = false,
}

cashItems / bankItems let the HUD read balances from inventory items before falling back to account reads. Configure these against your selected framework/inventory.

Exports and events

Client resources should call the exports; raw concept_hud:client:set* triggers from other resources are ignored (they are reserved for server relays).

Hiding the HUD through SetBlocked or SetVisible also hides the minimap. Showing the HUD again still respects its vehicle, item and other minimap visibility restrictions.

exports.concept_hud:SetBlocked(true)             -- or SetBlocked(true, 'multichar')
exports.concept_hud:SetBlocked(false)            -- or SetBlocked(false, 'multichar')
exports.concept_hud:SetMoney(250, 1200, 0)
exports.concept_hud:SetNeeds(80, 65, 10)
exports.concept_hud:SetJob('Mechanic', 'Senior', 3)

Server code can relay display values with TriggerClientEvent('concept_hud:client:setMoney', src, cash, bank, dirty) and the corresponding concept_hud:client:setNeeds or concept_hud:client:setJob events. It can apply stress with:

exports.concept_hud:AddStress(playerSrc, 5)
exports.concept_hud:RelieveStress(playerSrc, 10)

Concept Bridge (concept_bridge)

The HUD reads all framework, inventory, weapon, fuel, seatbelt and voice data through the Concept Bridge (concept_bridge) and never talks to provider resources directly. See the bridge installation and API guide. /hudbridgestatus reports fork=true when the required bridge modules are present and warns when they are missing.

If the bridge is stopped at runtime, the HUD keeps rendering with explicit degradation:

The HUD listens to the bridge's normalized events (OnPlayerLoaded, OnPlayerUnload, OnPlayerJobUpdate, OnNeedsUpdate, OnInventoryUpdate, OnInventoryOpenChange, OnWeaponUpdate, OnVoiceUpdate, OnSeatbeltUpdate, OnAccountUpdate).

The HUD refreshes cached data when the bridge changes providers. Consumer integrations that keep their own bridge references should follow the provider restart contract.

Custom frameworks. Either push values with the exports above, or register a module for live polling: exports.concept_bridge:RegisterModule('Framework', { ... }). See the bridge documentation for the module shape.

Security

• Admin settings are ACE-gated end-to-end: the Admin button, /hudadmin and every savePolicy call re-check permission on the server; drafts are sanitized and capped before they are saved and broadcast.
• Display-override events only accept invocations from concept_hud itself or server relays. There is no client-to-server-to-client relay, so players cannot spoof values onto other clients.
• The policy broadcast is public to all clients by design; saving policy or granting admin is not possible without the ACE.
• Stress compat events (hud:server:GainStress / RelieveStress) are off by default and bounded when enabled. Trusted server code should use AddStress / RelieveStress instead.

Display overrides change presentation, not authoritative inventory or account balances. Validate gameplay rewards and permissions in your own server code.

Escrow and licensing

The Tebex build is CFX escrow protected:

• Readable for setup: config.lua, locales/*.json, data/server_policy.example.json.
• Encrypted: the Lua under client/, server/ and shared/.
• Never encrypted: the React UI (web/dist). Never put secrets in it.

Use an entitled server license for the escrowed asset. THIRD_PARTY_LICENSES.md inside the resource documents the bundled fonts and third-party components; the commercial terms are on the /terms page.

Restart matrix

Troubleshooting

• Resource won't start / entitlement error. Confirm the Keymaster asset is on the same Cfx account as the server license key.
• Money or job stay at zero or empty. The Concept Bridge must be running and detect your framework. Run /hudbridgestatus and check fork=true / framework= / inventory=.
• Voice, seatbelt or weapon extras missing. Install the current Concept Bridge and check the provider configuration. The HUD warns when required bridge modules are missing; /hudbridgestatus reports fork=false in that case.
• Voice badge stuck. pma-voice must be running (/hudbridgestatus shows voice=pma-voice).
• Admin button missing. Grant the concept_hud.admin ACE (or whatever ACE you set via the concept_hud:adminAce convar) and restart the resource.
• Policy changes don't save. The resource folder must be writable; some hosting panels mount resources read-only, which blocks data/server_policy.json writes.
• Policy file corrupted or empty. It recovers automatically from data/server_policy.json.bak on the next start; only reach for a manual restore if the backup is gone too (and keep your own backups when editing by hand).
• Map missing on foot. The radar is vehicle-only by default; set Config.Show.mapOnFootItem or disable mapOnlyInVehicle.
• HUD blank after an update. Reconnect after ensure concept_hud; CEF caches the old UI aggressively.
• Dirty money shows $0. Check Config.Money.dirtyItems / dirtyAccount against your framework's item or account names.

Updates

Updates ship to the same Keymaster asset, so you don't need to buy it again. Your tuned data/server_policy.json is per-server: back it up when syncing a new build, or use the admin panel to reconfigure.

Support

• Check /status for known incidents.
• Ask on Discord or use the /contact form if something is broken after a clean install.
• Include your resource version, framework and /hudbridgestatus json output when reporting an issue.