Gmod Advanced Inventory System

Description de Gmod Advanced Inventory System
🇫🇷 🇬🇧

---

---

Sommaire:

1. 📘 Description de Gmod Advanced Inventory System
2. 📦 Contenues de l'addon Gmod Advanced Inventory System en bref
3. 💾 Les Sauvegardes concerné avec Gmod Advanced Inventory System
4. 🧰 Panneau de gestion et d'administration du système d'inventaire pour Gmod
5. 💽 Panneau de gestion des sauvegardes de l'inventaire des utilisateurs
6. 🎨 Panneau de customisation de style de l'inventaire
7. 👑 Système d'avantage pour les rôles et les rangs
8. 🎮 Modules de personnalisation du gameplay lié à l'addon d'inventaire
9. 🔊 Modules de personnalisation des différents effets sonore lors des interactions avec l'inventaire
10. 🔫 SWEP permettant le stockage et la manipulation d'objets
11. 🎒 Kits d'upgrades d'inventaire spawnable inclut
12. 👆 Système de Binds éditable permettant de placer des équipements en raccourcie
13. 📁 Système de rangement des items par catégories
14. ✔️ La Whitelist des objets
15. ❓ À quel type de besoin Gmod Advanced Inventory System peut-il répondre?
16. 🧩 Addons Gmod Compatible
17. 💡 Pourquoi ce script optimisera aussi la physique de votre serveur?
18. 🛠️ API pour le développement et implémentation

📘 Description de Gmod Advanced Inventory System

Un système d'inventaire pour tous les styles imaginables et tout vos projets, et futurs projets. Gmod Advanced Inventory System est un système d'inventaire customisable de très bonne qualité que vous pourrez fondre dans n'importe quel gamemode et même faire fonctionner sans aucun gamemode.

Vous aimez lorsque les gens se demandent si ils sont encore sur du gmod. Ce sera le cas.
En Simple test, est ce qu'en voyant les 6 premiers screenshots vos réactions étaient: "Ce n'est plus Gmod là" ou "C'est sur quel jeu?" ou "C'est vraiment Gmod?" ?

Si oui c'est l'exacte réaction qu'auront vos joueurs avec ce système d'inventaire, j'ai envie que les utilisateurs arrivent sur le serveur et ont l'impression d'être sur un jeu à part et pas uniquement sur une autre copy d'un DarkRP à succès, mon système fonctionne bien sans aucun gamemode c'est ce que j’appelle un script standalone, c'est à dire qu'il peuvent fonctionner seul sans aucun autre addon ni aucun gamemode.

Osez exploiter votre créativité, c'est le but de Garry's mod. Ne faite pas qu'installer un addon sans aucune liberté de customisation qui fera de votre serveur qu'une copy d'un autre.

Depuis la version 1.4 il vous est possible d'ajouter une histoire à vos objets, un texte de description par objet qui permet d'indiquer son usage sur votre serveur.

Depuis la version 1.5 vous pouvez utiliser des objets directement depuis l'inventaire comme par exemple, manger, boire, remplir la bouteille vide.

N'hésitez pas à lire la page wiki de ce script pour des informations plus approfondi.

Depuis la version 3.7, le script dispose de son propre système d'armes /drop.

📦 Contenues de l'addon Gmod Advanced Inventory System en bref

Contenues coté Administration technique:
1. Un panneau de gestion du style de l'inventaire sur votre serveur. Les modifications que vous faite implique l'inventaire général qu'auront les gens sur votre serveur. Vous n'avez pas besoin d'être un programmeur pour faire un bel inventaire.
2. Un panneau de gestion des sauvegardes de vos utilisateurs, vous pourrez alors supprimer, modifier, vider l'inventaire des utilisateurs, même ceux qui ne sont hors ligne.
3. Un Spawnmenu ou est inclut les kits d'upgrade spawnable.

Contenues que l'utilisateur verra et pourra interagir:
- Un jolie inventaire unique (voir les screens).
- Un Système de catégorie pour ranger proprement les objets par type.
- Un Swep appelé Hands qui veut dire "Mains", qui permet d'avoir une posture normal ou passive (amicale) aux yeux des autres joueurs lorsque vous la sélectionnez, et aussi de ramasser les entités/objets whitelisté avec le clic gauche et de les poser là où vous visez avec le clic droite. Pour ne pas vous dé-familiariser avec ce que vous connaissez déjà (Comme le Pocket System du DarkRP sans mais cette fois être obligé d'utiliser le DarkRP).
- Un système de raccourcie d'équipements bindable via les slots 1 à 6. Vos utilisateurs pour switcher entre les équipements qu'ils auront choisi eux même de placer dans ses slots d'équipements. Cette option est désactivable.
- Une page d'information de vos statistiques si vous avez les autres système d'installé (ce n'est pas une obligation de les avoir si vous n'en voulez pas, désactivez alors la page d'information dans le panneau de gestion). Ainsi il faudra ouvrir l'inventaire pour voir son état de santé au lieu d'utiliser l'HUD pour le minimaliser au maximum.

💾 Les Sauvegardes concerné avec Gmod Advanced Inventory System

Lorsque vos utilisateurs se déconnecterons le contenu de leur inventaire sera sauvegardé, également leurs armes équipés(désactivable) et aussi leurs munitions(désactivable).
Ils retrouveront tout à leur reconnexion et également la dernière arme possédé en main avant la déconnexion.

Vous aurez la possibilité de choisir les modes de sauvegarde entre :
Sauvegarder à la modification de l'inventaire ou/et à la déconnexion du joueur ou/et avec un timer qui lancera une sauvegarde tout les X temps défini. Je met "ou/et" car vous pouvez le choisir de les désactiver individuellement les uns des autres.

🧰 Panneau de gestion et d'administration du système d'inventaire pour Gmod

Le système est muni d'un seul panneau d'administration quoi vous permettra d'éditer les règles de gameplay, le design de l'inventaire et la database.

💽 Panneau de gestion des sauvegardes de l'inventaire des utilisateurs

Un système de gestion de base de donné vous permettra de gérer la database où est sauvegardé les données de l'inventaire de vos utilisateurs et la progression de leur limite max. Ainsi vous aurez la possibilité de soit, réinitialiser leurs données, la supprimer ou la modifier. Ou tout simplement obtenir une information.
Un système de recherche par steamid64 ou par nom permettra de retrouver facilement les data de l'utilisateur même hors ligne.

🎨 Panneau de customisation de style de l'inventaire

La puissance de ce système d'inventaire c'est la possibilité de l'éditer à un point qu'il le rendra unique unique aux yeux de vos joueurs et propre à votre serveur, c'est l'identité et l’âme de votre serveur alors soyez imaginatif. Vous aurez la possibilité de modifier toutes ses variables :

1. Réglage de la position et de la taille de l'inventaire: Customisez la Position et Taille des éléments, des cases de l'inventaire, de l'arrondissement des angles en glissant de simple DSlider, ect. Le tout est responsive.
2. Personnaliser les couleurs de l'inventaire: La couleur des différents éléments: (Voir la vidéo ou les Screenshots).
3. Style de l'inventaire / Style de l'inventaire:
inv_activated = Inventaire activé, vous pourrez à tout moment de désactiver l'ouverture de l'inventaire en mettant le module sur OFF ce qui permet d'accès aux spawnmenu ou menu contextuel que l'inventaire obfusque car vous avez la possibilité d'utiliser une de ses touches qui sert d'accès à l'inventaire. Bref le cas utile est que vous buildez votre map pour préparer le gameplay et n'avez pas besoin de l'inventaire mettez le sur OFF sans le désinstaller.
inv_character = Afficher le personnage. Ce choix permet d'afficher le personnage au centre de l'inventaire.
inv_equipments = Permet d'activer et de désactiver l'espace équipements et aussi de désactiver les raccourcies bindé.
inv_stats = Permet de désactiver la fenêtre d'information sur les stats et l'état du personnage.
inv_blur = Active le flou artistique dans le fond de l'inventaire.
inv_icon = Remplace les textes par des icônes intuitive.
inv_lock_s = Affiche les slots vérouillé d'un cadenas pour indiquer aux joueurs qu'il a la possibilité d'avoir plus d'espace sur votre serveur. Et qu'il en est pas au maximum.
inv_percent = Afficher les valeurs des statistiques en Pourcentage.(Vie, Armure, Faim, Soif, Stamina, Magie, Points d'expérience avant le prochain level, ect)
inv_bottom = Afficher la barre du bas indiquant votre position GPS XY, le nombre de joueur en ligne, et l'heure réel.
inv_rarity_clr = Afficher la couleur de la catégorie d'objets dans votre inventaire.
inv_wep_img = Afficher le model 3D des équipements ou l’icône du spawn menu de l'arme dans le menu des raccourcies.

👑 Système d'avantage pour les rôles et les rangs

Vous pourrez Désactiver / Activer l'inventaire pour certains jobs ou rangs. Mais aussi imposer une limitation de l'inventaire qu'un rang/Job ne pourra pas dépasser. Par exemple un VIP pourra atteindre 128 max tandis qu'un Guest sera plafonné à 64 slots, il sera notifié que son rang ou job ne peut pas upgrader plus haut que cette limite. C'est un choix qui sera le votre.

🎮 Modules de personnalisation du gameplay lié à l'addon d'inventaire

Depuis le panneau de gestion dans la section module avec de simple bouton vous pourrez dicter le comportement du système d'inventaire sur votre serveur Gmod en modifiant ses variables :

Screenshot : editable-gameplay-rules - Gmod Advanced Inventory System

pure_backup = Sauvegarde instantané et automatique à chaque changement dans l'inventaire. (ON / OFF)
save_inventory = Sauvegarder l'inventaire à la déconnexion. (ON / OFF)
periodic_backup = Sauvegarde de l'inventaire tout les autant de temps, en seconde. (Valeur en seconde. 0 = OFF)
notification_stock = Notifier lorsqu'un objet est stocké dans l'inventaire. (ON / OFF)
inventory_loot = Nombre d'objets droppé à la mort du joueur. (Valeur numérique indiquant la quantité.)
chance_loot = Chance de dropper un objets à la mort. (Valeur en pourcentage. 0 = OFF)
inv_afterdeath = Le contenu de l'inventaire est vidé quand on meurt. (ON / OFF)
inv_maxreset = La limite max de l'inventaire revient au minimum quand on meurt. (ON / OFF)
begin_inv_slots = Inventaire max au départ lorsqu'un nouveau joueur commence une partie. (Valeur numérique)
inv_strip_wep = Supprimer les armes donné au spawn qui ne font pas partie de la sauvegarde. (ON / OFF)
inv_strip_ammo = Supprimer les munitions donné au spawn qui ne font pas partie de la sauvegarde. (ON / OFF)
inv_give_hand = Donner l'équipement 'Hands (Inventory)' automatiquement aux joueurs lorsqu'ils spawn. (ON / OFF)

🔊 Modules de personnalisation des différents effets sonore lors des interactions avec l'inventaire

Ainsi avec ce système donnez une impression encore plus unique en modifiant les effets sonores de l'inventaire sur votre serveur Garry's Mod, c'est à dire :
-Éditer l'effet sonore lorsqu'on ouvre l'inventaire.
-Éditer l'effet sonore lorsqu'on le ferme.
-Éditer l'effet sonore lorsqu'on insert un objet.
-Éditer l'effet sonore lorsqu'on retire un objet.
-Éditer l'effet sonore lorsqu'on clique sur un bouton.

🔫 SWEP permettant le stockage et la manipulation d'objets

Le système d'inventaire inclut un Swep qui permet de manipuler les objets qui sont dans la whiteliste d'items pour ne pas manipuler ce qui n'est pas prévue de bouger, prendre dans l'inventaire avec clic gauche et de déposer les derniers objets ramassé avec le clic droit. Cela va permettre de soit prendre un objet dans l'inventaire qui est le but premier mais aussi de déplacer des objets sans les bouger physiquement, ce qui aura pour effet d'optimiser vos serveurs Gmod. Ainsi permettez à vos utilisateurs de faire des manipulation sans physigun vous éviterons des potentiels crash et aussi consommera moins de ressources en CPU et en bande passante.

Pour faire le test tapez dans votre console : net_graph 3 qui permet de voir sur un graphe ce que vous utilisez comme ressources, prenez un objet au physigun et déplacez le, vous observerez la consommation de ressource en rouge qu'utilise ce seul objet lorsqu'il est en mouvement constant. Multipliez le par le nombre de joueurs connecté et multiplié le par le nombre de joueurs qui feront des manipulations de ce genre. Vous comprendrez que c'est lourd. On évitera cela avec ce swep.

🎒 Kits d'upgrades d'inventaire spawnable inclut

Avec les kits d'upgrade d'inventaire permettez à vos joueurs d'upgrader leur inventaire en les ramassant. Voir même par système de récompense. Il sera aussi possible de définir la limite max de l'inventaire en fonction du niveau de l'utilisateur.

L'Upgrade +1 permettra d'augmenter d'une case les slots max de l'inventaire du joueur lorsqu'il le ramassera. Vous pourrez les placer en récompense de NPC, en boutique ou en loot. Part exemple si l'inventaire du joueur est à 12 slots, +1 il passera à un inventaire de 13 slots.

Le kits d'Upgrade SetMax permettent quand à eux d'upgrader à la valeur indique par exemple le kit 64 slots upgradera l'inventaire de l'utilisateur à 64 slots.

Les joueurs ne pourront pas dépasser la limite du serveur indiqué dans le fichier configuration, par défaut réglé à 128.

👆 Système de Binds éditable permettant de placer des équipements en raccourcie

Permettez à vos utilisateurs de configurer leur propre raccourcie en associant leurs équipements aux touches bindable 1 à 6 depuis leur inventaire à partir des équipements qu'ils ont déjà.

Par exemple placer le physgun sur le slot 1 aura pour effet de sortir rapidement le physgun de gmod lorsque le joueur appuiera sur cette touche ("Bind slot_1") ainsi de suite avec les autres binds qui vont jusqu'à la touche 6.

📁 Système de rangement des items par catégories

L'inventaire par défaut est doté de plusieurs catégories: "All" "Ammunition" "Foods" "Medicals" "Materials" "Tools" "Weapons" "Misc"

Les objets se rangeront dans l'une de ses catégories qui leur correspond, elle se défini depuis la variable whitelist des items.

Vous pourrez modifier les catégories dans le fichier configuration à la variable Inventory_Categories si dans votre jeu vous n'avez pas besoin de l'une d'elle.

cfg.Inventory_Categories={"All", "Ammunition", "Foods", "Medicals", "Materials", "Tools", "Weapons", "Misc"}

✔️ La Whitelist des objets

La whitelist des objets va vous permettre de définir les règles des entités que les joueurs peuvent insérer dans leur inventaire pour éviter qu'il ne puisse stocker tout et n'importe quoi. Elle défini la liste des objets autorisé.
Il suffira d'utiliser le nom de class en index, de lui définir sa catégorie, sa couleur de type

Exemple:

cfg.Items_Whitelist={
plant_basil={
Categorie="Foods",
Color_fx=Color(0,255,0),
Stacking_limit=20
},
tool_hammer={
Categorie="Tools",
Color_fx=Color(150,150,150),
Stacking_limit=1
},
}

Dans l'exemple plant_basil est une entité qui est une plante, elle est rangé dans la catégorie Foods de l'inventaire et StackMax défini à 20 signifie que vous pourrez stocker 20 plant_basil par case de l'inventaire et la couleur de l'effet est Color(0,255,0) qui est le code pour du vert.

le deuxième objet est le marteau : tool_hammer qui cette fois sera rangé dans la catégorie "Tools", StackMax qui est à 1 signifie que 1 marteau prendra une case dans l'inventaire si vous en trouvez un deuxième il prendra une case de plus.

❓ À quel type de besoin Gmod Advanced Inventory System peut-il répondre?

1. Vous recherchez un système d'inventaire pour votre serveur gmod qui fonctionne même sans gamemode et hors DarkRP. Gmod Advanced Inventory System coche cette case.
2. Vous aimerez sauvegarder les armes et les munitions de vos joueurs sur votre serveur Gmod afin qu'ils les retrouvent à leur reconnexion.
3. Vous recherchez une alternative récente au Pocket du DarkRP ou à ItemStore. C'est le cas et pas besoin d'avoir le DarkRP pour le faire fonctionner.
4. Vous recherchez un système de sauvegarde des armes et des munitions.

🧩 Addons Gmod Compatible

Ce système a pour but de remplacer ItemStore que vous pouvez trouver sur Gmodstore qui n'est pas compatible avec la plus part de mes scripts. Ainsi je peux fournir le support lié aux problèmes signalé que vous rencontrerez avec mes addons gmod ou mon Workshop Gmod.

Parmi mes addons un plus sera apporté en plus de la compatibilité en terme d'information affiché sur l'inventaire à votre libre choix de l'afficher ou pas.

Gmod Character System va vous permettre de créer et enregistrer l'inventaire de tout vos personnages séparément.

Leveling System, Health & Armor System, Stamina System, Hunger System, Thirst System, Mana System, Money System : Afficheront les stats dans l'inventaire si vous décidez de purifié et alléger l'HUD de toutes ses informations. Chacune de ses variables sont désactivable depuis le fichier configuration. Le panneau information est désactivable depuis le menu de customisation de l'inventaire, car rien ne vous oblige de tout posséder.

Advanced View Creator: Si vous êtes en mode de vue à la troisième personne la camera fera une rotation de votre personnage pour afficher l'inventaire au lieu de l'afficher en double sur l'interface de l'inventaire. Moderne, Propre et esthétique.

💡 Pourquoi ce script optimisera aussi la physique de votre serveur?

Ce script modifiera le comportement que les joueurs auront avec les objets. Pour commencer si vous avez l'intention de retirer le physigun des mains de vos joueurs pour préserver votre serveur Gmod, le swep "hands" inclut dans cet addon permettra à vos utilisateurs de prendre des objets dans son inventaire et de le poser là où il regardera. Ce qui signifie qu'il n'y a pas de mouvement physique de l'objet.

Pour plus de précision sur cet outil sautez à la section 10. 🔫 SWEP permettant le stockage et la manipulation d'objets

🛠️ API pour le développement et implémentation

API coté serveur :

player:addMaxInventory( number quantity , bolean save) = Permet d'upgrade l'inventaire de l'utilisateur.
player:setMaxInventory( number quantity , bolean save) = Permet de Set l'inventaire max de l'utilisateur.

player:storeItem( class , quantité or clip1 , model path , clip2 or nil) = Permet de stocker une entité qui n'existe pas sur la map par son nom de class
player:addItem( entity , number quantity ) = Permet de stocker une entité existe sur la map et la supprime lorsqu'elle est stocké

API Coté serveur et Client:

player:Inventory_Slot() = Permet de connaitre le nombre de slot de l'inventaire occupé.
player:GetItems() = Retourne la table stocké dans l'inventaire de l'utilisateur.
player:GetMaxInventory() = Permet de connaitre la capacité max de l'inventaire du joueur.

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

- Chemin : garrysmod/addons/ norda_inventory_system

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

Conseil pour éviter les leaks de Gmod Advanced Inventory System 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?