[QB/ESX/QBX] Advanced Custom HUD System

IMAGES


:bullseye: ORION HUD v2.0

A clean, modern and fully customizable HUD for FiveM — compatible with QBx Core, QB-Core and ESX. Signature Orion Studios design.


:sparkles: Features

:white_check_mark: Multi-Framework: Native support for QBx Core, QB-Core and ESX. Auto-detects your framework on startup — no manual wiring.

:white_check_mark: 6 Vehicle HUD Styles: Minimal, Dial, Side, Semi, Race and Strip — switch live via /hudmenu, no restart needed.

:white_check_mark: 7 Stat Shapes: Square, Circle, Bars, Ring, Dash Sq, Dash Ring and Border — all switchable in-game from the menu.

:white_check_mark: 3-State Stat Visibility: Each stat (health, hunger, thirst, armor, stamina) can be set to Visible, Auto (appears only when low, with smooth fade) or Hidden — per stat, saved per player.

:white_check_mark: 20-Color Palette: Every stat and border has an independent color selector with 20 preset colors.

:white_check_mark: Full Vehicle Panel: Speed (KMH / MPH), RPM, fuel level, engine health, gear, lock status and seatbelt indicator — all in one.

:white_check_mark: 14 Fuel Scripts Supported: Auto-detects your active fuel script on startup. No manual wiring — just set "auto" and go.

:white_check_mark: Seatbelt System: Built-in seatbelt with key binding and physical ejection on crash (with collision-aware ejection — no more clipping through walls). Also compatible with external seatbelt scripts via event.

:white_check_mark: Drag & Drop Layout Editor: Move every HUD element freely with /hudedit. Positions are saved per client — pixel-perfect, no blurry borders.

:white_check_mark: Minimap Integration: Clock, date and street name displayed directly on the minimap bar. Minimap can be set to show only when in a vehicle.

:white_check_mark: Voice Activity: Shows active speakers in the current radio channel when using pma-voice — server-side validated, players can only see their own channel.

:white_check_mark: Custom Logo: Display your server logo in the top-right corner — configurable URL. Option to lock position or allow drag in the layout editor.

:white_check_mark: Notification System: Built-in toast notifications with sound feedback (info, success, error), exposed via client event.

:white_check_mark: Cinematic Mode: Hides the HUD cleanly for screenshots or cinematic sequences, toggled from the menu.

:white_check_mark: Bilingual: English (en) and Spanish (es) included, fully extensible — unknown languages fall back to English safely.


:package: Installation

No SQL required — drop and play.

  1. Drop orion-hud into your resources/ folder.
  2. Add to server.cfg:
ensure orion-hud
  1. Configure config.lua to set your framework, language, fuel script and preferences.

:gear: Configuration

-- config.lua

-- Framework: 'auto' | 'qb-core' | 'qbx_core' | 'es_extended'
Config.Framework = 'auto'

-- Language: 'en' | 'es'
Config.Language = 'en'

-- Vehicle HUD
Config.showSpeedometer = true
Config.UseMPH          = false   -- false = KMH | true = MPH

-- Fuel script (see full list below)
Config.FuelScript = "auto"

-- Seatbelt
Config.useSeatbelt        = true   -- true = built-in | false = external event
Config.seatbeltKey        = 'b'
Config.seatbeltEjectSpeed = 100    -- Min speed km/h for ejection without seatbelt

-- Logo
Config.showLogo    = true
Config.logoIcon    = "https://your-logo-url.png"
Config.logoMovable = true          -- false = fixed position, excluded from layout editor

-- Voice
Config.usePMAVoice = true          -- Requires pma-voice

:video_game: Commands

Command Action
/hudmenu Open / close HUD settings menu (F10)
/hudedit Toggle drag & drop layout editor
/hudreset Reset all positions to default
/togglehud Show or hide the entire HUD
B (default) Toggle seatbelt on / off

:automobile: Vehicle HUD Styles

Style Description
Minimal Compact bar overlaid on the minimap
Dial Circular dial gauges
Side Vertical panel on the right
Semi Semicircle gauges
Race Race-style arc display
Strip Horizontal strip bars

:fuel_pump: Fuel Compatibility

auto (recommended) · default (native GTA V) · LegacyFuel · ox_fuel · qb-fuel · ps-fuel · qs-fuelstations · Renewed-Fuel · ti_fuel · x-fuel · cdn-fuel · esx-sna-fuel · lc_fuel · BigDaddy-Fuel · okokGasStation


:memo: Notes

  • Frameworks: QBx Core, QB-Core, ESX (auto-detected)
  • Optional: pma-voice (radio panel), any supported fuel script
  • No database — fully client-driven, zero SQL


:shopping_cart: Purchase

Buy on Tebex: Orion HUD on Tebex

Code is accessible No / Partial
Subscription-based No
Version 2.0.0
Lines (approximately) +~3000
Support Yes