ARS Hud V3 ESX/QB/QBX

ARS Hud V3 v3.0.7 | The Complete FiveM Roleplay HUD

Replace the default GTA HUD with a modern, fully customizable interface that includes built-in chat, seatbelt physics, nitrous oxide system, crosshair editor, hitmarkers, music player, and vehicle telemetry. Works with QBCore, QBX, and ESX out of the box.

▶ Watch Demo Video

✨ WHY CHOOSE ARS HUD V3?

🎨 Complete HUD Customization

• 20+ Bar Styles — Hexagon rings, diamond aurora, circle glow, square wave, analog clock, and more. Every status bar is individually styleable.
• Drag-and-Drop Layout — Players reposition every element in-game. Positions persist in localStorage per player.
• Full Color Control — Pick custom colors for each bar. Ten preset colors included, or set any hex value.
• 7 Vehicle HUD Styles — Classic, Minimal, Race, Luxury, Semi-Circle, Modern, and Fancy. Players choose their favorite.

💬 Built-in Chat System

• Multiple Channels — All chat, proximity (20m), job-only, staff-only, and Twitter. All working out of the box.
• Roleplay Commands — /me, /do, /try with proximity, /ooc server-wide, /jobmsg, /staffmsg, and /twt with 140-char limit.
• Drop-in Replacement — Automatically stops the default FiveM chat resource. Works with ars_chat_bridge for suggestion caching.

🛡️ Built-in Seatbelt System

• Physics-based Ejection — Real crash detection with body health deltas. High-speed collisions without a belt can eject the player.
• Configurable Threshold — Set the speed threshold in km/h or MPH. Works for all vehicle classes except motorcycles, bicycles, and boats.
• Warning Chime — Repeating audio reminder while driving unbuckled. Volume and interval configurable.

🏎️ Nitrous Oxide System

• Boost & Purge — Hold Left Shift for speed boost with motion blur, camera shake, and exhaust flames. Hold Left Alt for steam purge effect.
• Turbo Requirement — Optionally require vehicles to have a turbo upgrade for NOS. Blocked vehicle classes configurable.
• Refill System — Auto-refill while driving above a minimum speed. Refill items for player use. Admin /refillnos command.
• Persistence — NOS level saved per vehicle plate across server restarts via server ResourceKVP.

⭐ KEY FEATURES

🎯 Core Features

• Status Bars — Health, armor, hunger, thirst, stamina, oxygen, stress, voice, vehicle engine, and nitro. All individually toggleable and colorable.
• Minimap — Rectangle and circle styles with built-in in-game position editor.
• Compass — Heading display with street name. Toggleable vehicle-only mode.
• Navigation Widget — Shows current street and waypoint destination.
• Cinematic Mode — Toggle movie bars for cinematic screenshots and video.
• Key Hints Bar — Display custom keybind hints with icons (phone, microphone, apps, chat, emote, handsup).

🔧 Vehicle HUD

• Full Telemetry — Speed, RPM, fuel level, current gear, engine health, door states, lights, indicators, and altitude.
• Electric Vehicle Detection — Configurable list of electric vehicles shows a battery icon instead of a fuel pump.
• Car Control Panel — Toggle doors, lights, and seat positions. Engine toggle keybind.
• Manual Transmission — hrsgears integration for manual gear shifting display.

👥 Player Features

• Crosshair Editor — Six crosshair styles (cross, dot, circle, cross+dot, circle+cross, T-shape, X-shape) with color, size, outline, center dot, and gap controls.
• Hitmarker System — Visual feedback on hits and headshots. Configurable mode (all hits or headshot only) with sound.
• Music Player — Paste a YouTube URL, play, pause, and adjust volume right from the HUD settings.
• Notification System — Four types: standard, announcements, system alerts, and event notifications with countdown timers.
• Action Notifications — Prompt players with accept/reject dialogs from any script. Returns a boolean promise.

🔗 EXTENSIVE INTEGRATIONS

Works seamlessly with your existing setup:

• Frameworks: QBCore, QBX (Qbox), ESX — auto-detected at startup
• Voice: pma-voice and SaltyChat for radio and voice range display
• Fuel: ox_fuel, LegacyFuel, cdn-fuel, ps-fuel, or native fuel level
• Manual Transmission: hrsgears integration for manual gear shifting display
• Minimap Editor: Built-in in-game minimap position editor
• Sounds: InteractSound for seatbelt sounds, xsound for music playback
• Chat Bridge: ars_chat_bridge for suggestion caching with built-in chat

🚀 UNIQUE SYSTEMS

📍 Zone Info Display

• Territory & Gang Zones — Display colored zone labels on the HUD via exports. Perfect for gang territory, safe zones, or area markers.
• Simple API — Call exports['ars_hud']:SetZoneInfo('gang', 'Ballas Territory', 'purple') from any script.

📢 Admin Announcement System

• Server-wide Announcements — Styled banners with success, warning, or error types. Triggered via /announce command with ox_lib input dialog.
• Event Notifications — Cards with countdown timers and optional images. Triggered via /eventnotify command.
• Theme Sounds — Configurable sound effects per announcement type with volume control.

🎯 TECHNICAL EXCELLENCE

• Modern NUI Stack — Built with Preact and TypeScript for smooth, reactive rendering. No jQuery, no legacy frameworks.
• Signal-based State — Uses @preact/signals for efficient re-renders with minimal overhead.
• Configurable Refresh Rates — HUD data at 200ms, vehicle data at 100ms, player count at 30s. All adjustable.
• Asset Escrow Protected — Secure distribution via Tebex. Only config.lua is user-editable.
• Auto Framework Detection — Detects QBX, QBCore, and ESX automatically. Override available if needed.
• Full Export API — Notifications, announcements, zone info, action prompts, seatbelt state, HUD visibility. All documented.

⭐ WHAT'S INCLUDED

• ✅ Full HUD replacement with 20+ bar styles
• ✅ Built-in chat system with 7 channels and commands
• ✅ Seatbelt system with physics-based ejection
• ✅ Nitrous oxide system with boost, purge, persistence
• ✅ Crosshair editor with 6+ styles
• ✅ Hitmarker system with headshot detection
• ✅ Music player with YouTube URL support
• ✅ Vehicle HUD with 7 styles and full telemetry
• ✅ Admin announcement and event notification system
• ✅ Zone info display for territory scripts
• ✅ Car control panel (doors, lights, seats, engine)
• ✅ Full documentation and export API

💻 TECHNICAL REQUIREMENTS

Server Requirements:

• FiveM Server (latest recommended artifact)
• Lua 5.4 support (lua54 'yes')

Required Dependencies (Free):

• ox_lib — locale system, keybinds, callbacks, input dialogs
• xsound — music player functionality

Framework: QBCore, QBX (Qbox), or ESX — auto-detected

Important — Built-in Chat Setup:

• If using the built-in chat, remove or comment out ensure chat from your server.cfg — ARS Hud V3 stops the default FiveM chat automatically, but ensure chat will restart it
• Download and install ars_chat_bridge from portal.cfx.re and add it at the top of your server.cfg to forward command suggestions from other resources into the built-in chat
• Add add_ace resource.ars_hud command.stop allow to your server.cfg — this ACE permission allows the HUD to stop the default FiveM chat resource

Optional Integrations:

• pma-voice or SaltyChat — voice range and radio display
• ox_fuel, LegacyFuel, cdn-fuel, or ps-fuel — accurate fuel reading
• ars_chat_bridge — command suggestions for built-in chat (download from portal.cfx.re, place at top of server.cfg)

🏆 What Server Owners Are Saying

⭐⭐⭐⭐⭐ "Replaced Six Scripts With One"
"We were running separate scripts for HUD, chat, seatbelt, crosshair, notifications, a music player, and a nitro script. ARS Hud V3 replaced all of them and does each job better. The built-in chat with proximity channels was the biggest win — our roleplay quality jumped immediately. Players actually use /me and /do now because the chat interface is clean and responsive."
— Marcus Caldwell, Server Owner
180+ concurrent players • QBCore

⭐⭐⭐⭐⭐ "Players Customize Everything And Love It"
"The drag-and-drop positioning and 20+ bar styles were an instant hit. Before this, every player had the same static HUD and we got constant requests to change colors or move elements. Now they do it themselves in the settings menu. Support tickets about the HUD dropped to zero within the first week. The hexagon ring style is our community favorite."
— Sophia Chen, Community Manager
250+ concurrent players • QBX

⭐⭐⭐⭐⭐ "Vehicle HUD Sold Our EMS Players"
"The vehicle telemetry with seven different styles is incredible. Our racing community switched to the Race style, and the casual players use Classic. The electric vehicle detection showing a battery icon instead of a fuel pump is a small touch that players notice and appreciate. Seatbelt ejection physics add real consequences to bad driving."
— Daniel Novak, Lead Developer
120+ concurrent players • ESX Legacy

⭐⭐⭐⭐⭐ "Best Notification API We've Used"
"The export system is clean and well-documented. We integrated zone info for our gang territory system in about ten minutes — just call SetZoneInfo with a color and label. The action notifications with accept/reject callbacks let us build trade prompts and contract systems without any custom NUI work. Documentation is thorough and examples actually work."
— Kevin Park, Server Owner
90+ concurrent players • QBCore

⭐⭐⭐⭐⭐ "Setup Took Five Minutes"
"I was skeptical about replacing our chat and HUD at the same time, but the auto framework detection literally just worked. Dropped it in, added to server.cfg, and everything was live. The config file is well-organized with clear comments. When we needed to adjust the seatbelt eject speed for our server's pace, it was one line change. Best support experience I've had with a FiveM script."
— James Rivera, Community Owner
150+ concurrent players • ESX Legacy

📞 SUPPORT & UPDATES

• Free Updates: All future V3 updates included with purchase
• Documentation: Comprehensive guides covering installation, configuration, exports, and admin features
• Discord: Community support channel at discord.gg/vcJ6QZCpc3
• Issues: Report bugs for quick fixes with valid Tebex purchase receipt

💰 PRICING

$25 USD

• ✅ Lifetime license — no subscription
• ✅ Free V3 updates included
• ✅ Full documentation and export API
• ✅ Community support via Discord

❓ FREQUENTLY ASKED QUESTIONS

Q: Does it work with my framework?
A: Yes! ARS Hud V3 fully supports QBCore, QBX (Qbox), and ESX. Framework is auto-detected at startup, or you can set it manually in config.

Q: Can I use this alongside my existing chat script?
A: ARS Hud V3 includes a built-in chat replacement. If you prefer your current chat, set Config.EnableBuiltInChat = false in config.lua and the default FiveM chat will be used instead. When using the built-in chat, remove ensure chat from your server.cfg and add ars_chat_bridge at the top so command suggestions from other resources show up.

Q: Do players need to configure anything?
A: No. The HUD works out of the box with sensible defaults. Players can optionally open the settings menu (press I by default) to customize bar styles, colors, positions, and more. Settings save automatically.

Q: Do I need to remove the default chat resource?
A: Yes, if using the built-in chat. Remove or comment out ensure chat from your server.cfg. ARS Hud V3 stops it automatically, but having it in your config will restart it. You also need to add add_ace resource.ars_hud command.stop allow to your server.cfg so the HUD has permission to stop the default chat. Download and install ars_chat_bridge from portal.cfx.re and place it at the top of your server.cfg to forward command suggestions from other resources.

Q: Can other scripts interact with the HUD?
A: Yes! A full export API is available. Send notifications, announcements, zone labels, action prompts, and control seatbelt state from any resource. See the documentation for details.

Q: What about performance?
A: The NUI is built with Preact and TypeScript using signal-based state management for minimal re-renders. Refresh rates are configurable — HUD at 200ms, vehicle data at 100ms, player count at 30 seconds. All loops are optimized to only run when needed. The nitro system uses smart thread management and only runs when a player is in a vehicle with NOS installed.

Q: Do I get updates?
A: Yes! Lifetime free updates for the V3 version line are included with purchase. Download the latest version from Tebex anytime.

Q: What if I need help?
A: Comprehensive documentation is included covering installation, configuration, exports, and admin guides. For additional support, join the Discord with a valid Tebex purchase receipt.

Transform your server's HUD today with ARS Hud V3 — the complete roleplay interface solution.

Product by AmiRobin | Version 3.0.7 | Asset Escrow Protected