Gmod Health Modules + HUD Editor - Script
Dare to be original with Gmod Health Modules + HUD Editor, it has the particularity to gather several functionalities to offer a unique server with options and modules that can be quickly activated. It not only allows you to define gameplay rules related to everything related to health and armor, but also to customize the HUD, colors, icons, size, length, font, 19 fully editable styles to achieve something unique! Upload your icons without having to go through Garry's Mod workshop with real time results. You will also be able to define whether to save the health and armor of users or only VIP members, and their progress.
❮
❯
Description of Gmod Health Modules + HUD Editor
Summary:- 📘 Presentation of Gmod Health Modules + HUD Editor
- 📦 Contents
- ❤️ Upgrade system of max health points and armor points
- 📐 Health and armor bar customization options in the HUD
- 🕹️ The Commands
- 💾 Saving and persistence
- ⚙️ A simple configuration file
- 🪄 Spawnable entities in Gmod Health Modules + HUD Editor
- 📚 The functions associated with the Player Class for developers
- ❓ Regular questions
- ✔️ Compatibility
- 💰 Ability to have health or armor points purchased in game
- ⬇️ Dropping health or armor points in-game through spawnable entities when an Npc dies
- 🛠️ Gmod Admin system compatible
📘 Presentation
Dare to be original with Gmod Health Management + HUD Editor!
On GMod, as soon as a HUD is released, there is a trend effect and everyone ends up offering the same one. The majority of the servers do not offer a unique content nor an identity of their own when everyone ends up with the same thing, this is what I tried to break with this script. We agree, the goal is not to imitate the others but rather to create and bring its personal touch to its server, this difference is often what makes the little extra thing on a server.
How about adopting your own style?
Here, I wanted to make sure that you have the opportunity to be creative and do what you want, when you want and how you want and then change your mind and start over! Then it will always be possible to modify your HUD without having to buy another one that can't be modified the way you want or having an unknown coder rip you off (I've already heard too much about this kind of abuse on the Help Discord).
Modify freely! There you have 19 HUD styles that serve as a base that you can adjust as you like, this is a good base for a script that was originally not intended as a HUD customization system. In the HUD screenshot I only show a small glimpse of all that is possible. There is a whole range of choices, styles, sizes, colors, fonts, not to mention the multitude of icons you can create, all without uploading them via the workshop but just with an image link.
Originally, it is a system for managing and configuring everything that interferes with health and armor points.
📦 Contents
You will find:
1. A backup system for the players.
2. A database management system of stored health points and armor points of users.
3. A Module of management of the options by rank: superadmin, admin, moderator, vip, user, etc
4. A Module to manage options by DarkRP job.
5. A HUD customization system, which affects the health bar, and the armor bar.
6. 19 predefined and customizable HUD styles.
7. Spawnable healing entities and a max health upgrade entity.
8. Full documentation.
❤️ Upgrade system of max health and armor points
You will have the possibility to choose if the max limits evolve with the level of the player, provided you have a leveling system installed on your server garry's mod, if you are looking for one, you will find one from the house here : Gmod Leveling System
The maximums increase either by finding an item or by your level. Of course the progress of your users is saved (health and armor points and their maximum) and the user gets his stats back when he logs in again, a simple method to keep your users loyal and encourage them to come back to continue.
📐 Customization options for the health and armor bar in the HUD.
You will be able to customize the health and armor bar in all directions in a responsive way.
What is customizable in the HUD of Gmod Health Management + HUD Editor?
1. X Y position
2. Length and width
3. The background color of the bar
4. The color of the progress bars
5. The color of the text
6. The color of the icon
7. The font of the text
8. Replace default icons with your own by simple image link.
9. 19 HUD styles, circle, horizontal bar, hearts, Zelda style, Minecraft style, textual, etc.
10. Changes applicable without rebooting your server.
🕹️ Commands
To access the interface the chat command : !life
The console command : norda_hud_health_management
💾 Backup and persistence
Save stats related to health and armor included. Give your users a sequel to their next session by progressing with the stats they had when they logged out.
⚙️ A simple configuration file
Most of the configuration is done from an interface, which makes the configuration file very minimal.
You will be able to configure it:
cfg.FX_to_Open = "F1" -- 0 = Disabled, defines whether the menu can be opened with the F1 F2 F3 F4 key.
cfg.Delay_HP_Regen = 20 -- If the HP Regen module is enabled, every 20 seconds the user receives HPs.
cfg.Hide_Empty_Armor_Bar = 0 -- 1= Hide the armor bar when it is empty. 0 = OFF
cfg.Custom_Fonts = "Trebuchet24" -- Custom HUD Fonts
cfg.MaxHealth_Mod = 0 -- 0 = User must buy or find the item that increases his max health, 1 = Max health goes up with user's level.
cfg.MaxArmor_define_per_lvl = 0 -- 0 = User must buy or find the item that increases his max armor, 1 = Max armor increases with user's level, 2 = Max armor is equal to max health.
cfg.Health_start = 100 -- This is the starting health of the user who starts on your server.
cfg.Armor_start = 100 -- This is the starting armor of the user.
cfg.MaxHealth_gain_per_levelup = 10 -- The additional max health per level up.
cfg.MaxHealth_max = 1000 -- Set the max health limit on your server. A player will not be able to have more.
cfg.MaxArmor_gain_per_level = 10 -- The extra max armor per level up.
cfg.MaxArmor_max = 1000 -- Set the max armor limit on your server.🪄 Spawnable entities in Gmod Health Modules + HUD Editor
The addon includes spawnable entities that can be used as examples or tools to enrich the content of your server, e.g. by placing them as loot or merchantable items at a merchant. Spawnable entities can be disabled in the configuration file with the variable, cfg.Enable_Items_Spawnable.
The different spawnable entities are :
Health points which have the effect of recharging the health points of the user who picks them up by pressing USE on him.
The armor points which have the effect of reloading the armor points of the user who picks them up by pressing USE on this one.
Max health points upgrades which have the effect of upgrading the user's max health points limit when he picks them up. This max limit is saved and the user keeps his progress even when he disconnects.
The spawnable entities are automatically deleted after 30 seconds by default, this time can be defined in the configuration file.
📚 The functions associated with the Player Class for developers
1. The Glua functions on the Client and Server side:
player:GetMaxHealth() = Allows to know the user's max health points.
player:GetMaxArmor() = Allows to know the user's max armor points.
2. Glua functions on the server side :
2.1. Health point management if you want to create entities that give back health points:
player:addHealth(number) = Allows to give or remove health points.
player:setHealth(number) = Allows to set the player's health points.
2.2. Manage max health point upgrade via items if you want to create entities that upgrade or downgrade max health points:
player:addMaxHealth(number) = Allows to give or remove max health points.
player:setMaxHealth(number) = Allows to set the maximum health points of the player.
2.3. Armor point management if you want to create entities that give back armor points:
player:addArmor(number) = Allows to give or remove armor points, it can't go below zero nor be higher than the max armor.
player:setArmor(number) = Allows to set the player's armor points.
2.4. Management of the upgrade or downgrade of the maximum armor points via items:
player:addMaxArmor(number) = Allows to give or remove max armor points.
player:setMaxArmor(number) = Allows to set the player's max armor points.
❓ Regular Questions
How to enable anti Prop Kill on Gmod? In the Settings / Mod / anti_prop_kill menu: OFF | ON.
How to disable damage between members of the same team? In the Settings / Mod / team_damage : OFF | ON.
How to disable damage between members of the same job on a DarkRP? In the Settings / Mod / job_damage : OFF | ON.
How to disable the possibility for players to kill themselves with kill or explode? In the Settings / Mod / can_suicide : OFF | ON.
How to disable fall damage when falling from a height? In the Settings / Mod / fall_damage: OFF | ON.
How to have more realistic fall damage when falling from a height? In the Settings / Mod / realistic_fall_damage: OFF | ON.
How to activate the HP regeneration? In the Settings / Mod / regen_hp : OFF | ON.
How to customize the HUD on GMod? Gmod Health Modules + HUD Editor answers this question perfectly with its simple and intuitive customization module. You don't need a programmer or skills in Lua or GLua programming to create the HUD you want to have on your Gmod server.
How to make a Starswars HUD for Gmod? A new style lazer Starward was added in version 1.9 (May 2022) it will be enough to select it among the 21 styles now available in this addon gmod.
✔️ Compatibility
Compatible with DarkRP, StarwarsRP, HogwartsRP, HogwartsRP, CloneRP, MilitaryRP, AnimRP, MangaRP, ect...
For those who want to optimize their Gmod Server and don't want to run on DarkRP the system will continue to work without DarkRP or any other gamemode. Backup totally independent from any system.
💰 Possibility to buy health or armor points in game
Place spawnable entities in a store Gmod Store Builder where the dealer will be able to offer his care or upgrade services.
⬇️ Dropping health or armor points in game thanks to spawnable entities when an NPC dies
If you want health or armor points to spawn when a NPC dies then NPC Death Loot Manager is made for you, insert the spawnable entities in the inventory of a npc class, set the chance rate and it's done.
🛠️ Compatible administration system
If you want a system that is easy to administer and that holds up over the long term and is not too heavy in weight, Garry's Mod Admin Mod will allow to access the menu of "Gmod Health Modules + HUD Editor" via a shortcut button.
Path: garrysmod/addons/norda_hud_health_modules
- The AddWorkshop function is automatically added to the script server file and can be deactivated from the configuration file. : resource.AddWorkshop( 2714545696 )
- To add gmod workshop resources to your collection : Gmod Health Modules + HUD Editor [Content Only] | Gmod Workshop
The console command : norda_hud_health_management
Or via the shortcuts of my administration system if you don't want to have fun remembering all the commands in my scripts.
Go to the line: anti_prop_kill
You can then activate and deactivate the Anti Prop Kill.
Go to the line : no_damage
You can then activate and deactivate the mod: No Damage.
Go to the line : can_suicide
You can then activate and deactivate the suicide of players to prevent them from choosing their spawn.
Go to the line: pvp_damage
You can then activate and deactivate the damage between players.
Go to the line: team_damage
You can then choose whether or not players from the same team can damage each other.
Go to the line : job_damage
You will be able to choose whether or not players in the same DarkRP job will be able to damage each other.
Go to the line : falldamage
You will be able to activate and deactivate the mod : Fall damage.
Go to the line : realisticfalldamage
You can then activate and deactivate the mod : Deadly Falling Damage.
Go to the line : save_life and or save_armor
You can then activate and deactivate the saving of players.
Go to the line : regen_hp
You can then activate and deactivate the regeneration of health points.
Go to the line : damage_notification
You can then activate and deactivate the notification of damage received.
Go to the line: spawn_with_armor
You will then be able to activate and deactivate if the players spawn with the armor reloaded.
You can change the X position, the Y position, the length and width of the health and armor bar.
The background color of the HUD, the color of the health and armor bar.
The color of the texts and icons.
Upload new icons.
You will find in Gmod Health Modules + HUD Editor :
A Half Life 2 HUD (the default one on Gmod if you just want to have the modules and not touch the HUD)
A Circular HUD
A Triangular HUD
A Minecraft style HUD
A Zelda Style HUD without armor
Zelda Style HUD with armor
A HUD with just text
A completely empty HUD. (If you don't want to display a HUD)
A HUD with horizontal bars and customizable icons on the left
A HUD with horizontal bars and customizable icons on the right
A HUD with vertical bars and customizable icons on the right
HUD with bars as above but without icons and text.
A Textual HUD with rounded background and icons.
Some examples in pictures:
Be careful if you have indicated in the configuration file a maximum that can not be exceeded at 1000 for example. So if you put 9999 the number will be 1000.
cfg.Delay_HP_Regen=20 -- If the HP Regen module is enabled, every 20 seconds the user receives HP.
cfg.Hide_Empty_Armor_Bar=0 -- 1 = Hide armor bar when empty. 0 = OFF
cfg.Custom_Fonts="Trebuchet24" -- Custom Fonts, Trebuchet24 is the default.
cfg.Armor_start = 100 // This is the user's starting armor.
cfg.MaxHealth_max = 1000 // Sets the maximum health limit on your server. A player will not be able to have more.
cfg.MaxArmor_max = 1000 // Set the maximum armor limit on your server.
cfg.MaxHealth_gain_per_levelup = 10 // The maximum amount of extra max health points increased per levelup.
cfg.MaxArmor_gain_per_level = 10 // The maximum additional armor points increased per levelup.
cfg.MaxArmor_define_per_lvl = 0 // 0 = User must buy or find the item that increases his max armor, 1 = Max ARMOR increases with user's level, 2 = Max armor is equal to max health.
----- DÉSACTIVER LE HUD DE GMOD / HL2 / DARKRP -----
cfg.HideElement = {
["CHudHealth"] = false,
["CHudBattery"] = false,
-- ["CHudAmmo"] = false, -- RESERVÉ POUR UN AUTRE SCRIPT
-- ["CHudSecondaryAmmo"] = false, -- RÉSERVÉ POUR UN AUTRE SCRIPT
-- ["DarkRP_HUD"] = false, -- IL VAUT MIEUX L'INACTIVER DEPUIS LE FICHIER DE CONFIGURATION DE VOTRE DARKRP
-- ["DarkRP_EntityDisplay"] = false,
-- ["DarkRP_LocalPlayerHUD"] = false,
-- ["DarkRP_Hungermod"] = false,
-- ["DarkRP_Agenda"] = false,
-- ["DarkRP_LockdownHUD"] = false,
-- ["DarkRP_ArrestedHUD"] = false,
-- ["DarkRP_ChatReceivers"] = false,
}cfg.MaxHealth_Mod = 0 -- 0 = User must buy or find the item that increases his maximum life, 1 = Maximum HP increases with user's level.
cfg.MaxArmor_define_per_lvl = 0 -- 0 = User must buy or find the item that increases his maximum armor, 1 = Maximum armor increase with user's level.
So to activate them:
The variable cfg.MaxHealth_Mod must be set to 1 for Max HP.
And the variable cfg.MaxArmor_define_per_lvl must be set to 1 for Max Armor.
It is possible to choose how much the maximum increases per level to do this, by default the armor increases by 10.
cfg.MaxHealth_gain_per_levelup = 10 -- The maximum additional HP per level up.
cfg.MaxArmor_gain_per_level = 10 -- The maximum additional armor per level up.
The calculation for the MAX HP increase works like this: User will have at level 50. +500 Max HP (Level * cfg.MaxHealth_gain_per_levelup)
The calculation for the MAX armor increase works like this: User will have at level 50. +500 ARMOR Max (Level * cfg.MaxArmor_gain_per_level)
You can work around my system by setting the MaxHealth_Mod variable to -1 instead of 1.
cfg.MaxHealth_Mod = -1
cfg.MaxArmor_define_per_lvl = -1
I managed to reproduce something similar by setting a starting life point with an undefined maximum or lower from the jobrelated.lua.
