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

1. 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.
2. The order appears on the market for everyone else to see.
3. 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.
4. The buyer collects delivered items from their own order screen whenever they like.
5. 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