Gmod Items Trading and Selling System

Description of Gmod Items Trading and Selling System
🇫🇷 🇬🇧

---

---

Sommaire :

1. 📘 Description of the Gmod Items Trading and Selling System addon
2. 🎒 Trade requests System
3. 💬 The methods for initiating a trade request to a user
4. 💰 Ability to Sell or Buy through the MONEY slot
5. 🔒 The Lock button
6. 🛡️ Security serverside
7. 🧩 Gmod inventory compatible addons
8. ❓ What type of need can Gmod Items Trading and Selling System meet
9. 🇬 API associated with Gmod Items Trading and Selling System addon
10. 🧰 Possible changes via the configuration file

📘 Description of the Gmod Items Trading and Selling System addon

Items Trading and Selling System is a Gmod addon designed to allow your users to trade or sell items from various storage modes. Gmod already uses HL2 inventory for weapons and ammo, I include the possibility to trade from my inventory system (compatibility assured) and my pocket system external to DarkRP, also works with the DarkRP pocket. You will have understood that this addon can run without gamemode like most of my addons.

🎒 Trade requests System

When you send an object exchange request to a user, he will be notified by a window that opens on his screen. They will have the choice to Accept or Decline. You will also have a window to inform you that your request is pending, you can cancel it at any time. If the user refuses then your window will close automatically, if he accepts the exchange window will appear.

💬 The methods for initiating a trade request to a user

It is possible to choose in the configuration file if the trade should be done only when the players are face to face or not, i.e. they can trade regardless of the distance.

There are 3 methods to launch a trade request:
1- The realistic one and the Roleplay one, you have to aim at the player and write in the chat /trade
2- From the Scoreboard of my design. Click on the player in the scoreboard to see the trader proposal. It will be necessary to have the version 2.6 of Gmod Scoreboard Editable.
3- This method does not exist yet, you will suggest it to me soon enough.

💰 Ability to Sell or Buy through the MONEY slot

Originally this addon was just meant to be an item trading system, I added an option (disable if not desired) that allows users to put an amount that will be sent to the trader at the end of the trade, which turns this trading script into also a player to player selling system. So you can also use this script to send money to another player.

How does it work?
During a trade, click on the area where there is money to insert the amount you want to put, the other player will see the amount you put on his side, at the end of the transaction the user will receive this amount.

The compatible money system is the one of DarkRP and the one I designed Gmod Money System + HUD Maker

🔒 The Lock button

The lock function allows you to say that you are ready, this has the effect of blocking any new addition/removal, modification of the price on both sides. Thus preventing one of the two sides to add or remove items or change the price. To confirm the sale both parties will have to have activated the lock to say they are ready. Then the "Validate" button becomes available to complete the exchange.
To be able to validate the exchange the two exchangers will have to lock each one on their side to unlock the validation button.

🛡️ Security serverside

On the server side there is a check that allows the user to not be able to place objects that he doesn't have. I've often been confronted on my servers with users modifying the client side to try this kind of cheating method. This will be something you don't have to worry about.

🧩 Gmod inventory compatible addons

The script works well on its own as it allows basic trading and selling of weapons and ammunition, but it works even better with Gmod Inventory System and Gmod Pocket System without DarkRP which allow storing items.
The addon is also compatible with the Pocket of DarkRP.

This script is not designed for: ItemStore, XInventory, DInventory.

❓ What type of need can Gmod Items Trading and Selling System meet

You are looking for a script to bring a notion of barter to your server.
You are looking for a script to bring a notion of selling between players to your server.
You are looking for a script to allow your users to trade weapons and ammunition with each other on your gamemode.

🇬 API associated with Gmod Items Trading and Selling System addon

If you want to use another method than the /trade command to exchange with the player you are targeting.

Lua functions on the server side:
player1:TradeRequest(player2) = Allows player1 to send a request to player2.

🧰 Possible changes via the configuration file

You will have the possibility to customize:

The style and colors
The sound effects.
The distance required to exchange. (Proximity or not)
The type of image you want for the objects (image of the 3D model, image of the object of the spawn menu, or image custome that you will add yourself)
Choose to display the steam avatar or the face of the playermodel in the trade window.

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

- Path : garrysmod/addons/ norda_items_trading_addon

- Gmod Content Workshop ID : 2890280331
- You can add this to a server-side Lua file : resource.AddWorkshop( 2890280331 )
- To add the gmod workshop resources to your collection : Gmod Items Trading and Selling System [Content Only] | Gmod Workshop

Tip to avoid the leak of Gmod Items Trading and Selling System 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?