Gmod Ammo System + HUDs

Description of Gmod Ammo System + HUDs
🇫🇷 🇬🇧

---

---

Summary:

1. 📦 What Gmod Ammo System + HUDs contains
2. 📘 Description of Gmod Ammo System + HUDs
3. ❓ What type of need can Gmod Ammunition System meet?
4. 🖌️ A HUD Maker to customize the display of ammunition and magazines of weapons in hand
5. 🧰 All variables included and modifiable from the management interface
6. 🧊 2D and 3D model system of your ammunition
7. 🕹️ Commands
8. 🇬 Modified Gmod API to make this possible

📦 What Gmod Ammo System + HUDs contains

1. A max limit management system by type of ammunition.
2. An existing ammunition detection system on a server displaying in red the ammunition not included in the limitation system.
3. An administration interface
4. An integrated spawn menu of your ammunition generated easily from the configuration file.
5. A system of replacement of 3D models by 2D models just with simple images in png format.
6. A system of editing the display of ammunition on the HUD for a personal and unique rendering.
7. A style system to upload your own ammo icons, size, hide the capacity of a magazine on the interface if you disable it.
8. A System of gameplay modules

📘 Description of Gmod Ammo System + HUDs

Gmod Ammo System + HUDs will finally allow you to limit the maximum capacity of ammunition by having the possibility to disable the ammunition HUD or to replace it by a fully customized HUD.
On the gameplay side, you will be able to define the maximum capacity of ammunition transport that could evolve with the user's level or not.
The maximum capacity to carry a type of ammunition, modifiable in real time.
Choose if a player loot his ammo inventory, or even choose the chance rate, for example set to 50% there will be one chance in two.
Finally, allow your players to drop their ammunition as roleplay, being able to drop everything on the ground is important. Even in terms of realism. Then if you apply a maximum limit it will be important to be able to drop your stock as well.

❓ What type of need can Gmod Ammunition System meet?

If you have all these questions in mind, this script brings its solution:

How to disable the HUD of Gmod ammo (HL2)?
How to make people have a max ammo limit per ammo type to avoid having 9999 ammo, for example to limit the inventory to 5 rockets?
How to change the HUD of the ammo on Garry's Mod?
How to create ammo?
How do I change the value of ammo?
How do I add a command for people to drop their ammo?
How do I make people who die boot their ammo on the ground?
How to disable adding ammo to GMod when a user picks up a weapon?
How to enable max ammo limit on GMod?
How to disable notification when a player picks up ammo?
How to limit the max ammo carrying capacity?

🖌️ A HUD Maker to customize the display of ammunition and magazines of weapons in hand

1. Move the ammunition HUD up and down and from left to right.
4. Edit the style of the ammunition HUD and magazines, displaying bullets, cartridges, or single point of light, in line, circle, arc, etc...
2. Choose the size and width of the HUD of the magazines of the equipped weapons.
3. Change the ammo icon on the HUD. Upload on an image host for example imgur, copy the link of the image ending with .png. And it's done, the sharing will be done without workshop steam.
4. Edit the colors, the bar, the background, the icon, the text.
5. Edit the size of the icon. Respect the size you have configured, for example if the image is 32px and you have set a size of 22px it will be pixelated.
7. Choose to display the max capacity or not of the magazines, for example instead of displaying a magazine of 18 bullets, 18 / 18 you will have 18.

🧰 All variables included and modifiable from the management interface

ammo_capacity_max = "Maximum ammunition carrying capacity" <numeric value>.
ammo_limitation = "Enable limitation of this type of ammunition" ON | OFF
weap_give_ammo = "Collects ammunition when picking up a weapon" ON | OFF
notification_ammo = "Notify when ammo is obtained" ON | OFF
ammo_drop_death = "Percentage chance of dropping ammo when player dies" <chance rate>%.
cmd_drop_ammo = "User can drop all his ammo with : drop_ammo" ON | OFF

ammo_max= "Max ammo storage capacity of a specific weapon type" <numeric value>

🧊 2D and 3D model system of your ammunition

Turn any 3D model into a useful ammunition entity. It may happen that you don't have your 3D ammunition models yet. With a simple image in png format create your ammunition entities from the configuration file. They will then be 2D models. Demonstration in video : https://youtu.be/IKO_BDwZmnk

🕹️ Commands

To open the management interface of Gmod Ammo System + HUDs:
You can use the chat command: !ammo
From the console: ammo

To drop the ammo on the ground on the chat: !drop_ammo
Or drop ammo by console command: drop_ammo

Or from my admin system access the shortcut buttons.

🇬 Modified Gmod API to make this possible

1. Lua functions: Server side modified to make this possible : Although modifying the following functions will not affect the proper functioning of this one with the other addons. Since the variables used are the same.

player:GiveAmmo( number amount, string type, boolean hidePopup = false ) = Allows you to give or remove ammunition from the player.
1. number amount // Quantity of ammunition
2. string type // Type of ammo. This can also be a number for the ammo ID, useful for custom ammo types.
3. boolean hidePopup = false // Hide the display window when assigning ammo.

player:SetAmmo( number ammoCount, any ammoType ) = Allows you to define the player's ammunition.
1. ammoCount // The amount of ammo to define.
2. any ammoType // The type of ammunition. This can be an ammo ID number or a string for the ammo name.

player:Give( string weaponClassName, boolean bNoAmmo = false ) = Allows to give a weapon to the player.
1. string weaponClassName // Name of the weapon class to give to the player
2. boolean bNoAmmo = false // Set to true to give no ammo when the weapon appears. (Reserve ammo is defined by DefaultClip).

Installation: Download and Unzip the folder norda_hud_ammo_system.zip Install the addon in the addons file of your Gmod server,

- Path : garrysmod/addons/ norda_hud_ammo_system

- Gmod Content Workshop ID : 2771081584
- You can add this to a server-side Lua file : resource.AddWorkshop( 2771081584 )
- To add the gmod workshop resources to your collection : Gmod Ammo System + HUDs [Content Only] | Gmod Workshop

Tip to avoid the leak of Gmod Ammo System + HUDs installed on your Garry's Mod server: How avoid the Leak of your Gmod scripts
How Install an addon on Gmod? : How install an addon on Gmod
How Publish an addon on the Gmod workshop? : Documentation how create a content pack to publish on the workshop?