Skip to content

ThatMadCap/minimal-hud

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Minimal HUD

minimal-hud

A minimal hud built for FiveM.

Repo Downloads

How To UseDevelopment SetupContributingCreditsSupportLicense

The original repository has now been archived. This fork will continue to be maintained for the FiveM community.

How to Use

  • Download the latest release, add to your resources, ensure in your server.cfg.
  • Don't forget to set a framework in config/shared.lua and any custom logic into config/functions.lua.
  • If using the built-in seatbelt logic, add setr game_enableFlyThroughWindscreen true to your server.cfg.

Commands:

/togglehud -- toggle the HUD visibility on or off.

Exports:

-- state: true to show, false to hide.
exports['minimal-hud']:toggleHud(state) -- toggle HUD visiblity.
exports['minimal-hud']:toggleMap(state) -- toggle minimap visibility.

Development Setup

If you want to make changes to the HUD's UI, you can follow these steps to clone and run the project locally.
To clone and run this application, you'll need Git and Bun along with NodeJS installed on your computer. From your command line:

# Clone this repository
git clone https://github.com/ThatMadCap/minimal-hud.git

# Go into the repository
cd minimal-hud

# Navigate to the web folder
cd web

# Install dependencies using Bun
bun install

# Run the app
bun run dev

Contributing

I welcome contributions to improve minimal-hud, it would not be possible to maintain without the community. If you'd like to help enhance the resource, feel free to use discussions, open issues, or submit pull requests.

When contributing, please keep the following in mind:

  • Maintain the same style and theme as the existing HUD for a consistent user experience.
  • Follow the project's coding conventions.
  • Ensure any new features include appropriate tests where applicable.

I appreciate your support in keeping this resource free and accessible for the FiveM community!

Credits

This software uses the following open source packages:

Support

If you enjoy this project and want to show your support, consider buying me a coffee:

Support me on Ko-fi

Alternatively, if you'd like to support the original author of this HUD, vipexv, you can do so here:

ko-fi