Troubleshooting
The block never shows
- Unarmed and any hash in
Config.Hiddenhide it on purpose. - The layer is hidden while the pause menu is open.
- If
gta6_hudruns on the same server, you are looking at its built-in block; stop one of the two.
The native ammo counter is still visible
Config.HideNative must be true. It hides HUD component 2 every frame; another script that draws the component with ShowHudComponentThisFrame(2) would fight it.
A weapon shows numbers but no icon
The spawn name is missing from Config.Icons or the PNG is missing in html/icons. If the file fails to load, the NUI hides the icon and reports the smaller height. See Assets & Credits.
My HUD does not move under the block
- Your HUD must listen to
gta6_weaponhud:state(see Integration). - If your HUD starts later than gta6_weaponhud, it still receives a broadcast right away and again two seconds after it starts.
- Check the values with
exports.gta6_weaponhud:GetState().
Numbers use a fallback font
Pricedown comes from fonts.cdnfonts.com. Allow the host, or bundle the font and change index.html / style.css.
Still need help?
- Join the F5 Studio Discord
- Open a support ticket