WTB 插件 – 求购市场系统
一款简洁、现代且基于 GUI 的 Minecraft 服务器求购订单市场插件。
玩家创建购买请求,卖家进行交付,从而构建由玩家驱动且动态变化的经济体系。
专为 Spigot/Paper 1.20+ 设计,完全支持 Vault 经济系统。
? 概述
WTB Plugin 为 Minecraft 引入了以买家为导向的交易系统。
不同于拍卖行或箱子商店,玩家发布他们想要购买的物品的求购订单,其他玩家则负责完成这些订单。
这将带来:
- 更健康的服务器经济环境
- 更多的玩家互动
- 收集资源的动力
- 简洁直观的交易体验
非常适合生存服、经济服和 SMP 服务器。
✨ 功能特性
? 玩家功能
- 创建求购订单:
/wtb buy <material> <quantity> <price>
- 通过 GUI 浏览所有挂单
- 通过我的挂单管理个人订单
- 通过领取箱(支持无限分页)领取已完成的物品
- 在交易记录 GUI中查看交易历史
- 防刷屏冷却系统
- 禁用材料强制检测
- 安全的领取处理,确保物品不丢失
? 管理员功能
/wtb admin list — 查看所有活跃挂单
/wtb admin cancel <id> — 强制取消任意挂单
- GUI 中仅显示管理员可见的挂单 ID
- 仅管理员可用的 Tab 补全
- UUID 到玩家名称的解析,以便输出可读信息
? 技术细节
- 平台: Spigot/Paper 1.20+
- 经济系统: Vault
- 数据库: SQLite 或 MySQL
- 架构:
ListingService — 业务逻辑
ListingDAO — 数据库操作
- GUI 系统基于 Bukkit Inventory API 构建
- 权限:
? 安装指南
- 从 Releases 页面下载最新版本。
- 将 JAR 文件放入服务器的
plugins/ 文件夹中。
- 启动服务器以生成配置文件。
- 根据需要编辑
config.yml 和 settings.yml。
- 重载或重启服务器。
? 命令列表
玩家命令
/wtb buy <material> <qty> <price>
/wtb
管理员命令
/wtb admin list
/wtb admin cancel <id>
? 配置文件说明
config.yml — 数据库设置、冷却时间及通用配置
settings.yml — GUI 设置及禁用材料列表
plugin.yml — 插件元数据
? 稳定性与安全
- 安全的领取处理机制
- 针对大数据集的分页功能
- 对无效或过期挂单的验证
- 异步数据库操作
? 路线图(未来构想)
- 挂单过期系统
- GUI 中的排序与过滤功能
- 用于完成订单的卖家端 GUI
- 管理员数据分析仪表盘
- 多货币支持
? 技术支持
发现 Bug?有功能建议?
请在 GitHub 上提交 Issue —— 欢迎贡献与建议。
? 许可证
本项目采用 MIT License 授权。
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
- Download the latest release from the Releases page.
- Place the JAR into your server’s
plugins/ folder.
- Start the server to generate configuration files.
- Edit
config.yml and settings.yml as needed.
- 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.
评论 0
登录后参与评分
还没有评论,来抢沙发吧