WTB Plugin – Want‑To‑Buy Marketplace System

A clean, modern, GUI‑driven buy‑order marketplace plugin for Minecraft servers.
Players create buy requests, sellers fulfill them, and the economy becomes player‑driven and dynamic.
Built for Spigot/Paper 1.20+ with full Vault economy support.

---

📘 Overview

The WTB Plugin introduces a buyer‑driven trading system to Minecraft.
Instead of auctions or chest shops, players post buy orders for items they want, and other players fulfill them.

This creates:

• A healthier server economy
• More player interaction
• A reason to gather resources
• A clean, intuitive trading experience

Perfect for Survival, Economy, and SMP servers.

---

✨ Features

🎯 Player Features

• Create buy orders:
  /wtb buy <material> <quantity> <price>
• Browse all listings through a GUI
• Manage personal orders via My Listings
• Claim fulfilled items through the Claim Box (infinite pagination)
• View transaction history in the Transactions GUI
• Cooldown system to prevent spam
• Blocked‑material enforcement
• Safe claim handling with no item loss

🛠 Admin Features

• /wtb admin list — view all active listings
• /wtb admin cancel <id> — force‑cancel any listing
• Admin‑only listing IDs in GUIs
• Admin‑only tab completion
• UUID → player name resolution for readable output

---

🧩 Technical Details

• Platform: Spigot/Paper 1.20+
• Economy: Vault
• Database: SQLite or MySQL
• Architecture:
  • ListingService — business logic
  • ListingDAO — database operations
  • GUI system built with Bukkit Inventory API
• Permissions:
  • wtb.admin — admin commands & listing visibility

---

📦 Installation

1. Download the latest release from the Releases page.
2. Place the JAR into your server’s plugins/ folder.
3. Start the server to generate configuration files.
4. Edit config.yml and settings.yml as needed.
5. Reload or restart the server.

---

📝 Commands

Player Commands

/wtb buy <material> <qty> <price>
/wtb

Admin Commands

/wtb admin list
/wtb admin cancel <id>

---

📄 Configuration Files

• config.yml — database, cooldowns, and general settings
• settings.yml — GUI settings and blocked materials
• plugin.yml — plugin metadata

---

🛡 Stability & Safety

• Safe claim handling
• Pagination for large datasets
• Validation for invalid or expired listings
• Async database operations

---

🚀 Roadmap (Future Ideas)

• Listing expiration system
• Sorting & filtering in GUIs
• Seller‑side GUI for fulfilling orders
• Analytics dashboard for admins
• Multi‑currency support

---

📬 Support

Found a bug? Have a feature request?
Open an Issue on GitHub — contributions and suggestions are welcome.

---

📜 License

This project is licensed under the MIT License.