Gmod addon: Items Trading and Selling System

Description de Gmod Items Trading and Selling System

---

"Items Trading and Selling System est un addon Gmod qui va permettre à vos joueurs d'échanger et de vendre des objets entre eux sur votre serveur de façon sécurisé et optimal. Ils n'auront plus à jeter les objets au sol. Coté sécurité, un petit bouton Lock permettra d’empêcher l'autre partie de modifier le prix, ou de retirer les objets au derniers moment. Lorsque les deux ont Lock l'échange ils pourront alors valider l'échange. Ainsi pas de scamming possible. C'est propre.
Les joueurs voient en temps réel ce que l'autre à placé dans sa fenetre même chose pour le prix. L'esthétique est customisable depuis le fichier de configuration de l'addon."

---

Sommaire :

1. Description de l'addon Gmod Items Trading and Selling System
   
2. Les requêtes de Trade
   
3. Les méthodes pour lancer une demande d'échange à un utilisateur
   
4. Possibilité de Vendre ou d'Acheter grâce à l'emplacement MONEY
   
5. Le bouton de verrouillage (Lock)
   
6. ️ Sécurité serverside
   
7. 🧩 Addons Gmod d'inventaire compatible
   
8. À quel type de besoin Gmod Items Trading and Selling System peut-il répondre?
   
9. API associé avec l'addon Gmod Items Trading and Selling System
   
10. 🧰 Les modifications possible via le fichier de configuration
    

Description de l'addon Gmod Items Trading and Selling System
Items Trading and Selling System est un addon Gmod conçu pour permettre à vos utilisateurs d'échanger ou de vendre les matériels depuis les divers mode de stockage. Gmod utilise déjà l'inventaire de HL2 pour les armes et les munitions, j'y inclus la possibilité de trader depuis mon système d'inventaire (compatibilité assuré donc) et mon système de pocket externe au DarkRP, fonctionne aussi avec la pocket du DarkRP. Vous l'aurez compris cet addon peut tourner sans gamemode comme la majorité de mes addons.


Les requêtes de trade
Lorsque vous envoyez une requête d'échange d'objet à un utilisateur, il sera notifié par une fenêtre qui s'ouvre sur son écran. Il aura le choix entre Accepter ou Refuser. Vous aurez aussi une fenêtre pour vous informer que votre demande est en attente, vous pouvez annuler quand vous voudrez. Si l'utilisateur refuse alors votre fenêtre se fermera automatiquement, s'il accepte la fenêtre d'échange s'affiche.


Les méthodes pour lancer une demande d'échange à un utilisateur
Il est possible de choisir dans le fichier configuration si le trade doit se faire seulement lorsque les joueurs sont face à face ou pas, c'est à dire qu'ils peuvent trader quelque soit la distance.

Il y a 3 méthodes pour lancer une demande d'échange:
1- La realiste et la Roleplay, vous devez viser le joueur et écrire dans le chat /trade
2- Depuis le Scoreboard de ma conception. Cliquez sur le joueur dans le scoreboard pour voir la proposition trader. Il faudra alors posseder la version 2.6 de Gmod Scoreboard Editable.
3- Cette méthode n'existe pas encore, vous me le suggérerez bien assez tôt.


Possibilité de Vendre ou d'Acheter grâce à l'emplacement MONEY
À l'origine cet addon devait juste être un système de trade d'objet, j'ai ajouté une option (désactivable si non souhaité) qui permet aux utilisateurs de mettre une somme qui sera envoyé au trader à la fin du trade, ce qui transforme ce script d'échange en aussi un système de vente entre joueurs. Ce qui fait que vous pouvez aussi utiliser ce script pour envoyer de l'argent à un autre joueur.

Comment ça se passe?
Pendant un trade, cliquez sur la zone où il y a l'argent pour insérer le montant que vous souhaitez mettre, l'autre joueur verra la somme que vous mettez de son coté, à la fin de la transaction l'utilisateur recevra cette somme.

Les système de monnaie compatible est celui du DarkRP et celui que j'ai conçu Gmod Money System + HUD Maker


Le bouton de verrouillage (Lock)
La fonction verrouillage permet de dire que vous êtes prêt, cela a pour effet de bloquer tout nouvelle ajout/retrait, modification du prix des deux cotés. Ainsi d’empêcher l'un des deux cotés d'ajouter ou de retirer des objets ou de modifier le prix. Pour confirmer la vente les deux parties devront avoir activé le verrouillage pour dire qu'ils sont prêt. C'est alors que le bouton "Valider" devient disponible pour terminer l'échange.
Pour pouvoir valider l'échange les deux échangeurs devront verrouiller chacun de leur coté pour débloquer le bouton de validation.


️ Sécurité serverside
Du coté serveur il y a une vérification qui permet à l'utilisateur de ne pas pouvoir placer des objets qu'il n'a pas. J'ai souvent été confronté sur mes serveurs à des utilisateurs qui modifiaient le coté client pour tenter se genre de méthode de triche. Ce sera quelque chose que vous n'aurez pas à vous soucier.


🧩 Addons Gmod d'inventaire compatible
Le script fonctionne bien tout seul car il permet de base d'échanger et de vendre les armes et les munitions, mais il fonctionne encore mieux avec Gmod Advanced Inventory System et Gmod Pocket System without DarkRP qui permettent de stocker des objets.
L'addon est aussi compatible avec la Pocket du DarkRP.


À quel type de besoin Gmod Items Trading and Selling System peut-il répondre?
Vous recherchez un script pour apporter une notion de troque à votre serveur.
Vous recherchez un script pour apporter une notion de vente entre joueurs à votre serveur.
Vous recherchez un script pour permettre à vos utilisateurs de s'échanger des armes et des munitions entre eux sur votre gamemode.


API associé avec l'addon Gmod Items Trading and Selling System
Si vous souhaitez utiliser une autre méthode que la commande /trade pour échanger avec le joueur que vous visez.

Fonctions Lua coté serveur:
player1:TradeRequest(player2) = Permet au joueur 1 d'envoyer une requête au joueur 2.


🧰 Les modifications possible via le fichier de configuration
Vous aurez la possibilité de customise:

Le style et les couleurs
Les effets sonores.
La distance de requis pour échanger. (Proximité ou pas)
Le type d'image que vous voulez pour les objets (image du model 3D, Image de l'objet du spawn menu, ou image custome que vous ajouterez vous même)
Choisissez d'afficher l'avatar steam ou le visage du playermodel en image dans la fenêtre de trade.



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

- Chemin : garrysmod/addons/ norda_items_trading_addon


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