WTB Plugin

Minecraft 版本： 1.21 1.21.1 1.21.2 1.21.3 1.21.4 1.21.5 1.21.6 1.21.7 1.21.8 1.21.9 1.21.10 1.21.11

平台： paper spigot

标签： economy management utility

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.