Orders 插件
一个购买订单市场插件——发布需求物品,预先支付资金作为担保,让其他玩家交付物品并即时获得报酬。只需输入 /orders 即可。
与发布待售物品不同,玩家在这里发布的是他们想要的物品:指定物品、数量以及单价。全额费用会立即从玩家的余额中扣除并托管在第三方账户(Escrow)中。任何玩家都可以将匹配的物品直接存入订单并完成交付,从而即时获得报酬——无需谈判,也无需等待买家上线。
支持 Bukkit、Spigot、Paper 和 Folia。
工作原理
- 玩家打开
/orders,选择一种物品,设置数量和单价,然后确认。总金额(数量 × 单价)会立即从玩家的余额中扣除。
- 该订单会在市场中显示供其他人查看。
- 任何其他玩家可以打开订单并存入匹配的物品。他们会立即收到付款,资金直接来自已托管的款项——由于资金在订单创建时就已经预留,因此交付绝不会出现“空头支票”的情况。
- 买家可以随时通过自己的订单界面收取已交付的物品。
- 取消订单时,系统会退还剩余的资金,并归还所有已交付但尚未被领取的物品。
功能特性
- 托管资金担保的订单 — 资金预先扣除,确保每次交付都能获得报酬。
- 物品选择器 — 直接在菜单中浏览和选择任何可订购的物品,支持搜索并按 A→Z 或 Z→A 排序。
- 基于聊天的输入 — 在聊天框中输入确切的金额和价格,而不是通过滑块点击选择。
- 市场排序 — 可按最近发布、总成交额(数量 × 单价)、最多交付数量或每件物品的最佳价格进行排序。
- 分类过滤器 — 刷怪笼、药水、书籍、工具、战斗类、食物、原材料、方块以及一个通用的“实用工具”类别,完全自定义。
- 搜索功能 — 可按物品名称或下单玩家的名称进行搜索。
- 我的订单界面 — 查看当前发布的所有订单,领取已交付的物品,或通过确认步骤取消订单。
- 极简交付界面 — 放入物品并关闭窗口即可完成交付;无需额外点击。无论以何种方式关闭窗口,都不会重复付款。
- 一键全取 — 一次性获取所有等待领取的物品,直到装满背包为止。
- 每位玩家的订单上限 — 默认限制开放订单的数量,可通过权限节点按等级提升上限。
- 创建冷却时间 — 可选的下单间隔延迟,防止市场被大量订单淹没。
- 可配置的价格和数量限制 — 包括对订单总价值的可选封顶。
- 黑名单 — 禁止特定物品(以及整组物品,如所有颜色的潜影盒)被订购。
- 第三方物品 Lore 兼容性 — 忽略由其他插件添加的装饰性 Lore(例如售价标签),以确保交付匹配正确。
- 聊天广播 — 可选择向拥有相应权限的所有玩家公告新发布的订单。
- 完全自定义的菜单、消息和音效 — 每个菜单布局、颜色、消息和音效提示均可通过 YAML 文件编辑,包括十六进制颜色代码。
- 多语言支持 — 独立的语言文件夹(包含英语和德语),可在配置文件中进行选择。
- 灵活的存储方案 — 可选择 YAML(默认,人类可读)、SQLite 或 MySQL(用于在多个服务器间共享同一市场)。Orders 1.x 的旧数据会自动迁移。
- Vault 经济支持 — 挂钩任何兼容 Vault 的经济插件。
- PlaceholderAPI 支持 — 在任何支持占位符的地方暴露实时订单市场数据(详见下文)。
命令
| 命令 |
描述 |
/orders |
打开订单市场 |
/orders reload |
重载配置和菜单 |
/orders list [player] |
列出所有订单,或仅列出某位玩家的订单 |
/orders info <id> |
查看特定订单的详细信息 |
/orders remove <id> |
强制移除订单并退款给所有者 |
别名:/order
权限
| 权限节点 |
默认值 |
描述 |
orders.use |
所有玩家 |
使用 /orders 打开订单市场 |
orders.create |
所有玩家 |
创建购买订单 |
orders.deliver |
所有玩家 |
完成其他玩家的订单 |
orders.broadcast |
所有玩家 |
当有人创建订单时接收聊天公告 |
orders.bypass-limit |
op |
忽略每位玩家的订单上限和创建冷却时间 |
orders.admin |
op |
使用 /orders reload、list、info 和 remove |
orders.limit.<number> |
— |
将该玩家的最大开放订单数提升至 <number>(仅限高于配置默认值的数字;持有最高权限节点的生效) |
PlaceholderAPI 占位符
需要安装 PlaceholderAPI 和 orders 扩展模块。
| 占位符 |
返回值 |
%orders_total% |
订单总数(包括开放中和已完成的) |
%orders_open% |
当前开放的订单数量 |
%orders_filled% |
已完全交付的订单数量 |
%orders_wanted% |
所有开放订单中仍需要的物品总量 |
%orders_value% |
所有订单中托管资金的总额(格式化显示) |
%orders_value_raw% |
所有订单中托管资金的总额(原始数值) |
%orders_own_open% |
查看者当前开放的订单数量 |
%orders_own_filled% |
查看者的订单中已完全交付的数量 |
%orders_own_pending% |
查看者的订单中仍需领取的数量 |
%orders_own_delivered% |
已交付到查看者订单中的物品数量 |
%orders_own_escrow% |
查看者当前托管在第三方账户中的资金(格式化显示) |
%orders_own_escrow_raw% |
查看者当前托管在第三方账户中的资金(原始数值) |
%orders_own_free% |
查看者还可以开放多少个订单 |
%orders_own_limit% |
查看者的最大开放订单数 |
依赖项
- Vault(软依赖)—— 任何经济功能正常运行所必需
- PlaceholderAPI(软依赖)—— 仅在使用上述占位符时必需
Orders Plugin
A buy-order market plugin — request items, back the request with money up front, and let other players deliver them for an instant payout. Just type /orders.
Instead of listing items for sale, players post what they want: an item, an amount, and a price per unit. The full cost is taken from their balance immediately and held in escrow. Anyone can then deliver matching items straight into the order and get paid on the spot — no negotiation, no waiting for a buyer to show up.
Supports Bukkit, Spigot, Paper, and Folia.
How it works
- A player opens
/orders, picks an item, sets an amount and a price per item, and confirms. The full total (amount × price) is taken from their balance right away.
- The order appears on the market for everyone else to see.
- Any other player can open the order and deposit matching items. They're paid instantly, straight out of the money already held in escrow — a delivery can never bounce, because the funds were set aside the moment the order was created.
- The buyer collects delivered items from their own order screen whenever they like.
- Cancelling an order refunds whatever money is left and returns any items already delivered but not yet collected.
Features
- Escrow-backed orders — money is taken up front, so every delivery is guaranteed to pay out.
- Item picker — browse and select any orderable item directly from a menu, searchable and sorted A→Z or Z→A.
- Chat-based input — type exact amounts and prices in chat rather than clicking through sliders.
- Sort the market — recently listed, most paid (amount × price), most delivered, or best money-per-item.
- Category filters — spawners, potions, books, tools, combat, food, ingredients, blocks, and a catch-all "utilities" category, fully customizable.
- Search — search by item name, or by the name of the player who placed the order.
- Your Orders screen — see everything you currently have posted, collect what's been delivered, or cancel with a confirmation step.
- Bare-bones delivery screen — drop items in and close the window to deliver; no extra clicks needed. Delivering never pays twice, no matter how the screen is closed.
- Take-all collection — grab everything waiting for you at once, up to what fits in your inventory.
- Per-player order limits — a default cap on open orders, raisable per-rank via permission nodes.
- Creation cooldown — optional delay between placing orders, to stop the market being flooded.
- Configurable price and amount limits — including an optional cap on total order value.
- Blacklist — block specific items (and whole families of items, like every shulker box color) from ever being ordered.
- Third-party item-lore compatibility — ignores decorative lore added by other plugins (e.g. sell-price tags) so deliveries still match correctly.
- Chat broadcasts — optionally announce new orders to everyone with the right permission.
- Fully customizable menus, messages, and sounds — every menu layout, color, message, and sound cue is editable via YAML, including hex colors.
- Multi-language support — separate language folders (English and German included) selected from the config.
- Flexible storage — choose between YAML (default, human-readable), SQLite, or MySQL (for sharing one market across multiple servers). Old data from Orders 1.x is migrated automatically.
- Vault economy support — hooks into any Vault-compatible economy plugin.
- PlaceholderAPI support — expose live order-market data anywhere placeholders are supported (see below).
Commands
| Command |
Description |
/orders |
Open the order market |
/orders reload |
Reload the config and menus |
/orders list [player] |
List all orders, or just one player's |
/orders info <id> |
View details on a specific order |
/orders remove <id> |
Force-remove an order and refund the owner |
Alias: /order
Permissions
| Permission |
Default |
Description |
orders.use |
all players |
Open the order market with /orders |
orders.create |
all players |
Create buy orders |
orders.deliver |
all players |
Fill other players' orders |
orders.broadcast |
all players |
Receive the chat announcement when somebody creates an order |
orders.bypass-limit |
op |
Ignore the per-player order limit and the creation cooldown |
orders.admin |
op |
Use /orders reload, list, info, and remove |
orders.limit.<number> |
— |
Raise this player's max open orders to <number> (only numbers above the configured default count; highest held node wins) |
PlaceholderAPI placeholders
Requires PlaceholderAPI and the orders expansion.
| Placeholder |
Returns |
%orders_total% |
Total number of orders (open and filled) |
%orders_open% |
Number of currently open orders |
%orders_filled% |
Number of fully delivered orders |
%orders_wanted% |
Total items still wanted across all open orders |
%orders_value% |
Total money held in escrow across all orders, formatted |
%orders_value_raw% |
Total money held in escrow, raw number |
%orders_own_open% |
How many orders the viewing player currently has open |
%orders_own_filled% |
How many of the viewing player's orders are fully delivered |
%orders_own_pending% |
How many of the viewing player's orders still need collecting |
%orders_own_delivered% |
How many items have been delivered to the viewing player's orders |
%orders_own_escrow% |
Money the viewing player currently has held in escrow, formatted |
%orders_own_escrow_raw% |
Money the viewing player currently has held in escrow, raw number |
%orders_own_free% |
How many more orders the viewing player is allowed to open |
%orders_own_limit% |
The viewing player's maximum number of open orders |
Dependencies
- Vault (soft-depend) — required for any economy features to function
- PlaceholderAPI (soft-depend) — required only if you want the placeholders above
评论 0
登录后参与评分
还没有评论,来抢沙发吧