Menus & interfacesModified version

ps-hud

A more informative driving and player HUD.

A drs_Dev version of Project Sloth's ps-hud for QB-Core. It adds ox_fuel support and clearer vehicle, weapon, cash, and bank displays.

QBCoreAlso works with 3 other systems
Download latest code This is the latest code from GitHub, not a packaged release. Test it before using it on a live server.
Setup guide
Source code Problem reporting unavailableDemo
Version
2.1.2
Updated
Jul 19, 2026
License
GPL-3.0
Code access
Open-source code
Status
Stable
Resource previewPlayer status HUD
1 of 3
screenshotPlayer status HUD

Compact player information with the customized presentation.

Player status HUDCompact player information with the customized presentation.
01 / OVERVIEW

What it does

Type
Updated player and vehicle HUD
Best for
QB-Core servers using ox_fuel and ox_inventory
Fuel
Native fuel level; ox_fuel compatible
Resource name
Must remain ps-hud

This version keeps ps-hud's player customization and status display while showing more useful information during driving and combat. It still requires QB-Core.

This version updates the vehicle display, weapon and ammunition feedback, cash and bank information, ox_fuel support, and the ox_inventory safety-harness count without replacing the whole original HUD.

02 / FEATURES

Core features

01

Updated vehicle HUD

A redesigned driving display with vehicle information and configurable MPH or KPH behavior.

02

Weapon status

Optional armed-state and ammunition information integrates with the player HUD.

03

Money visibility

Optional cash and bank displays keep important account information close at hand.

04

Player customization

Players or administrators can adjust icon shape, size, position, color, orientation, and spacing.

What changed in this edition

Updated driving display

Shows speed, RPM, gear, engine, fuel, vehicle name, indicators, lights, cruise control, nitro, altitude, and seatbelt state.

Weapon and ammunition status

Adds weapon name, clip and reserve counts, magazine percentage, low-ammo feedback, and reloading state.

Money presentation

Updates cash and bank display behavior plus transaction feedback while hiding overlapping stock GTA elements.

OX support

Reads the vehicle's normal fuel value for ox_fuel support and checks ox_inventory for the player's active safety harness.

03 / SETUP OPTIONS

What you can change

These are the main parts you can adjust for your server. The setup guide lists every option and example.

  • Menu key and admin-only customization
  • Stress thresholds and vehicle classes
  • MPH or KPH calculation
  • Vehicle-name display
  • Weapon and ammunition display
  • Cash and bank modules
  • Icon layout, style, color, and spacing
  • Fuel blacklist
See every setup option
04 / REQUIREMENTS

What it works with

Server framework
QBCore
Fuel
Native vehicle fuel level; compatible with ox_fuel
Required script
ox_inventory to check whether the player has an active harness
UI
Compiled Svelte interface included
Resource name
Must remain ps-hud
Also works with
Svelte UI
See all requirements and setup options
Technical details2 details
Runtime
FiveM Lua
Interface
Svelte UI with compiled output and source
05 / LIMITATIONS

Known limitations

  • The script calls QB-Core directly. It is not a native Qbox version.
  • The safety-harness count requires ox_inventory, and the folder must stay named ps-hud.
  • The Config.FuelScript setting does not choose how fuel is read. This version uses GTA's normal vehicle fuel value.
  • Changing the MPH label may require rebuilding the Svelte interface. Saving administrator settings writes to uiconfig.lua.
More limitations1 more item
  • The original Project Sloth project is archived, and this version does not publish a named list of fully tested server setups.
06 / ORIGINAL PROJECT

Changes from the original

Original projectProject Sloth ps-hud
Base version2.1.2

This edition keeps the original QB-Core HUD and its customization options while updating the vehicle, weapon, money, fuel, and safety-harness information.

Differences between Project Sloth ps-hud and this drs_Dev edition
AreaOriginaldrs_Dev edition
Vehicle displayOriginal driving clusterExpanded cluster with vehicle name, fuel, transmission, lighting, belt, and related states
Combat displayOriginal HUD behaviorWeapon name, clip and reserve ammunition, percentage, reload, and low-ammo states
Economy displayOriginal cash behaviorOptional cash and bank modules with transaction feedback
OX supportOriginal fuel and harness behaviorReads the normal FiveM fuel level for ox_fuel and checks ox_inventory for the active harness
07 / INSTALLATION
Ready to install?

Open the setup guide

The guide covers requirements, installation, server setup, connections to other resources, and troubleshooting.

Read the installation guide
08 / VERSION & SOURCE CODE

Version and source code

Latest version

v2.1.2Repository snapshot · Jul 2026
  • Added ox_fuel compatibility.
  • Updated the vehicle UI and added weapon, cash, and bank HUD options.
View change history

Credits and license

Project type
Modified version
Maintainer
DrSnyder
License
GPL-3.0
Code access
Open-source code
Original project
Project Sloth ps-hud

A drs_Dev modification of Project-Sloth/ps-hud. The original project and its contributors are credited in the GitHub project.

View source code on GitHub