drs_Devby DrSnyder
Menu
View resources
Browse documentationps-hud
On this page
Resource guide

ps-hud

A more informative driving and player HUD.

QBCoreOX FuelOX InventorySvelte UI
Resource page View source
Version
v2.1.2
Updated
Jul 19, 2026
License
GPL-3.0
01 / OVERVIEW

Start here

This fork is a QBCore HUD with DrSnyder's vehicle cluster, weapon and ammunition display, money feedback, ox_fuel support, and ox_inventory harness detection. Treat QBCore as a required dependency rather than a native Qbox resource.

02 / REQUIREMENTS

What you need

FrameworkQB-Core
FuelNative vehicle fuel level; compatible with ox_fuel
Required runtimeox_inventory for the active harness lookup
UICompiled Svelte interface included
Resource nameMust remain ps-hud
03 / INSTALLATION

Install and start

  1. 01

    Place ps-hud in your designated resources folder without renaming it.

  2. 02

    Ensure QB-Core is current and starts before ps-hud.

  3. 03

    Review Config.UseMPH, Config.CustomHud, and Config.AdminOnly in config.lua.

  4. 04

    Ensure ps-hud, then review icon settings and vehicle behavior in-game.

Recommended start orderplain text
ensure qb-core
ensure ox_inventory
ensure ox_fuel
ensure ps-hud
04 / CONFIGURATION

Configuration checkpoints

01

Understand the fuel-reading path

This fork reads FiveM's native vehicle fuel level, which works with ox_fuel when it synchronizes that value. The inherited Config.FuelScript setting does not change the active fuel reader by itself.

02

Choose speed units

Config.UseMPH changes the speed calculation. Changing the displayed unit text also requires UI work; rebuilding from svelte-source is safer than editing the compiled interface directly.

03

Enable the added HUD modules

Review the vehicleName, weaponAmmo, and money options under Config.CustomHud, then decide whether customization should be restricted through AdminOnly.

04

Keep the compiled interface

The html directory is ready to run. The svelte-source directory is for UI development and does not need to be rebuilt for a normal installation.

05 / USAGE

Validate the resource

First-run checklist

Join after the framework and HUD have started, enter a vehicle, equip a weapon, change cash or bank values, and verify the player, vehicle, weapon, and money displays independently.

Commandsplain text
/menu
/resethud

Preserve optional audio feedback

Start InteractSound before ps-hud if your configuration uses its menu, belt, or alert sounds.

06 / TROUBLESHOOTING

Common checks

The HUD does not initialize

Keep the resource folder named ps-hud, update qb-core, and confirm qb-core starts before the HUD.

Harness detection is missing

Confirm ox_inventory is started and the harness item exists. This edition checks the item count through ox_inventory.

Fuel is not updating

Confirm the fuel resource starts before ps-hud and synchronizes FiveM's native vehicle fuel level. Config.FuelScript does not select the active reader in this fork.

Two HUD elements overlap

Disable the equivalent stock or third-party HUD element so only one resource owns each vehicle, weapon, money, or minimap surface.