Gmod Hunger Mod + Customizable HUD

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

---

---

Sommaire :

1. 📘 Présentation de Gmod Hunger Mod + Customizable HUD
2. 📦 Contenus
3. 🍗 Système d'Upgrade du niveau de faim max
4. 🎨 Les options d'éditions de la barre de faim dans l'HUD.
5. 🕹️ Les Commandes
6. 💾 Sauvegarde et persistance
7. 🍔 Modèles de nourriture spawnable dans Gmod Hunger Mod + Customizable HUD
8. 📚 Les API du Hunger System: fonctions associées à la Classe player pour les développeurs et la création d'objets
9. ✔️ Compatibilité

📘 Présentation de Gmod Hunger Mod + Customizable HUD

Gmod Hunger Mod + Customizable HUD n'est pas qu'un addon de customisation d'HUD. Il apporte à votre serveur la notion de faim. Vous me direz qu'il y a déjà un Food Mod dans le DarkRP mais tout le monde ne veut pas forcément avoir le DarkRP installé sur son serveur. J'ai conçu ce script pour qu'il puisse fonctionner sans aucun autre gamemode ni addon mais qu'il soit quand même compatible avec les Foodmod déjà existant.

Ainsi si vous souhaitez partir sur une base saine et un système qui ne spam pas le module SQL de GMod à chaque update de la variable (progression de la faim), Gmod Hunger Mod + Customizable HUD est conçu pour faire des sauvegardes de l'utilisateur au moment de sa déconnexion. Ce système de sauvegarde permettra à l'utilisateur de ne pas en permanence se déconnecter pour ne pas manger et recharger sa faim.

Concernant les modèles de nourritures :
Des exemples de nourritures y sont inclus si vous souhaitez ajouter plus de modèle de nourriture propre à l'univers de votre serveur.
Je créerais gratuitement des packages de nourriture compatibles sur le workshop de Gmod sur Steam.

Beaucoup de choix pour tout les gouts ou si soudainement vous changez d'avis sur la propriété de la faim, vous pouvez faire en sorte que la faim soit fatale ou juste contraignant pour l'utilisateur, par exemple en lui faisant perdre son endurance, ou ses points de vie mais sans le tuer.

Désactivez la faim en un simple bouton, par rang, job, ou totalement au besoin.

Concernant l'HUD, comme dans ma collection d'HUD éditable, la barre de faim est entièrement personnalisable, des icônes, au style, la forme et la position. Des styles feront toujours leurs apparition au fil des mises à jours gratuite.

📦 Contenus

Vous y trouverez :
1. Un système de sauvegarde SQL pour les utilisateurs et pour les sauvegardes.
2. Un Module de gestion du système de faim en fonction des rangs : superadmin, admin, moderateur, vip, user, etc
3. Une barre de faim Modulable dans l'HUD.
4. Un Module de gestion du système de faim en fonction des JOBS DARKRP: mayer, citizen, vip, etc.
5. Un Système de customisation de la barre de faim dans l'HUD.
6. Un grand nombre de styles d'HUD customisables.
7. Un entité d'upgrade de la faim max.
8. Des exemples de nourriture pour la création de vos propres entitées.
9. Des options de customisations de gameplay.
10. Des nourritures variées disponibles sur le workshop.
11. Mod HUD simple et allégé = Possibilité de ne pas afficher la barre de faim mais une icône de faim seulement lorsque la faim est là,
12. Et un support technique.

🍗 Système d'Upgrade du niveau de faim max

Avec Gmod Hunger Mod + Customizable HUD, vous pourrez décider si la faim max évolue avec le level du joueur, à la condition d'avoir un système de leveling d'installé sur votre serveur garry's mod, en voici un fait maison dans la boutique / Section Gmod addons
Il sera possible de choisir les possibilités d'upgrade de la faim max soit en trouvant un objet clé (rare dans le meilleur cas afin de le rendre précieux), soit en fonction du level de vos utilisateurs. La progression de vos utilisateurs est sauvegardée, points de faim pour éviter que vos joueurs se déconnectent et se reconnectent pour recharger leur faim.

🎨 Les options de customisation de la barre de faim dans l'HUD.

L'HUD du système de faim est fait pour que vous puissiez exprimer votre créativité, comme dans ma collection d'HUD éditable la barre de faim est entièrement personnalisable, des icônes au style jusqu'à la forme et la position. Sans passer par des mises à jours de fichier ni du workshop. N'oubliez juste pas de cliquer sur le bouton "sauvegarder" pour appliquer la modification que vous observerez en temps réel.

Liste de variables customisable dans l'HUD :
1. La position X Y
2. La Longueur et la Largeur
3. La couleur de fond de la barre
4. La couleur des barres de progression
5. La couleur du texte
6. La couleur de l’icône
7. La police d'écriture
8. Remplacez les icônes par défaut par les votres par simple lien d'image.
9. 19 Styles d'HUD, Cercle, barre horizontal, cœurs, Style Zelda, Style Minecraft, textuel, etc.
10. Modifications applicables sans rebooter votre serveur.

🕹️ Les Commandes

Pour accéder à l'interface la commande chat : !hunger
La commande console : norda_hud_hunger_system

💾 Sauvegarde et persistance

Comme la plupart des mes scripts de gestion de stats des joueurs, l'évolution du joueur est sauvegardée au moment de la déconnexion pour des raisons d'optimisation, c'est un choix qui vous appartient depuis le fichier configuration.

🍔 Modèles de nourriture spawnable dans Gmod Hunger Mod + Customizable HUD

L'addon inclus un spawn menu des nourritures spawnable, les nourritures déjà présentes, nommé food_exemple_1 et food_exemple_2 servent d'exemples permettant de fournir une base pour vous aider à créer les votre, vous pourrez par la suite les stocker dans des conteneurs ou chez un marchand.

Un objet appelé upgrade de la faim max, permettra d'augmenter la capacité max de la barre de faim. Un choix qui vous appartient de l'utiliser ou pas sur votre serveur.

📚 Les API du Hunger System: Les fonctions ajoutées à FindMetaTable("Player") pour le développement

1. Les fonctions Glua Coté Client et Serveur :
player:Hunger() = Permet de connaitre les points de faim de l'utilisateur.
player:GetMaxHunger() = Permet de retourner les points de faim max de l'utilisateur.

2. Les fonctions Glua Coté Serveur :

Les fonctions suivante permet :
player:addHunger(number) = Permet de donner ou retirer la faim. Par exemple. 10 = Ajout 10 de faim à la faim qu'il possède déjà. -10 Retire 10. Il ne pourra pas descendre en dessous de Zéro.
player:setHunger(number) = Permet de définir la faim du joueur.

Gestion de la faim max via des items des fonctions :
player:addMaxHunger(number) = Permet d'augmenter ou de diminuer la faim max. Si vous souhaitez créer des entités qui upgrade ou downgrade les points de faim max.
player:setMaxHunger(number) = Permet de définir les points de faim max du joueur. Par défaut la faim max est plafonné à 200. Cette limite est modifiable.

✔️ Compatibilité

Compatible avec le Gamemode DarkRP, StarwarsRP, HogwartsRP, PoudlardRP, CloneRP, MilitaryRP, AnimRP, MangaRP, ect... Continue de fonctionner même sans gamemode d'installé.

Installation : Téléchargez et décompressez le dossier norda_hud_hunger_mod.zip. Installez l'addon dans le fichier addons de votre serveur Gmod,

- Chemin : garrysmod/addons/ norda_hud_hunger_mod

- Gmod Workshop ID des ressources : 2717709425
- Vous pouvez ajouter ceci à un fichier Lua côté serveur : resource.AddWorkshop( 2717709425 )
- Pour ajouter les ressources du workshop de gmod à votre collection : Gmod Hunger Mod + Customizable HUD [Ressouces seulement] | Gmod Workshop

Conseil pour éviter les leaks de Gmod Hunger Mod + Customizable HUD installé sur votre serveur Garry's mod: Comment éviter la fuite de vos scripts Gmod
Comment Installer un addon Gmod: Comment installer un addon sur Gmod?
Publier un Addon Gmod sur le workshop: Documentation comment créer un pack de contenu à publier sur l'atelier?