Installation

This guide will walk you through setting up nox-hud on your FiveM server.

Prerequisites

Before installing nox-hud, ensure you have the following:

• FiveM Server with QBCore Framework
• ox_lib (latest version)
• Basic understanding of FiveM resource management

Step 1: Download

1. Purchase and download nox-hud from noxcore.tebex.io
2. Extract the downloaded archive

Step 2: Install Dependencies

Ensure ox_lib is installed and running:

ensure ox_lib

Step 3: Add Resource

1. Place the nox-hud folder in your server's resources directory
2. Add the following to your server.cfg:

ensure ox_lib
ensure nox-hud

⚠️ Important: nox-hud must start AFTER ox_lib

Step 4: Configure

Edit the shared.lua file to customize your HUD settings. See the Configuration guide for detailed options.

Step 5: Restart Server

Restart your server or use:

refresh
ensure nox-hud

Troubleshooting

HUD not appearing

1. Check if ox_lib is running: ensure ox_lib
2. Verify resource order in server.cfg
3. Check for errors in server console

Minimap position issues

1. Check resolutions.lua for your screen resolution
2. Adjust posx and posy values as needed

Fuel not displaying

1. Verify your fuel resource name in shared.lua
2. Check if the fuel export exists

File Structure

nox-hud/
├── shared.lua          # Main configuration (editable)
├── resolutions.lua     # Screen resolution presets (editable)
├── fxmanifest.lua     # Resource manifest
├── modules/           # Core modules (encrypted)
├── framework/         # Framework bridge (encrypted)
└── ui/               # React UI (built)

Editable Files

The following files are not encrypted and can be customized:

Last updated: January 28, 2026