📦 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