Gmod Stamina System + Editable HUD

Description de Gmod Stamina System + Editable HUD
🇫🇷 🇬🇧

---

---

Sommaire :

1. 📘 Présentation de Gmod Stamina System + Customisable HUD
2. 📦 Contenus
3. 💪 Système d'Upgrade de la Stamina max
4. 📐 Les options d'édition de la barre de stamina dans l'HUD.
5. 🕹️ Les Commandes
6. 💾 Sauvegarde et persistance
7. ⚙️ Fichier configuration
8. 🪄 Exemples d'entités Spawnable dans Gmod Stamina System + Customisable HUD
9. 📚 Les fonctions associées à la Classe player pour les développeurs et la création d'objets
10. 🍗 Système anti b-hopping pour GMod
11. ✔️ Compatibilité

📘 Présentation

Enrichissez votre gamemode sur votre serveur Garry's mod avec Gmod Stamina System + Customisable HUD en proposant un système de stamina modulable.
Fonctionnant sans aucun Gamemode, ce système apporte tout un panel de nouvelles notions sur votre serveur et aux joueurs qui peuvent agir de façon stratégique, ou tout simplement apporter une touche de réalisme.

Comment ça se passe pour le joueur?
Le joueur va courir et son endurance va diminuer et finir par tomber à zéro et il ne pourra plus continuer son sprint. Cela va se traduire par sa barre d'endurance qui va lentement se colorer en rouge jusqu'à se remplir complètement, ce qui indique que l'utilisateur a atteint le seuil minimum zéro et a déclenché l’état d’essoufflement. L'état d'essoufflement empêchera l'utilisateur de re sprinter de façon irrationnelle en jonglant avec le peu de stamina en rechargement, ce qui ne serait pas réaliste. Dans la configuration, vous pourrez choisir à quel niveau de récupération l'essoufflement se termine. Par exemple lorsque le joueur aura retrouvé 20% de son endurance. Alors la barre d'endurance retrouvera sa couleur d'origine.

Sous l'eau la barre de Stamina devient une barre d'oxygène. La stamina restante sera la quantité d'oxygène disponible. Une fois l'oxygène à zéro vous pourrez définir si il perd des points de vie ou si il perd la vie directement.

Coté objets, vous aurez la possibilité de créer des objets de recharge de stamina ou d'upgrade et de définir si la stamina max augmente avec le level de l'utilisateur.

Coté customisation? Voyez la vidéo plus haut ou les screenshots. Vous avez la possibilité de tout moduler, des règles de gameplay liées à l'endurance jusqu'à l'HUD.

📦 Contenus

Vous y trouverez :
1. Un système de database pour les utilisateurs.
2. Un Module de gestion du système de stamina en fonction des rangs : superadmin, admin, moderateur, vip, user, etc
3. Une barre de Stamina Modulable dans l'HUD.
4. Une barre d'oxygène qui prend le relai lorsque l'utilisateur se trouve sous l'eau. La stamina devient alors l'oxygène.
5. Un Module de gestion du système de stamina en fonction des JOBS DARKRP: mayer, citizen, vip, etc.
6. Un Système de customisation de la barre de Stamina dans l'HUD (Voir plus bas ou screenshots).
7. Un grand nombre de style d'HUD customisables (même des carottes en guise de barre d'endurance).
8. Des Entités de régénération de Stamina Spawnable et une entité d'upgrade de la Stamina max.
9. Des options de customisation de gameplay liées à l'endurance
10. Une documentation complète.

💪 Système d'Upgrade de la Stamina max

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

📐 Les options de customisation de la barre de stamina dans l'HUD.

Vous aurez la possibilité de customiser la barre de stamina dans tout les sens le tout de façon responsive.
Qu'est ce qui est customisable dans l'HUD de Gmod Health Management + HUD Editor?
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 votre 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 : !stamina
La commande console : norda_hud_stamina_system

💾 Sauvegarde et persistance

Le Système de sauvegarde des stats lié à la Stamina est inclus. Offrez à vos utilisateurs une suite à leurs prochaines sessions en progressant avec les stats qu'ils avaient à leur déconnexion, cela évite aussi les abus de rechargement de stats avec une simple déconnexion.

⚙️ Un fichier de configuration simpleLa majorité de la configuration se fait depuis une interface, ce qui rend le fichier configuration très minime.

Vous pourrez y configurer:

cfg.FX_to_Open = "F3" -- 0 = Désactivé, Définit si le menu peut être ouvert avec la touche F1 F2 F3 F4.

cfg.Delay_Stamina_Loop = 2 -- Toute les 2 secondes pendant un Sprint la Stamina s'use, à l’arrêt la stamina se régénère.

cfg.Custom_Fonts = "Trebuchet24" -- Custom Fonts de l'HUD

cfg.MaxStamina_define_per_lvl = 0 -- 0 = L'utilisateur doit acheter ou trouver l'item qui augmente sa Stamina max, 1 = La Stamina max monte avec le niveau de l'utilisateur.

cfg.Stamina_start = 100 -- Il s'agit de la Stamina de départ de l'utilisateur qui débute sur votre serveur.

cfg.MaxStamina_gain_per_levelup = 10 -- La Stamina max supplémentaire par level up, ici l'utilisateur gagne 10 points de Stamina max par level.

cfg.MaxStamina_max = 1000 -- Définissez la limite max de la Stamina sur votre serveur. Un joueur ne pourra pas avoir plus, même s'il ramasse des objets d'upgrade.

cfg.Stamina_Sprint_Use=20 -- La quantité de stamina utilisé pendant un script, la variable : cfg.Delay_Stamina_Loop plus haut permet de configurer le délai.

🪄 Exemples d'entités Spawnable dans Gmod Stamina System + Customisable HUD

L'addon inclus des entités spawnable qui peuvent servir en guise d'exemples ou d'outils permettant d'enrichir le contenu de votre serveur, par exemple en les plaçant en tant que loot ou objet marchandisable chez un marchand. Les entités spawnable peuvent être désactivées dans le fichier configuration avec la variable, cfg.Enable_Items_Spawnable.

Les différentes entités spawnable sont :
Les recharges de la Stamina qui ont pour effet de restaurer la Stamina de l'utilisateur qui les ramasse en pressant USE sur celui ci.
L'Upgrade de la Stamina max qui a pour effet d'upgrader la limite max des points de la Stamina de l'utilisateur lorsqu'il les ramasse. Cette limite max est sauvegardée et l'utilisateur conserve l'usure et ses statistiques lorsqu'il se déconnecte.
Les entités spawnable se suppriment par défaut au bout de 30 secondes, ce temps peut être défini dans le fichier configuration.

📚 Les fonctions associées à la Classe player pour les développeurs

1. Les fonctions Glua Coté Client et Serveur :
player:Stamina() = Permet de connaitre les points de Stamina de l'utilisateur si vous en avez besoin par exemple pour limiter les attaques de mêlée lorsque par exemple le joueur est essoufflé.
player:GetMaxStamina() = Permet de connaitre les points de Stamina max de l'utilisateur.

2. Les fonctions Glua Coté Serveur :

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

Gestion de la Stamina max via des items des fonctions :
player:addMaxStamina(number) = Permet d'augmenter ou de diminuer la Stamina max. Si vous souhaitez créer des entités qui upgrade ou downgrade les points de stamina max.
player:setMaxStamina(number) = Permet de définir les points de Stamina max du joueur.

🍗 Système anti b-hopping pour GMod

Sans vraiment le vouloir le système apporte un système anti b-hopping puisque vous pouvez activer une usure de la stamina lorsqu'il saute et limiter le saut lorsqu'il n'a plus de stamina. Fini aussi les joueurs qui sautent partout pour rien! Parfait pour un cadre Roleplay et sérieux.

✔️ 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_stamina_system.zip. Installez l'addon dans le fichier addons de votre serveur Gmod,

- Chemin : garrysmod/addons/ norda_hud_stamina_system

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

Conseil pour éviter les leaks de Gmod Stamina System + Editable 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?