NEXO Scripts · Documentation

Everything to install, configure and get the most out of every NEXO resource.

NX HUD

Liquid-glass HUD with a built-in RP chat in a single CEF-safe resource: 3 themes, an in-game theme creator, a per-element editor, seatbelt, speedometer and 16 languages. Multiframework QBCore / Qbox / ESX by auto-detection, no ox_lib. Resource: nx-hud.

Installation

nx-hud folder in resources/, after your framework core.

ensure nx-hud

No mandatory dependencies. Press F7 in-game to open the customization menu.

If you use the built-in chat, remove any ensure chat from server.cfg (nx-hud declares provide 'chat'). To keep your own chat instead, set Config.Chat.enabled = false.

Features

  • CEF-safe liquid glass (no backdrop-filter flicker), 100% local fonts and icons.
  • Built-in RP chat: /me, /do, /ooc, /tweet, /clear, /911, /sos; keys T / L / G.
  • 3 themes (Nexo, Meteora, From Zero) plus an in-game theme creator and a per-element editor (F7).
  • Speedometer with FUEL / ENG / BELT, integrated seatbelt + airbag, managed minimap.
  • Status bars, framework notification capture, 16 languages.

Configuration

Edit config.lua (open, editable after purchase):

OptionDescription
Config.LocaleLanguage (16 locales in locales/)
Config.Bridge.Framework'auto' / 'qb' / 'qbox' / 'esx' / 'ox'
Config.Chat.enabledBuilt-in chat on/off (false to run your own)
Config.ElementsWhich HUD elements are visible
Config.SpeedometerEnable and default unit (MPH/KMH)
Config.Seatbeltenabled, toggleKey (B), ejectThreshold, preventExit
Config.NotificationsPosition, max visible, duration
Config.UpdateIntervalRefresh rate (lower is smoother, more cost)

shared/chat_config.lua holds the chat command names, colors and the filter hotbar. Player-side tweaks (theme, element visibility, units) are saved in the client's local storage.

Commands and keys

InputWhat
F7Open the customization / theme menu
BToggle seatbelt (in a vehicle)
T / L / GChat input / clear / help while downed
/me /do /ooc /tweet /911 /sosRP chat commands

Exports

exports['nx-hud']:ShowHud(true)        -- show / hide the HUD
exports['nx-hud']:GetSeatbeltState()   -- read belt state
exports['nx-hud']:ToggleSeatbelt()     -- toggle belt

Common errors

  • HUD doesn't appear -> check ensure nx-hud is after your framework core; read the bridge line in the server console (FW=...) and force Config.Bridge.Framework if the detected framework is wrong; clear the client cache.
  • Hunger/thirst show 100 -> on ESX they need esx_status; on ox_core (experimental) there is no status provider by default.
  • Seatbelt conflicts -> if you run another seatbelt resource, set Config.Seatbelt.enabled = false.
  • My theme reset -> player settings live in the client's local storage; clearing the FiveM cache removes them.