Gmod Hunger Mod + Customizable HUD

Description of Gmod Hunger Mod + Customizable HUD
🇫🇷 🇬🇧

---

---

Summary:

1. 📘 Gmod Hunger Mod + Customizable HUD presentation
2. 📦 Contents
3. 🍗 Max Hunger Level Upgrade System
4. 🎨 Hunger bar editing options in the HUD
5. 🕹️ Commands
6. 💾 Backup and persistence
7. 🍔 Spawnable food models in Gmod Hunger Mod + Customizable HUD
8. 📚 The API of the Hunger System: The functions associated with the Player Class for developers and object creation
9. ✔️ Compatibility

📘 Gmod Hunger Mod + Customizable HUD presentation

Gmod Hunger Mod + Customizable HUD is not only a HUD customization addon. It brings to your server the notion of hunger, you will tell me that there is already a Food Mod in the DarkRP but not everyone wants to have the DarkRP installed on his server, I designed this script so that it can work without any other gamemode or addon but it is still compatible with the existing Foodmod.

So if you want to start on a sound basis and a system that does not spam the SQL module of GMod at each update of the variable (progress of hunger), Gmod Hunger Mod + Customizable HUD is designed to make backups of the user at the time of his disconnection. This backup system will allow the user not to constantly disconnect to not eat and recharge his hunger.

About the food models:
Sample foods are included if you want to add more food templates specific to your server world.
I will create free compatible food packages on the Gmod workshop on Steam.

Lots of choices for all tastes or if you suddenly change your mind about the hunger property, you can make the hunger fatal or just binding for the user, for example by making them lose stamina, or health points but not kill them.

Disable hunger with a single button, by rank, job, or totally if needed.

Regarding the HUD, as in my editable HUD collection the hunger bar is fully customizable, from icons, to style, shape and position. Styles will always be added in the course of free updates.

📦 Contents

1. A SQL backup system for users and for backups.
2. A module for managing the hunger system according to the ranks: superadmin, admin, moderator, vip, user, etc.
3. An adjustable hunger bar in the HUD.
4. A module to manage the hunger system according to the DARKRP JOBS: mayer, citizen, vip, etc.
5. A customization system of the hunger bar in the HUD.
6. A large number of customizable HUD styles.
7. An entity of upgrade of the max hunger.
8. Examples of food for the creation of your own entity.
9. Gameplay customization options.
10. Various foods available on the workshop.
11. Simple and light HUD mod = Possibility to not display the hunger bar but a hunger icon only when the hunger is there,
12. And a technical support.

🍗 Max Hunger Level Upgrade System

With Gmod Hunger Mod + Customizable HUD, you will be able to decide if the max hunger evolve with the level of the player, provided you have a leveling system installed on your server garry's mod, if you find a homemade one in the store / Section Gmod addons
It will be possible to choose the upgrade possibilities of the max hunger either by finding a key item (preferably rare to make it valuable), or according to the level of your users. The progress of your users is saved, hunger points to avoid your players disconnecting and reconnecting to recharge their hunger.

🎨 Customization options for the hunger bar in the HUD.

The Hunger System HUD is made for you to express your creativity, as in my editable HUD collection the hunger bar is fully customizable, from icons, to style, shape and position. Without going through file updates or workshop. Just don't forget to click on the "save" button to apply the modification that you will observe in real time.

List of customizable variables in the HUD:
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 command chat : !hunger
The console command : norda_hud_hunger_system or hunger

💾 Backup and persistence

Like most of my player stats management scripts, the player's evolution is saved at the moment of the disconnection for optimization reasons, it's a choice that is yours from the configuration file.

🍔 Spawnable food models in Gmod Hunger Mod + Customizable HUD

The addon includes a spawn menu of spawnable foods, the foods already present, named food_example_1 and food_example_2 serve as an example to provide a basis to help you create your own, you can then store them in containers or a merchant.

An item called max hunger upgrade, will increase the max capacity of the hunger bar. It is up to you to decide whether or not to use it on your server.

📚 The API of the Hunger System: Functions added to FindMetaTable("Player") for development

1. The Glua functions on the Client and Server side:
player:Hunger() = Allows you to know the hunger points of the user.
player:GetMaxHunger() = Returns the user's max hunger points.

2. Server side Glua functions :

The following functions allow:
player:addHunger(number) = Allows to give or remove hunger. For example. 10 = Adds 10 hunger to the hunger it already has. -10 Removes 10. He can't go below Zero.
player:setHunger(number) = Set the player's hunger.

Manage max hunger via function items:
player:addMaxHunger(number) = Allows to increase or decrease the max hunger. If you want to create entities that upgrade or downgrade max hunger points.
player:setMaxHunger(number) = Allows you to set the max hunger points of the player. By default the max hunger is capped at 200. This limit can be changed.

✔️ Compatibility

Compatible avec tout les gamemodes et sans aucun gamemode si vous souhaitez builder un projet sur une base vide.

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

- Path : garrysmod/addons/ norda_hud_hunger_mod

- Gmod Content Workshop ID : 2717709425
- You can add this to a server-side Lua file : resource.AddWorkshop( 2717709425 )
- To add the gmod workshop resources to your collection : Gmod Hunger Mod + Customizable HUD [Content Only] | Gmod Workshop

Tip to avoid the leak of Gmod Hunger Mod + Customizable HUD 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?