? OrdersPro
适用于 Minecraft 服务器的专业购买订单与合同系统
不是拍卖行。不是商店。是一个任务板。
玩家发布他们需要什么,工人获得报酬来交付它。
OrdersPro 是一个功能完备的反向市场插件。买家发布购买订单——“我需要 5,000 个钻石,每个 10 美元”——然后工人在市场中浏览,接受合同,并通过履行订单来赚取金钱。每笔交易都由托管资金(escrow)、信任评分和财务惩罚作为后盾,以确保双方都承担责任。
从底层构建,旨在提供高性能、可靠性以及精致的玩家体验。
? 工作原理
| 角色 |
行为 |
| 买家 |
发布包含物品、数量、单价的购买订单,并预先托管资金 |
| 工人 |
浏览市场,接受合同,在会话中交付物品以赚取报酬 |
与卖家列出物品的拍卖行不同,OrdersPro 翻转了这一模式——由买家驱动需求,由工人满足需求。非常适合大型经济环境,其中玩家需要大量材料而不想自己进行采集。
✨ 功能特性
? 市场面板
- 可滚动、分页的市场显示所有开放的购买订单
- 支持通过单击一键按最高单价排序或按最新排序
- 每个订单卡片显示买家、所需数量、单价、总价值和剩余时间
- 当有物品准备好领取时,收集箱会发光
? 订单创建
- 混合创建流程——手持物品可直接跳过材质选择器
- 可滚动的材质选择 GUI,支持空手创建时的实时聊天搜索过滤
- 基于聊天的数量和价格输入,具备完整的验证功能(最小/最大边界来自配置文件)
- 确认 GUI,包含完整的成本明细——托管金额、税费、总收费以及实时余额检查
- 价格警告系统——如果你的价格高于市场平均水平 300% 以上,确认按钮会变红并要求二次点击
? 私人订单
/order create @PlayerName 向特定玩家发送定向合同
- 目标玩家在他们的仪表盘中看到该订单,可以接受或拒绝
- 与公共订单相同的财务规则——全额托管、税费、惩罚
? 我的商业仪表盘
- 查看你发布的所有订单,带有实时进度条、工人姓名和剩余时间
- 如果工人不活跃,催促你的工人
- 取消订单并执行适当的惩罚——如果工人已完成超过 50%,则被阻止取消
- 查看并管理你当前的工人合同
- 接受或拒绝传入的私人订单
? 交付系统
- 工人打开带有 +/− 数量选择器的交付 GUI
- 每次会话的最小存款 = 订单总额的 10%(可配置)
- 实时库存预览准确显示将消耗哪些物品堆叠
- 完全交付后自动完成订单并立即支付
?️ 收集箱
- 已完成订单的物品进入安全的收集箱——绝不会掉落在地上
- 全部收取按钮将所有物品原子式地移动到你的背包中
- 溢出部分安全地掉落至你的脚边——永远不会丢失任何物品
? 订单历史
- 每位玩家最近完成的 20 个订单,包括已取消或过期的订单
- 显示角色(买家/工人)、交易对手、结果、赚取/花费的金额以及日期
- 完全只读——不可变的账本
⚖️ 财务系统
| 事件 |
结果 |
| 发布订单 |
预先锁定托管资金 + 发布税 |
| 取消(无工人) |
全额退还托管资金,损失税费 |
| 取消(工人 < 50%) |
工人按比例获得 × 1.5 倍奖金,从托管资金中支付 |
| 取消(工人 > 50%) |
❌ 被阻止——无法取消 |
| 订单完成 |
全额托管资金支付给工人 |
| 工人放弃 |
工人罚款 10% → 买家,增加信任打击 |
| 订单过期(无工人) |
全额托管资金退还给买家 |
| 订单过期(工人失败) |
工人罚款 → 买家,对已交付物品部分付款 |
?️ 信任系统
- 工人因放弃或未能履行合同而累积打击次数(strikes)
- 触发冷却期前的最大打击次数可配置
- 冷却持续时间可配置
- 打击衰减——在 configurable number of days 之后,旧打击将被忽略
- 处于冷却期的玩家在仪表盘中看到剩余时间
? 管理员工具
/order reload — 重新加载 config.yml 并从数据库刷新内存中的订单缓存
- 所有财务常数完全可配置——没有硬编码值
- SQLite 存储,使用 WAL 模式以提高性能和崩溃安全性
- 启动/关闭日志记录,服务器停止时完整持久化订单
? 命令
| 命令 |
描述 |
权限 |
/order |
打开市场面板 |
orderspro.use |
/order create |
发布新的购买订单 |
orderspro.use |
/order create @<player> |
向玩家发送私人订单 |
orderspro.use |
/order dashboard |
打开我的商业(你的订单和合同) |
orderspro.use |
/order history |
查看你最近的 20 个订单 |
orderspro.use |
/order reload |
重新加载配置和订单缓存 |
orderspro.admin |
别名: /orders, /market, /contract, /contracts
? 权限
| 权限 |
默认设置 |
描述 |
orderspro.use |
所有人 |
访问市场、仪表盘、历史记录 |
orderspro.create |
所有人 |
发布购买订单 |
orderspro.work |
所有人 |
接受和履行合同 |
orderspro.private |
所有人 |
发送和接收私人订单 |
orderspro.admin |
OP |
所有管理员功能(继承上述所有权限) |
orderspro.admin.reload |
OP |
运行 /order reload |
orderspro.admin.inspect |
OP |
检查任何玩家的订单(未来功能) |
⚙️ 配置
settings:
currency-symbol: "$"
expiration-check-interval-seconds: 30 # 处理过期订单的频率
orders:
duration-hours: 48 # 订单在市场停留的时间(小时)
max-active-orders: 5 # 买家同时可发布的最大订单数
min-quantity: 1
max-quantity: 100000
min-price-per-unit: 0.01
max-price-per-unit: 1000000.0
price-warning-multiplier: 3.0 # 若价格高于市场均价 300%+ 则发出警告
economy:
tax-rate: 0.05 # 5% 发布税(不可退还)
min-deposit-fraction: 0.10 # 工人每轮会话至少需存入 10%
failure:
fine-percentage: 0.10 # 订单过期时,工人将被处以订单价值 10% 的罚款
payout-modifier: 0.50 # 失败情况下,工人获得已交付价值 50% 的赔付
cancellation:
worker-payout-modifier: 1.50 # 买家取消订单时,工人获得按比例计算金额的 150%
cancellation-block-threshold: 0.50 # 当交付进度达到 50% 后,买家无法取消订单
trust:
max-strikes-before-cooldown: 3
cooldown-duration-hours: 24
strike-decay-days: 30 # 超过 30 天的违规记录将被忽略
timer:
inactivity-nudge-threshold-hours: 1 # 买家在多少小时后可以催促工人
nudge-cooldown-minutes: 30 # 两次催促之间的冷却时间(分钟)
---
## ? 依赖要求
- **Minecraft:** 1.21+
- **服务端:** Paper, Spigot 或 Purpur
- **依赖插件:** [Vault](https://www.spigotmc.org/resources/vault.34315/) + 任意经济插件(如 EssentialsX、CMI 等)
- **存储:** SQLite(内置,无需额外配置)
---
## ?️ 开发路线图
- [ ] 管理员检查命令 — 查看任意玩家的订单及信任评分
- [ ] 价格谈判系统
- [ ] 订单关注列表 — 当你喜欢的材料有新订单发布时收到通知
- [ ] PlaceholderAPI 支持
- [ ] 多语言支持
---
## 捐赠(可选)
如果你喜欢我的工作并希望支持开发:
[通过 PayPal 捐赠](https://paypal.me/Marbzy) ?
---
## ? 官方支持与社区
需要此插件的帮助吗?
加入官方 **Marbzy Discord 服务器**,享受以下服务:
- ? 直接插件支持(工单系统)
- ? 漏洞报告
- ? 功能建议
- ? Beta 测试准入资格
- ? 更新公告
? **[加入 Discord](https://discord.gg/SRHP79Jhzt)**
---
*由 Marbzy 开发*
? OrdersPro
The Professional Buy Order & Contract System for Minecraft Servers
Not an auction house. Not a shop. A job board.
Players post what they need, workers get paid to deliver it.
OrdersPro is a fully-featured reverse marketplace plugin. Buyers post Buy Orders — "I need 5,000 Diamonds at $10 each" — and workers browse the market, accept contracts, and earn money by fulfilling them. Every transaction is backed by escrow, trust scoring, and financial penalties to keep both sides accountable.
Built from the ground up for performance, reliability, and a polished player experience.
? How It Works
| Role |
What They Do |
| Buyer |
Posts a buy order with item, quantity, price per unit, and funds escrowed upfront |
| Worker |
Browses the market, accepts a contract, delivers items in sessions to earn payout |
Unlike auction houses where sellers list items, OrdersPro flips the model — buyers drive demand, workers fulfill it. Perfect for large economies where players need bulk materials and don't want to farm them themselves.
✨ Features
? Market Board
- Scrollable, paginated market showing all open buy orders
- Sort by Highest Price/Unit or Newest First with a single click
- Each order card shows buyer, quantity needed, unit price, total value, and time remaining
- Collection bin glows when you have items ready to pick up
? Order Creation
- Hybrid creation flow — hold an item to skip the material picker entirely
- Scrollable material picker GUI with live chat search filter for empty-hand creation
- Chat-based quantity and price input with full validation (min/max bounds from config)
- Confirmation GUI with full cost breakdown — escrow, tax, total charge, and live balance check
- Price warning system — if your price is 300%+ above market average, the confirm button turns red and requires a second click
? Private Orders
/order create @PlayerName sends a directed contract to a specific player
- Target sees it in their dashboard and can accept or decline
- Same financial rules as public orders — full escrow, tax, penalties
? My Business Dashboard
- View all your posted orders with live progress bars, worker name, and time remaining
- Nudge your worker if they've gone inactive
- Cancel orders with proper penalty enforcement — blocked if worker is past 50% delivery
- View and manage your active worker contract
- Accept or decline incoming private orders
? Delivery System
- Workers open a Delivery GUI with +/− quantity selectors
- Minimum deposit per session = 10% of total order (configurable)
- Live inventory preview shows exactly which item stacks will be consumed
- Auto-completes the order and pays out instantly when fully delivered
?️ Collection Bin
- Items from completed orders go to a safe collection bin — never dropped on the ground
- Collect All button moves everything to your inventory atomically
- Overflow drops safely at your feet — nothing is ever lost
? Order History
- Last 20 completed, cancelled, or expired orders per player
- Shows role (Buyer/Worker), counterparty, outcome, amount earned/spent, and date
- Fully read-only — an immutable ledger
⚖️ Financial System
| Event |
Result |
| Post order |
Escrow + posting tax locked upfront |
| Cancel (no worker) |
Full escrow returned, tax lost |
| Cancel (worker < 50%) |
Worker paid pro-rata × 1.5x bonus from escrow |
| Cancel (worker > 50%) |
❌ Blocked — cannot cancel |
| Order completed |
Full escrow paid to worker |
| Worker abandons |
10% fine from worker → buyer, trust strike added |
| Order expires (no worker) |
Full escrow returned to buyer |
| Order expires (worker failed) |
Fine from worker → buyer, partial pay for delivered items |
?️ Trust System
- Workers accumulate strikes for abandoning or failing contracts
- Configurable max strikes before cooldown kicks in
- Configurable cooldown duration
- Strike decay — old strikes are ignored after a configurable number of days
- Players on cooldown see remaining time in their dashboard
? Admin Tools
/order reload — reloads config.yml and refreshes the in-memory order cache from the database
- All financial constants fully configurable — no hardcoded values
- SQLite storage with WAL mode for performance and crash safety
- Startup/shutdown logging with full order persistence on server stop
? Commands
| Command |
Description |
Permission |
/order |
Open the market board |
orderspro.use |
/order create |
Post a new buy order |
orderspro.use |
/order create @<player> |
Send a private order to a player |
orderspro.use |
/order dashboard |
Open My Business (your orders & contracts) |
orderspro.use |
/order history |
View your last 20 orders |
orderspro.use |
/order reload |
Reload config and order cache |
orderspro.admin |
Aliases: /orders, /market, /contract, /contracts
? Permissions
| Permission |
Default |
Description |
orderspro.use |
Everyone |
Access the market, dashboard, history |
orderspro.create |
Everyone |
Post buy orders |
orderspro.work |
Everyone |
Accept and fulfill contracts |
orderspro.private |
Everyone |
Send and receive private orders |
orderspro.admin |
OP |
All admin features (inherits all above) |
orderspro.admin.reload |
OP |
Run /order reload |
orderspro.admin.inspect |
OP |
Inspect any player's orders (future) |
⚙️ Configuration
settings:
currency-symbol: "$"
expiration-check-interval-seconds: 30 # How often expired orders are processed
orders:
duration-hours: 48 # How long orders stay on the market
max-active-orders: 5 # Max orders a buyer can have posted at once
min-quantity: 1
max-quantity: 100000
min-price-per-unit: 0.01
max-price-per-unit: 1000000.0
price-warning-multiplier: 3.0 # Warn if price is 300%+ above market average
economy:
tax-rate: 0.05 # 5% posting tax (non-refundable)
min-deposit-fraction: 0.10 # Worker must deposit at least 10% per session
failure:
fine-percentage: 0.10 # Worker fined 10% of order value on expiry
payout-modifier: 0.50 # Worker gets 50% of delivered value on failure
cancellation:
worker-payout-modifier: 1.50 # Worker gets 150% of pro-rata on buyer cancel
cancellation-block-threshold: 0.50 # Buyer can't cancel after 50% delivered
trust:
max-strikes-before-cooldown: 3
cooldown-duration-hours: 24
strike-decay-days: 30 # Strikes older than 30 days are ignored
timer:
inactivity-nudge-threshold-hours: 1 # Hours before buyer can nudge worker
nudge-cooldown-minutes: 30 # Cooldown between nudges
? Requirements
- Minecraft: 1.21+
- Server: Paper, Spigot, or Purpur
- Dependencies: Vault + any economy plugin (EssentialsX, CMI, etc.)
- Storage: SQLite (built-in, no setup required)
?️ Roadmap
- Admin inspect command — view any player's orders and trust score
- Price negotiation system
- Order watchlist — get notified when new orders for your favourite materials are posted
- PlaceholderAPI support
- Multi-language support
Donate (optional)
If you enjoy my work and want to support development:
Donate via PayPal ?
? Official Support & Community
Need help with this plugin?
Join the official Marbzy Discord server for:
- ? Direct plugin support (ticket system)
- ? Bug reports
- ? Feature suggestions
- ? Beta testing access
- ? Update announcements
? Join the Discord
Developed by Marbzy
评论 0
登录后参与评分
还没有评论,来抢沙发吧