TradesByPinsel

TradesbyPinsel

A simple and intuitive Minecraft trading plugin that allows players to sell and buy items using a GUI marketplace system.

---

Overview

| Feature | Description | | ------------------ | ------------------------------------------------------------ | | GUI Trading System | Players can easily sell and buy items through an in-game GUI | | Custom Prices | Sellers can adjust prices using buttons | | Player Marketplace | Browse items listed by other players | | Listing Management | Players can remove their own listings | | Admin Controls | Admins can remove listings from other players |

---

Features

* GUI-based trading system * Player-to-player item marketplace * Adjustable item prices * Easy listing management * Admin moderation tools * Lightweight and server-friendly

---

How It Works

Players can open the trading menu using:

``` /trade ```

A GUI opens with three options:

| Option | Description | | ----------- | ------------------------------------ | | Sell Item | List an item for sale | | My Listings | View and remove your listings | | Buy Items | Browse items listed by other players |

Each option opens its own GUI.

---

Selling Items

When selecting Sell Item, a trading interface opens.

Players place the item they want to sell into the center slot.

Price buttons allow adjusting the value:

| Button | Action | | ----------------------- | -------------- | | +1 / +10 / +100 / +1000 | Increase price | | -1 / -10 / -100 / -1000 | Decrease price |

Right-clicking increases the value faster.

A paper item in the GUI shows the current price and information.

Players can confirm the listing with the green confirm button.

---

Buying Items

Players can browse all active listings from other players.

Available actions:

* View listed items * Purchase items directly * Receive the purchased item instantly

---

My Listings

The My Listings menu allows players to manage their listings.

Players can:

* View their active listings * Remove listings using right-click

---

Admin Menu

Admins have additional controls inside the GUI.

| Admin Feature | Description | | --------------- | ----------------------------------------- | | Remove Listings | Delete listings from other players | | Admin Indicator | Admins see a special red block in the GUI |

---

Commands

Player Commands

| Command | Description | | -------- | --------------------- | | `/trade` | Opens the trading GUI |

Admin Commands

| Command | Description | | --------------- | -------------------------------- | | `/trade reload` | Reloads the plugin configuration |

---

Installation

1. Download the plugin `.jar` 2. Put it into the plugins folder of your server 3. Restart the server

---

Requirements

| Requirement | Version | | ---------------- | ----------------- | | Minecraft Server | 1.20+ recommended | | Server Software | Spigot / Paper |

---

Performance

TradesbyPinsel is designed to be lightweight and efficient.

The plugin has minimal performance impact and works well even on larger servers.

---

Developer

| Developer | | --------- | | PinselDEV |

---

License

This project is licensed under the MIT License.