M-HUD

M-HUD - Modern Vehicle HUD System for ESX & QBCore

Upgrade your FiveM server's user interface with M-HUD, a sleek and customizable heads-up display that brings modern gaming aesthetics to your players' driving experience. This comprehensive HUD system displays all critical vehicle and character information in an elegant, minimalist design that doesn't obstruct gameplay. Whether your players are street racing, conducting police pursuits, or just cruising through the city, M-HUD provides instant access to vital stats like speed, fuel, health, and more - all while maintaining excellent performance and frame rates.

What's Included

M-HUD is a complete interface overhaul that replaces the default GTA V HUD with custom elements designed specifically for roleplay servers. You get a dynamic speedometer that changes color based on speed, real-time fuel gauge with low-fuel warnings, health and armor indicators, compass with street names, seatbelt status display, and engine damage visualization. The system includes full configuration files allowing you to customize colors, positioning, opacity, and which elements are shown. It's optimized to use minimal resources (typically 0.01-0.02ms resmon) so it won't impact your server's performance even with 200+ players online.

Key Features

• Dynamic Speedometer - Real-time speed display in MPH or KM/H with color-coded zones (green/yellow/red for different speeds)
• Fuel Management - Precise fuel percentage with visual gauge and low-fuel warning indicators
• Health & Armor - Character vitals displayed with smooth animations and critical health warnings
• Compass Navigation - Street name display and cardinal directions for easy navigation around the map
• Seatbelt System - Visual indicator showing belt status with integration options for crash damage scripts
• Engine Damage - Real-time vehicle health monitoring showing engine, body, and tire damage levels
• Altitude Display - For aircraft and helicopters, shows current altitude above sea level
• Gear Indicator - Shows current transmission gear (if using manual transmission scripts)
• Customizable Layout - Drag-and-drop positioning system or config-based placement options
• Color Themes - Multiple preset color schemes or create your own custom palette

Perfect For

• Roleplay servers wanting modern, immersive UI elements that enhance gameplay
• Racing communities needing precise speed and performance data
• Realistic servers with fuel consumption and vehicle maintenance mechanics
• Police/EMS servers where quick health assessment is critical
• Any server looking to replace the dated default GTA V HUD
• Servers running vehicle damage scripts that need visual feedback
• Communities that value clean aesthetics and performance optimization

Technical Details

• Performance: 0.01-0.02ms resmon - exceptionally lightweight and optimized
• Framework Compatibility: Works with ESX, QBCore, QBOX, and standalone configurations
• Dependencies: None required (integrates with existing fuel/damage scripts if present)
• File Format: Clean, documented Lua and HTML/CSS for easy customization
• Display Units: Supports both MPH and KM/H speed display
• Resolution: Responsive design works on all screen resolutions and aspect ratios

Installation & Configuration

1. Download and extract the M-HUD resource package to your resources folder
2. Add ensure m-hud to your server.cfg file
3. Configure settings in config.lua - set speed units, colors, positioning, and enabled features
4. If using fuel scripts (LegacyFuel, ox_fuel, etc.), enable integration in config for fuel display
5. Restart your server and test in-game - HUD appears automatically when entering vehicles
6. Fine-tune positioning and opacity settings based on your preference

Framework Integration

• ✅ ESX Legacy - Full integration with ESX player data, health, and job systems
• ✅ QBCore - Native support for QB player metadata and vehicle ownership
• ✅ QBOX - Compatible with QBOX's enhanced framework features
• ✅ Standalone - Works independently without framework dependencies

What Makes It Stand Out

Most HUD systems overwhelm players with information or use outdated designs that clash with modern gaming expectations. M-HUD takes a minimalist approach - showing exactly what drivers need without cluttering the screen. The color-coded speedometer provides instant visual feedback without requiring players to read numbers while driving at high speeds. The smooth animations and fade effects create a polished, AAA-game feel that elevates perceived server quality. Unlike bloated HUD packs that drag down performance, M-HUD is engineered for efficiency with sub-0.02ms resource usage - you could run 50 copies simultaneously without performance impact. The responsive design means it looks perfect whether players use 1080p monitors or ultrawide displays.

Customization Options

M-HUD includes extensive customization without requiring coding knowledge. The config.lua file uses simple true/false toggles and hex color codes to control every aspect. Want the speedometer on the right side instead of left? Change one coordinate value. Prefer blue accents instead of the default teal? Replace the hex color code. You can enable or disable individual elements - some servers might want compass but no altitude display, others might prioritize fuel management. The system also supports localization with multi-language support for street names and UI labels. For developers, the clean code structure makes advanced modifications straightforward if you want to integrate custom elements or additional vehicle data.

Performance & Compatibility

Built from the ground up for FiveM's environment, M-HUD leverages native functions and efficient update cycles to minimize resource consumption. It updates vital information like speed and fuel on every frame for accuracy, but uses smart caching for static elements like street names to avoid unnecessary processing. The system is compatible with virtually all vehicle scripts, fuel systems, damage mechanics, and seatbelt resources through standard exports and events. It's been tested on servers ranging from 32 to 512 slots with various mod configurations. Whether you're running vanilla vehicles or 500 custom car addons, M-HUD adapts seamlessly.