# \ud83d\udce6 OrdersPro
\n### The Professional Buy Order & Contract System for Minecraft Servers<\/p>\n
> **Not an auction house. Not a shop. A job board.**
\n> Players post what they *need*, workers get paid to *deliver it.*<\/p>\n
OrdersPro is a fully-featured reverse marketplace plugin. Buyers post **Buy Orders** \u2014 “I need 5,000 Diamonds at $10 each” \u2014 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.<\/p>\n
Built from the ground up for performance, reliability, and a polished player experience.<\/p>\n
—<\/p>\n
## \ud83c\udfaf How It Works<\/p>\n
| Role | What They Do |
\n|——|————-|
\n| **Buyer** | Posts a buy order with item, quantity, price per unit, and funds escrowed upfront |
\n| **Worker** | Browses the market, accepts a contract, delivers items in sessions to earn payout |<\/p>\n
Unlike auction houses where sellers list items, **OrdersPro flips the model** \u2014 buyers drive demand, workers fulfill it. Perfect for large economies where players need bulk materials and don’t want to farm them themselves.<\/p>\n
—<\/p>\n
## \u2728 Features<\/p>\n
### \ud83c\udfea Market Board
\n– Scrollable, paginated market showing all open buy orders
\n– **Sort by Highest Price\/Unit** or **Newest First** with a single click
\n– Each order card shows buyer, quantity needed, unit price, total value, and time remaining
\n– Collection bin glows when you have items ready to pick up<\/p>\n
### \ud83d\udcdd Order Creation
\n– **Hybrid creation flow** \u2014 hold an item to skip the material picker entirely
\n– **Scrollable material picker GUI** with live chat search filter for empty-hand creation
\n– **Chat-based quantity and price input** with full validation (min\/max bounds from config)
\n– **Confirmation GUI** with full cost breakdown \u2014 escrow, tax, total charge, and live balance check
\n– **Price warning system** \u2014 if your price is 300%+ above market average, the confirm button turns red and requires a second click<\/p>\n
### \ud83e\udd1d Private Orders
\n– `\/order create @PlayerName` sends a directed contract to a specific player
\n– Target sees it in their dashboard and can accept or decline
\n– Same financial rules as public orders \u2014 full escrow, tax, penalties<\/p>\n
### \ud83d\udcca My Business Dashboard
\n– View all your posted orders with live progress bars, worker name, and time remaining
\n– **Nudge your worker** if they’ve gone inactive
\n– **Cancel orders** with proper penalty enforcement \u2014 blocked if worker is past 50% delivery
\n– View and manage your active worker contract
\n– Accept or decline incoming private orders<\/p>\n
### \ud83d\udcec Delivery System
\n– Workers open a **Delivery GUI** with +\/\u2212 quantity selectors
\n– Minimum deposit per session = 10% of total order (configurable)
\n– Live inventory preview shows exactly which item stacks will be consumed
\n– Auto-completes the order and pays out instantly when fully delivered<\/p>\n
### \ud83d\uddc3\ufe0f Collection Bin
\n– Items from completed orders go to a safe collection bin \u2014 never dropped on the ground
\n– **Collect All** button moves everything to your inventory atomically
\n– Overflow drops safely at your feet \u2014 nothing is ever lost<\/p>\n
### \ud83d\udcdc Order History
\n– Last 20 completed, cancelled, or expired orders per player
\n– Shows role (Buyer\/Worker), counterparty, outcome, amount earned\/spent, and date
\n– Fully read-only \u2014 an immutable ledger<\/p>\n
### \u2696\ufe0f Financial System
\n| Event | Result |
\n|——-|——–|
\n| Post order | Escrow + posting tax locked upfront |
\n| Cancel (no worker) | Full escrow returned, tax lost |
\n| Cancel (worker < 50%) | Worker paid pro-rata \u00d7 1.5x bonus from escrow |\n| Cancel (worker > 50%) | \u274c Blocked \u2014 cannot cancel |
\n| Order completed | Full escrow paid to worker |
\n| Worker abandons | 10% fine from worker \u2192 buyer, trust strike added |
\n| Order expires (no worker) | Full escrow returned to buyer |
\n| Order expires (worker failed) | Fine from worker \u2192 buyer, partial pay for delivered items |<\/p>\n
### \ud83d\udee1\ufe0f Trust System
\n– Workers accumulate **strikes** for abandoning or failing contracts
\n– Configurable max strikes before cooldown kicks in
\n– Configurable cooldown duration
\n– Strike decay \u2014 old strikes are ignored after a configurable number of days
\n– Players on cooldown see remaining time in their dashboard<\/p>\n
### \ud83d\udd04 Admin Tools
\n– `\/order reload` \u2014 reloads config.yml and refreshes the in-memory order cache from the database
\n– All financial constants fully configurable \u2014 no hardcoded values
\n– SQLite storage with WAL mode for performance and crash safety
\n– Startup\/shutdown logging with full order persistence on server stop<\/p>\n
—<\/p>\n
## \ud83c\udfae Commands<\/p>\n
| Command | Description | Permission | **Aliases:** `\/orders`, `\/market`, `\/contract`, `\/contracts`<\/p>\n —<\/p>\n ## \ud83d\udd10 Permissions<\/p>\n | Permission | Default | Description | —<\/p>\n ## \u2699\ufe0f Configuration<\/p>\n “`yaml orders: economy: failure: cancellation: trust: timer: —<\/p>\n ## \ud83d\udce6 Requirements<\/p>\n – **Minecraft:** 1.21+ —<\/p>\n ## \ud83d\uddfa\ufe0f Roadmap<\/p>\n – [ ] Admin inspect command \u2014 view any player’s orders and trust score —<\/p>\n ## Donate (optional) —<\/p>\n ## \ud83d\udcac Official Support & Community<\/p>\n Need help with this plugin?<\/p>\n Join the official **Marbzy Discord server** for:<\/p>\n – \ud83d\udee0 Direct plugin support (ticket system) \ud83d\udc49 **Join the Discord**<\/p>\n — The Professional Buy Order & Contract System for Minecraft Servers<\/p>\n","protected":false},"featured_media":117202,"template":"","meta":{"_minecraft_slug":"orderspro","_minecraft_project_id":"FV8SJRSQ","_minecraft_author":"Marbzy","_minecraft_license":"LicenseRef-All-Rights-Reserved","_minecraft_downloads":297,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"orderspro.zip","_minecraft_size_bytes":92537,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-16T11:55:29.503053Z","_minecraft_date_created":"2026-03-09T23:01:08.529415Z","_minecraft_date_modified":"2026-03-08T10:17:43.116595Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/orderspro","_minecraft_icon_attachment_id":117202,"_minecraft_imported_at":"2026-06-06T21:26:43+00:00","_minecraft_import_hash":"7b4483ccf0ea64c29aa91df049968a46","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[89,127,128,129,123,92],"mod_loader":[132,133,134],"minecraft_version":[62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-117201","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-game-mechanics","mod_category-paper","mod_category-purpur","mod_category-spigot","mod_category-technology","mod_category-utility","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n
\n|———|————-|————|
\n| `\/order` | Open the market board | `orderspro.use` |
\n| `\/order create` | Post a new buy order | `orderspro.use` |
\n| `\/order create @
\n| `\/order dashboard` | Open My Business (your orders & contracts) | `orderspro.use` |
\n| `\/order history` | View your last 20 orders | `orderspro.use` |
\n| `\/order reload` | Reload config and order cache | `orderspro.admin` |<\/p>\n
\n|————|———|————-|
\n| `orderspro.use` | Everyone | Access the market, dashboard, history |
\n| `orderspro.create` | Everyone | Post buy orders |
\n| `orderspro.work` | Everyone | Accept and fulfill contracts |
\n| `orderspro.private` | Everyone | Send and receive private orders |
\n| `orderspro.admin` | OP | All admin features (inherits all above) |
\n| `orderspro.admin.reload` | OP | Run `\/order reload` |
\n| `orderspro.admin.inspect` | OP | Inspect any player’s orders (future) |<\/p>\n
\nsettings:
\n currency-symbol: “$”
\n expiration-check-interval-seconds: 30 # How often expired orders are processed<\/p>\n
\n duration-hours: 48 # How long orders stay on the market
\n max-active-orders: 5 # Max orders a buyer can have posted at once
\n min-quantity: 1
\n max-quantity: 100000
\n min-price-per-unit: 0.01
\n max-price-per-unit: 1000000.0
\n price-warning-multiplier: 3.0 # Warn if price is 300%+ above market average<\/p>\n
\n tax-rate: 0.05 # 5% posting tax (non-refundable)
\n min-deposit-fraction: 0.10 # Worker must deposit at least 10% per session<\/p>\n
\n fine-percentage: 0.10 # Worker fined 10% of order value on expiry
\n payout-modifier: 0.50 # Worker gets 50% of delivered value on failure<\/p>\n
\n worker-payout-modifier: 1.50 # Worker gets 150% of pro-rata on buyer cancel
\n cancellation-block-threshold: 0.50 # Buyer can’t cancel after 50% delivered<\/p>\n
\n max-strikes-before-cooldown: 3
\n cooldown-duration-hours: 24
\n strike-decay-days: 30 # Strikes older than 30 days are ignored<\/p>\n
\n inactivity-nudge-threshold-hours: 1 # Hours before buyer can nudge worker
\n nudge-cooldown-minutes: 30 # Cooldown between nudges
\n“`<\/p>\n
\n– **Server:** Paper, Spigot, or Purpur
\n– **Dependencies:** Vault + any economy plugin (EssentialsX, CMI, etc.)
\n– **Storage:** SQLite (built-in, no setup required)<\/p>\n
\n– [ ] Price negotiation system
\n– [ ] Order watchlist \u2014 get notified when new orders for your favourite materials are posted
\n– [ ] PlaceholderAPI support
\n– [ ] Multi-language support<\/p>\n
\nIf you enjoy my work and want to support development:
\nDonate via PayPal \ud83d\udc96<\/p>\n
\n– \ud83d\udc1b Bug reports
\n– \ud83d\udca1 Feature suggestions
\n– \ud83e\uddea Beta testing access
\n– \ud83d\udce2 Update announcements<\/p>\n
\n*Developed by Marbzy*<\/p>\n","protected":false},"excerpt":{"rendered":"