F5 StudioF5 Studio
Skip to main content

Installation

gta6_weaponhud draws only the weapon block from the GTA VI HUD: when a weapon is drawn, the top-right corner shows the clip count, the reserve count in muted white and, below them, the weapon icon. It works on any framework because all data comes from natives, and it tells other HUDs how tall it is so they can move their own top-right elements out of the way.

Not for gta6_hud users

gta6_hud contains the same block (Config.CustomWeaponHud). Install gta6_weaponhud only when you use a different HUD. Running both draws two blocks in the same corner.

Requirements​

RequirementDetails
FrameworkNone
FiveM ServerAny recent build. Lua 5.4
Internet on the clientThe Pricedown font is loaded from fonts.cdnfonts.com

Step by Step​

1. Folder structure​

Folder structure
resources/
  [gta6]/
    gta6_weaponhud/
      html/
        icons/        (101 weapon icons)
        index.html
        app.js
        style.css
      client.lua
      config.lua
      fxmanifest.lua
      README.md

2. Server config​

server.cfg
ensure my-hud
ensure gta6_weaponhud

Start it after the HUD that wants to listen to its state event, so the event handler exists when the first state is broadcast. (The resource also re-broadcasts whenever any other resource starts, so the reverse order still recovers within two seconds.)

3. Test​

Draw a pistol: the numbers and the icon should appear at the top right and the native ammo counter should be gone. Holster the weapon: the block disappears.

Next steps​