nn_hud

---

General information before installing

nn-hud is a fully customizable HUD script for your FiveM server. With a single config.lua, you have full control over the HUD’s look, behavior, and features—perfect for roleplay, racing, or anything in between.

---

Common questions

🚀 Which frameworks are supported?

Answer: Edit config.lua:

-- QBCore
Config.Framework = 'qb'

-- ESX
Config.Framework = 'esx'

🛑 How can I disable the Stress and Stamina systems completely?

Config.DisableStress  = true   -- Disable Stress system
Config.DisableStamina = true   -- Disable Stamina system
Config.DisableOxygen  = true   -- Disable Oxygen system (for diving)

🎨 How do I customize the HUD theme colors?

Config.Theme = {
  primaryColor    = '#2563eb',  -- Main accent color
  successColor    = '#059669',  -- Success status color
  dangerColor     = '#dc2626',  -- Danger/warning color
  backgroundColor = '#f3f4f6',  -- Background color
  textColor       = '#1f2937',  -- Text color
  opacity         = 0.8         -- Overall transparency (0.0–1.0)
}