Weapon HUD 2.0 - Overhaul
2 665
26
-
7 päivää sitten
WeaponHUD
About:
A script that brings a clean, modern weapon HUD inspired by FiveM-style weapon interfaces to GTA V Singleplayer.
v2.0 is a complete overhaul
The old HUD has been completely rebuilt with a new card-based design, custom weapon images, separate EQUIPPED / HOLSTERED states, smooth animations, resolution-safe scaling, and much easier weapon customization.
Switch weapons and WeaponHUD will show what you holstered and what you equipped, together with the weapon's image and custom name.
Features:
- Completely redesigned HUD for v2.0
- FiveM-inspired weapon card design
- Displays weapon status: EQUIPPED / HOLSTERED
- Displays actual weapon images directly on the HUD
- Custom transparent PNG weapon images supported
- Included default GTA weapon icon pack
- Custom weapon names through WeaponHUD.ini
- Every supported weapon is already listed in the INI
- Side-by-side display when switching directly between weapons
- Shows the previous weapon as HOLSTERED and the new weapon as EQUIPPED
- Smooth fade-in / fade-out transitions
- Subtle movement animation when appearing/disappearing
- Bottom red lifetime indicator that smoothly shrinks until the HUD disappears
- Resolution and aspect-ratio safe HUD scaling
- Designed to remain consistently centered and sized across different screens
- Extensive INI customization for HUD size, spacing, opacity, colors, text, images, header, footer, timing and more
- Weapon images retain their original colors
- Supports melee weapons, handguns, SMGs, rifles, machine guns, shotguns, snipers, launchers, throwables and utility weapons
- Lightweight
- No in-game configuration menu
- No INIFileParser.dll dependency anymore
Custom Weapons / Images:
WeaponHUD v2.0 allows you to replace both the displayed name and image of any supported weapon.
For example:
Pistol=Pistol
can become:
Pistol=Glock 17
and under [Images]:
Pistol=pistol.png
can become:
Pistol=glock17.png
Just place your custom image inside:
scripts/WeaponHUD/images
Transparent 512x256 PNG images are recommended.
IMPORTANT:
Do not edit the weapon key on the LEFT side of =.
Only edit the name or filename on the RIGHT side.
Example:
CombatPistol=Glock 19
NOT:
Combat Pistol=Glock 19 or Glock 19=CombatPistol
The included custom_images folder also contains extra images you can copy into the main images folder and configure through the INI.
Custom Images included:
1911, AR-15, ARP (Blue/Green/Purple/Red/Yellow), AR Pistol (Black), Micro Draco (Black/Normal), Glock 17 with Switch & Extended Clip, FN-57, FN 509, Glock 17, Glock 18, Glock 19, Glock 19x, Glock 22, Glock 26, Glock 43x, Hi Point C9, Mac-10, Sig Sauer, S&W M&P, Springfield Hellcat, Taser, Taurus G2C, Tec-9 and iPhone 15.
Configuration:
WeaponHUD.ini contains the complete configuration for the mod.
You can customize things such as:
- HUD scale
- Card dimensions
- Card spacing
- Background opacity/colors
- Header and footer appearance
- EQUIPPED / HOLSTERED header colors
- Text size and fonts
- Weapon image size and offsets
- Shadows
- Accent appearance
- Display duration
- Fade timing
The included settings are already tuned for the intended v2.0 design, so configuration is completely optional.
Requirements:
- GTAV Legacy
- Script Hook V
- Script Hook V .NET (🔸Nightly Build recommended🔸)
Using outdated versions of SHVDN may cause crashes or prevent the script from loading.
Use the latest compatible versions.
Installation:
1. Delete any older version of WeaponHUD before installing
2. Drop WeaponHUD.dll, WeaponHUD.ini and the WeaponHUD folder into your scripts folder
INIFileParser.dll is no longer required.
To uninstall, remove WeaponHUD.dll, WeaponHUD.ini and the WeaponHUD folder.
Changelog:
v1.0 – Initial release
v1.0.1 (hotfix) - Uploaded wrong .DLL, now it should work correctly.
v1.0.2 (hotfix) - Added INIFileParser.dll for users who did not already have it, as the original script required it to read WeaponHUD.ini.
v1.1 - Major Update:
-> Added in-game configuration menu
-> Added live HUD preview while configuring
-> Added extensive size/color/position customization
-> Added F10 menu controls and automatic saving
-> Improved decimal parsing
-> Fixed initialization/loading issues
-> Improved input handling
-> Stability improvements and code cleanup
v2.0 - COMPLETE OVERHAUL:
- Completely rebuilt the HUD from the ground up
- Brand-new compact FiveM-inspired card design
- Added custom weapon images
- Added included default weapon image mappings
- Added [Images] configuration for replacing weapon artwork
- Expanded and reorganized [WeaponsName] configuration
- Every supported weapon is pre-listed so users only edit values after =
- Added side-by-side HOLSTERED + EQUIPPED cards when switching weapons
- Added separate header, weapon area and footer layout
- Added resolution/aspect-ratio safe sizing and centering
- Added smooth fade and subtle slide animations
- Added animated red lifetime/countdown indicator
- Weapon images now preserve their original colors
- Added extensive HUD customization through the INI
- Removed the old in-game configuration menu
- Removed F10 / tilde menu controls
- Removed dependency on INIFileParser.dll
- Added built-in INI reading
- Added automatic WeaponHUD/images folder and default configuration creation
- Improved weapon-name handling and long-name shortening
- Major code cleanup and rewrite
- Overall visual quality and consistency massively improved
DO NOT RE-UPLOAD without permission!
If you like this mod let me know in the comments :)
@ww_aleeex // @aleksforreal // 7aleksforreal
Discord Server: https://discord.gg/3tVa3m9WPv (new link)
Ensimmäinen lataamiskerta: 21. maaliskuuta 2026
Viimeksi ladattu: 7 päivää sitten
Last Downloaded: 1 hour ago
41 kommenttia
More mods by aleksforreal:
WeaponHUD
About:
A script that brings a clean, modern weapon HUD inspired by FiveM-style weapon interfaces to GTA V Singleplayer.
v2.0 is a complete overhaul
The old HUD has been completely rebuilt with a new card-based design, custom weapon images, separate EQUIPPED / HOLSTERED states, smooth animations, resolution-safe scaling, and much easier weapon customization.
Switch weapons and WeaponHUD will show what you holstered and what you equipped, together with the weapon's image and custom name.
Features:
- Completely redesigned HUD for v2.0
- FiveM-inspired weapon card design
- Displays weapon status: EQUIPPED / HOLSTERED
- Displays actual weapon images directly on the HUD
- Custom transparent PNG weapon images supported
- Included default GTA weapon icon pack
- Custom weapon names through WeaponHUD.ini
- Every supported weapon is already listed in the INI
- Side-by-side display when switching directly between weapons
- Shows the previous weapon as HOLSTERED and the new weapon as EQUIPPED
- Smooth fade-in / fade-out transitions
- Subtle movement animation when appearing/disappearing
- Bottom red lifetime indicator that smoothly shrinks until the HUD disappears
- Resolution and aspect-ratio safe HUD scaling
- Designed to remain consistently centered and sized across different screens
- Extensive INI customization for HUD size, spacing, opacity, colors, text, images, header, footer, timing and more
- Weapon images retain their original colors
- Supports melee weapons, handguns, SMGs, rifles, machine guns, shotguns, snipers, launchers, throwables and utility weapons
- Lightweight
- No in-game configuration menu
- No INIFileParser.dll dependency anymore
Custom Weapons / Images:
WeaponHUD v2.0 allows you to replace both the displayed name and image of any supported weapon.
For example:
Pistol=Pistol
can become:
Pistol=Glock 17
and under [Images]:
Pistol=pistol.png
can become:
Pistol=glock17.png
Just place your custom image inside:
scripts/WeaponHUD/images
Transparent 512x256 PNG images are recommended.
IMPORTANT:
Do not edit the weapon key on the LEFT side of =.
Only edit the name or filename on the RIGHT side.
Example:
CombatPistol=Glock 19
NOT:
Combat Pistol=Glock 19 or Glock 19=CombatPistol
The included custom_images folder also contains extra images you can copy into the main images folder and configure through the INI.
Custom Images included:
1911, AR-15, ARP (Blue/Green/Purple/Red/Yellow), AR Pistol (Black), Micro Draco (Black/Normal), Glock 17 with Switch & Extended Clip, FN-57, FN 509, Glock 17, Glock 18, Glock 19, Glock 19x, Glock 22, Glock 26, Glock 43x, Hi Point C9, Mac-10, Sig Sauer, S&W M&P, Springfield Hellcat, Taser, Taurus G2C, Tec-9 and iPhone 15.
Configuration:
WeaponHUD.ini contains the complete configuration for the mod.
You can customize things such as:
- HUD scale
- Card dimensions
- Card spacing
- Background opacity/colors
- Header and footer appearance
- EQUIPPED / HOLSTERED header colors
- Text size and fonts
- Weapon image size and offsets
- Shadows
- Accent appearance
- Display duration
- Fade timing
The included settings are already tuned for the intended v2.0 design, so configuration is completely optional.
Requirements:
- GTAV Legacy
- Script Hook V
- Script Hook V .NET (🔸Nightly Build recommended🔸)
Using outdated versions of SHVDN may cause crashes or prevent the script from loading.
Use the latest compatible versions.
Installation:
1. Delete any older version of WeaponHUD before installing
2. Drop WeaponHUD.dll, WeaponHUD.ini and the WeaponHUD folder into your scripts folder
INIFileParser.dll is no longer required.
To uninstall, remove WeaponHUD.dll, WeaponHUD.ini and the WeaponHUD folder.
Changelog:
v1.0 – Initial release
v1.0.1 (hotfix) - Uploaded wrong .DLL, now it should work correctly.
v1.0.2 (hotfix) - Added INIFileParser.dll for users who did not already have it, as the original script required it to read WeaponHUD.ini.
v1.1 - Major Update:
-> Added in-game configuration menu
-> Added live HUD preview while configuring
-> Added extensive size/color/position customization
-> Added F10 menu controls and automatic saving
-> Improved decimal parsing
-> Fixed initialization/loading issues
-> Improved input handling
-> Stability improvements and code cleanup
v2.0 - COMPLETE OVERHAUL:
- Completely rebuilt the HUD from the ground up
- Brand-new compact FiveM-inspired card design
- Added custom weapon images
- Added included default weapon image mappings
- Added [Images] configuration for replacing weapon artwork
- Expanded and reorganized [WeaponsName] configuration
- Every supported weapon is pre-listed so users only edit values after =
- Added side-by-side HOLSTERED + EQUIPPED cards when switching weapons
- Added separate header, weapon area and footer layout
- Added resolution/aspect-ratio safe sizing and centering
- Added smooth fade and subtle slide animations
- Added animated red lifetime/countdown indicator
- Weapon images now preserve their original colors
- Added extensive HUD customization through the INI
- Removed the old in-game configuration menu
- Removed F10 / tilde menu controls
- Removed dependency on INIFileParser.dll
- Added built-in INI reading
- Added automatic WeaponHUD/images folder and default configuration creation
- Improved weapon-name handling and long-name shortening
- Major code cleanup and rewrite
- Overall visual quality and consistency massively improved
DO NOT RE-UPLOAD without permission!
If you like this mod let me know in the comments :)
@ww_aleeex // @aleksforreal // 7aleksforreal
Discord Server: https://discord.gg/3tVa3m9WPv (new link)
Ensimmäinen lataamiskerta: 21. maaliskuuta 2026
Viimeksi ladattu: 7 päivää sitten
Last Downloaded: 1 hour ago
-
-
-
@gta5modder20202 offset depends on display settings, screen resolution and more. its not the same for everyone thats why i made that F10 menu just change the values to ur liking and then click F10 again to save. u can change colors sizes distances height width everything. move to center than adjust the values til its okay for ur display
19. kesäkuuta 2026 -
-
Tuff!any way i can remove take that whole damn vanilla weapon wheel away 😂i hate ts
30. elokuuta 2026 -
@bizmeta1 yo bro thanks for review. about removing the vanilla weapon wheel, i have no idea but i also hate it fr 😂. stay tuned though i got an update on the way for this mod i remade the UI and also added images for example if u replaced the pistol gun model with a glock 17 u can make it so it says glock 17 and shows image of a glock 17 just like in them fivem servers if u know what i mean ill upload soon
9 päivää sitten -
-
-
Would it be possible to add the possibility to support addon weapons? Currently it only shows weapon hash numbers with no images.
6 päivää sitten -
Bro, I have a problem: whenever I try to equip a weapon, it kicks me out of the game.
6 päivää sitten -
@unitedOrange66 to be honest i dont use addon weapons so i didnt really think of adding support for them but i will keep that in mind and add it next update thx for review. ill see what i can do for sure
5 päivää sitten -
@Jordienp legacy or enhanced? i always use legacy so i have no idea if it works for enhanced. if u on legacy u need latest script hook v, latest script hook v dot net NIGHTLY BUILD. I dont know if it works with enhanced script hook by Chiheb-Bacha. if still not solved dm me on discord or write in discord server chat
5 päivää sitten -
-
@ww_aleeex Thank you, can't wait. Also, it would be cool to see the option to disable cards from showing up while in a vehicle.
5 päivää sitten -
V2.0 UPDATE - COMPLETE OVERHAUL
WeaponHUD has been fully rebuilt with a brand-new FiveM-inspired design, custom weapon images/names, EQUIPPED + HOLSTERED cards, smoother animations, and resolution-safe scaling. The old F10 configuration menu has been removed .... everything is now customized through WeaponHUD.ini. INIFileParser.dll is also no longer required.
IMPORTANT: Delete the old WeaponHUD files before installing v2.0, then drop the new WeaponHUD.dll, WeaponHUD.ini, and WeaponHUD folder into your scripts folder. Latest Script Hook V + Script Hook V .NET Nightly recommended.