? DonutOrders
一个由玩家主导的购买订单市场。 没有箱子商店,无需管理员设置。只有简洁的 GUI 和自动化的经济系统。
Paper · Purpur · Folia · Spigot — 1.20.x / 1.21.x · Java 17+ · 需要 Vault
工作原理
- 买家打开
/orders → New Order(新订单)→ 选择材料 → 在聊天栏中输入数量和单价。
- 资金会立即托管——买家无法花费他们不拥有的资金。
- 卖家浏览市场,选择一个订单,将物品放入 45 格的交付 GUI → 即时收款。
- 部分完成的订单会将已交付的物品保存在虚拟仓库中,直到买家领取。
- 订单会在配置的天数后自动过期;任何未使用的资金都会退还。
功能
买家端
- 为服务器允许列表中的任何材料发布购买订单
- 托管系统——创建订单时扣除资金,防止重复消费
- 状态追踪——活跃、已完成、已过期或已取消
- 虚拟仓库——即使你的背包已满,交付的物品也会存储在服务器端
- 溢出保护——无法装入背包的物品会掉落在你脚边
- 取消与退款——可以取消任何活跃订单并收回未使用的余额
卖家端
- 在分页的市场 GUI 中浏览所有活跃订单
- 45 格交付网格——仅接受正确的材料
- 错误物品拒绝——GUI 会立即拒绝不兼容的物品并显示清晰的消息
- 部分填充——你可以交付任意数量的物品;按件付款
- 防复制锁定——对同一订单的并发交付尝试会在服务器端串行化执行
- 多余物品退回——超出订单需求的物品会自动退回你的背包
经济系统
- Vault 驱动——兼容 EssentialsX、CMI 以及任何支持 Vault 的经济插件
- 可选的卖家税作为经济消耗项(默认关闭)
- 退款金额精确无误——无舍入误差
技术特性
- 完全支持 Folia——所有调度均使用区域化的实体/全局调度器;同样适用于标准的 Paper/Spigot
- SQLite + HikariCP——订单持久化到本地 WAL 模式数据库;无需外部数据库
- 完全异步 I/O——数据库读写绝不会阻塞主线程
- 阴影且重定位的依赖项——不会与其他插件产生类路径冲突
GUI 界面
| 界面 |
用途 |
| 主菜单 |
我的订单 / 浏览市场 / 领取仓库 |
| 我的订单 |
查看活跃订单、取消、领取仓库 |
| 新订单 |
选择材料,通过聊天栏设置数量和价格 |
| 浏览市场 |
所有活跃订单的分页列表 |
| 交付物品 |
45 格网格,仅接受正确的材料 |
| 订单详情 |
进度、价格、过期时间、仓库状态、取消按钮 |
命令
| 命令 |
描述 |
权限 |
/orders |
打开订单菜单(别名:/order, /market) |
donutorders.use |
/orders admin reload |
重新加载配置文件和消息 |
donutorders.admin |
权限
| 权限 |
描述 |
默认值 |
donutorders.use |
所有 /orders 命令和 GUI 功能 |
所有人 |
donutorders.admin |
访问管理员子命令 |
OP |
配置
orders:
max-per-player: 10 # 每个玩家同时活跃的最大订单数
default-expiry-days: 7 # 未完成的订单过期前的天数
tax-percent: 0.0 # 从卖家收益中抽取作为经济消耗项的百分比(0 = 关闭)
database:
filename: donutorders.db
allowed-materials:
- DIAMOND
- EMERALD
- GOLD_INGOT
# ... 任何 Bukkit Material 名称
所有面向玩家的字符串都在 messages.yml 中——支持 & 颜色代码和 #RRGGBB 十六进制颜色。
安装
- 将
DonutOrders.jar 放入你的 plugins/ 文件夹。
- 确保已安装 Vault 和经济插件(例如 EssentialsX)。
- 启动服务器——
config.yml 和 messages.yml 会自动生成。
- 根据需要编辑
allowed-materials 和其他选项。
- 运行
/orders admin reload 以应用更改而无需重启服务器。
要求
| 要求 |
版本 |
| Paper / Purpur / Folia / Spigot |
1.20.x 或 1.21.x |
| Java |
17+ |
| Vault |
任何兼容版本 |
| 经济插件 |
EssentialsX、CMI 或任何 Vault 经济插件 |
? DonutOrders
A player-driven buy order marketplace. No chest shops. No admin setup. Just a clean GUI and automatic economy.
Paper · Purpur · Folia · Spigot — 1.20.x / 1.21.x · Java 17+ · Requires Vault
How it works
- A buyer opens
/orders → New Order → picks a material → types quantity and price-per-unit in chat.
- Funds are escrowed immediately — buyers can't spend money they don't have.
- Sellers browse the marketplace, pick an order, drop items into the 45-slot delivery GUI → paid on the spot.
- Partially-filled orders keep delivered items in a virtual stash until the buyer collects them.
- Orders expire automatically after a configurable number of days; any unspent funds are refunded.
Features
Buyer side
- Post buy orders for any material on the server's allowed list
- Escrow system — funds are withdrawn on order creation, preventing double-spending
- Status tracking — Active, Completed, Expired, or Cancelled
- Virtual stash — delivered items are stored server-side even when your inventory is full
- Overflow protection — items that don't fit on collection are dropped at your feet
- Cancel & refund — cancel any active order and receive the unspent balance back
Seller side
- Browse all active orders in a paginated marketplace GUI
- 45-slot delivery grid — only the correct material is accepted
- Wrong-item rejection — the GUI refuses incompatible items immediately with a clear message
- Partial fills — deliver as many or as few items as you want; payment is per-item
- Anti-duplication lock — concurrent delivery attempts on the same order are serialised server-side
- Excess item return — items beyond what the order needs are automatically returned to your inventory
Economy
- Vault-powered — works with EssentialsX, CMI, and any Vault-compatible economy plugin
- Optional seller tax as an economy sink (disabled by default)
- Refunds are always exact — no rounding errors
Technical
- Full Folia support — all scheduling uses regionalised entity/global schedulers; also works on standard Paper/Spigot
- SQLite + HikariCP — orders persisted to a local WAL-mode database; no external DB required
- Fully async I/O — database reads and writes never block the main thread
- Shaded & relocated dependencies — no classpath conflicts with other plugins
GUI screens
| Screen |
Purpose |
| Main menu |
Your orders / Browse market / Collect stash |
| Your orders |
View active orders, cancel, collect stash |
| New order |
Pick material, set amount and price via chat |
| Browse market |
Paginated list of all active orders |
| Deliver items |
45-slot grid accepting only the correct material |
| Order detail |
Progress, price, expiry, stash status, cancel button |
Commands
| Command |
Description |
Permission |
/orders |
Open the orders menu (alias: /order, /market) |
donutorders.use |
/orders admin reload |
Reload config and messages |
donutorders.admin |
Permissions
| Permission |
Description |
Default |
donutorders.use |
All /orders commands and GUI features |
Everyone |
donutorders.admin |
Access admin sub-commands |
OP |
Configuration
orders:
max-per-player: 10 # Max simultaneous active orders per player
default-expiry-days: 7 # Days before an unfilled order expires
tax-percent: 0.0 # % of seller payout taken as economy sink (0 = off)
database:
filename: donutorders.db
allowed-materials:
- DIAMOND
- EMERALD
- GOLD_INGOT
# ... any Bukkit Material name
All player-facing strings are in messages.yml — supports & colour codes and #RRGGBB hex colours.
Installation
- Drop
DonutOrders.jar into your plugins/ folder.
- Make sure Vault and an economy plugin (e.g. EssentialsX) are installed.
- Start the server —
config.yml and messages.yml are generated automatically.
- Edit
allowed-materials and other options to your liking.
- Run
/orders admin reload to apply changes without a restart.
Requirements
| Requirement |
Version |
| Paper / Purpur / Folia / Spigot |
1.20.x or 1.21.x |
| Java |
17+ |
| Vault |
Any compatible release |
| Economy plugin |
EssentialsX, CMI, or any Vault economy |
评论 0
登录后参与评分
还没有评论,来抢沙发吧