🖥 vl_hud — Fully Customizable ESX HUD

The HUD that puts you in control.
Clean, modern design with every element draggable, resizable, and fully yours.

Built for servers that care about detail — and players who want their HUD exactly where they want it.

🎬 Youtube Preview: 

🔥 Why vl_hud?

Most HUDs are fixed.
👉 vl_hud lets every player place everything.

With the built-in privilege system (as well as config option free for all), players can unlock full drag-and-drop positioning, scaling, and sound controls — making every session feel personal.

Perfect for:

• servers that want a premium feel

• players who need full HUD control

• admins who want one HUD for everything

✅ Works out of the box with ESX Legacy & oxmysql

💰 Money Display

• 💵 Cash, Bank & Dirty Money — live updated

• ⚡ Configurable update intervals (on foot & in vehicle)

• 🎛 Account names fully configurable in config.lua

🚗 Vehicle HUD

• 🏎 Speedometer with current speed display

• ⛽ Fuel level indicator — supports 7 fuel systems

• 🧳 Trunk usage bar (optional, requires inventory integration)

• ⚡ Fast 100ms refresh while driving (no server impact, scaled for large servers and tested with 300+ players)

Supported Fuel Systems:

• LegacyFuel, ox_fuel, cdn-fuel, ps-fuel, lc_fuel, okokGasStation, custom

🎤 Voice System Integration

• 🎙 Live mic indicator (idle / talking / muted)

• 📶 Voice range display in meters

• 📻 Radio / Walkie-Talkie channel display (SaltyChat)

• 👥 Live radio channel member list overlay

• ⚡ No extra setup required

👉 Switch easily:

Config.VoiceSystem = 'saltychat'  -- or 'pma-voice'

🍔 Basic Needs (Integrated)

• 🍔 Hunger & 💧 Thirst — animated SVG circle indicators

• ⚙ Three source modes — no uncommenting required:

  • builtin — integrated decay with configurable food/drink items in editable_sv.lua

  • esx_status — reads values from esx_status:onTick automatically

  • custom — push values from any resource via export

• ⏱ Configurable decay interval

• 💀 Optional damage when empty

• 🎮 Compatible with esx_basicneeds events

• ⏸ Pause/resume decay via event

📍 Location, Job & Server Info

• 🗺 Current zone & street name

• 💼 Job name & grade — live updated

• 🆔 Player server ID display

• 👥 Live online player count — updates on join/leave & every 30 seconds

🔓 HUD Privilege System (Optional)

• 🎯 Players can unlock full HUD customization

• 📦 Privilege stored in database — survives restarts

• ⭐ VIP bypass — VIPs always have privilege

• 📅 Configurable duration (default: 28 days)

• 📡 Discord webhook log on every purchase

Purchase System — 3 modes:

• free — always unlocked for everyone

• vl_shop — automatic coin deduction via vl_shop

• custom — plug in any coin/shop system via editable hook

👉 Configure in one line:

Config.PurchaseSystem = 'vl_shop'
Config.PrivilegePrice = 80
Config.PriceLabel     = 'Coins'

🎨 Full HUD Customization (with Privilege - Optional)

• 🖱 Drag every HUD element to any position

• 📐 Scale and resize individual elements

• 🔊 Toggle notification sound

• 🎬 Cinematic mode toggle

• 🔄 One-click reset for position, size, and toggles

• 💾 Settings saved in browser localStorage — persist after restart

👉 Open the settings panel:

/hud

🌐 Fully Responsive & Localizable

• 📐 Fully responsive — all elements use vw/vh units, perfectly scaled on every resolution (1280×720 up to 4K)

• 🌍 Full locale support via Config.Locale — translate every label in the settings panel to any language

• 🔤 No NUI edits required — all UI strings configurable in config.lua

👉 Example:

Config.Locale = {
    SettingsTitle = 'HUD SETTINGS',
    LabelCash     = 'Cash',
    LabelHunger   = 'Hunger',
    -- ... all labels configurable
}

🖥 Modern UI & Theming

• 🎨 Full color theming via config.lua — no CSS knowledge needed

• 🌈 Gradient support on icons, headings & accents

• 🖼 Custom logo in settings panel (your server logo)

• 🎙 Mic icon colors individually configurable (idle / talk / muted)

• ⭐ VIP badge display

👉 Change the entire look in seconds:

Config.UI = {
    PrimaryColor = '#FF6A00',
    AccentColor  = '#FFB800',
    GradientEnabled = true,
    LogoImage    = 'images/yourlogo.png',
}

🧑‍💻 Developer-Friendly

• 📂 Open hook files (no encryption):

  • config/config.lua

  • client/editable_cl.lua

  • server/editable_sv.lua

• ⛽ Custom fuel system hook (GetFuel)

• 🧳 Custom trunk system hook (GetTrunkUsage)

• 💰 Custom coin/shop hook (CheckCanPurchase)

• 🔔 Custom notification hook (client & server)

• ⭐ VIP system hook (CheckVIP)

• 🐞 Debug mode included

🎮 Commands

• ⚙ All commands configurable in config.lua

Default Commands:

• /hud → Open HUD settings panel

• /togglehud → Toggle HUD visibility

• /heal [playerId] → Admin command — restore health, hunger & thirst for a player

⚙ Installation

1. 📁 Upload vl_hud to your resources

2. ➕ Add to server.cfg:

   ensure vl_hud

3. 🗄 Import the SQL table (auto-created on first start via oxmysql)

4. ⚙ Configure config/config.lua to your needs

5. 🔧 Adapt hooks in editable_cl.lua & editable_sv.lua

6. 🔄 Restart server

📦 Requirements

• ✅ ESX (Legacy or newer)

• ✅ oxmysql

🛠 Configuration Overview

Feature            Location

Colors & Theming       config.lua → Config.UI

Money Accounts       config.lua

Privilege System       config.lua + server/editable_sv.lua

Fuel System           config.lua + client/editable_cl.lua

Trunk Usage           config.lua + server/editable_sv.lua

Voice System          config.lua

Basic Needs           config.lua → Config.BasicNeeds

Locale / UI Labels    config.lua → Config.Locale

Webhook Logging       server/editable_sv.lua

Notifications          client/editable_cl.lua + server/editable_sv.lua

🔓 Escrow / Open Files

Editable files:

• config/config.lua

• client/editable_cl.lua

• server/editable_sv.lua

• fxmanifest.lua

🔒 Core logic protected via Tebex Escrow

💬 Support

🌐 Website: https://velonlabs.io
💬 Discord: Join for support & updates

🏆 VelonLabs

Quality FiveM scripts for serious servers.