![\"logo\"](\"https:\/\/i.imgur.com\/f1XMMjn.png\")
\n<\/p>\n\n \n<\/p>\n
\n ![\"Orders\"](\"https:\/\/i.imgur.com\/MPFRlrF.png\")
\n<\/p>\n
\n
![\"logo\"](\"https:\/\/cdn.prod.website-files.com\/5c14e387dab576fe667689cf\/670f5a0171bfb928b21a7e00_support_me_on_kofi_beige.png\")
<\/p>\n
\n
<\/p>\n
<\/p>\n
<\/p>\n
<\/p>\n
<\/p>\n
Players post buy orders for items, other players fulfill them for instant payment. No chest shops. No admin setup. Just a clean GUI and automatic economy.<\/p>\n
—<\/p>\n
## How It Works<\/p>\n
1. **Buyer** opens `\/orders`, clicks **New Order**, picks an item, types the quantity and price-per-unit in chat.
\n2. Funds are escrowed immediately \u2014 the buyer can’t spend money they don’t have.
\n3. **Sellers** browse the public marketplace, pick an order, drop their items into the delivery GUI, and get paid on the spot.
\n4. If an order only partially fills, the buyer’s purchased items wait in a personal **stash** until they collect them.
\n5. Orders expire automatically after a configurable number of days \u2014 any unspent funds are refunded and any collected items stay in the stash ready to pick up.<\/p>\n
—<\/p>\n
## Features<\/p>\n
### Buyer Side
\n– **Post buy orders** for any material on the server’s allowed-materials list
\n– **Escrow system** \u2014 funds withdrawn on order creation, never double-spent
\n– **Order status tracking** \u2014 Active, Completed, Expired, or Cancelled
\n– **Virtual stash** \u2014 delivered items are stored safely server-side until you collect them, even if your inventory is full
\n– **Overflow protection** \u2014 stash items that don’t fit on collection are dropped at your feet
\n– **Cancel & refund** \u2014 cancel an active order at any time and receive the unspent balance back
\n– **Order detail view** \u2014 see progress, price, expiry, and stash status from a single GUI<\/p>\n
### Seller Side
\n– **Browse all active orders** in a paginated marketplace GUI
\n– **Delivery GUI** \u2014 dedicated 45-slot input grid; only the correct material is accepted
\n– **Wrong-item rejection** \u2014 the GUI refuses incompatible items immediately with a clear message
\n– **Partial fills** \u2014 deliver as many or as few items as you want; payment is per-item
\n– **Anti-duplication lock** \u2014 concurrent delivery attempts on the same order are serialized server-side
\n– **Excess item return** \u2014 any items beyond what the order needs are automatically returned to your inventory<\/p>\n
### Economy
\n– Powered by **Vault** \u2014 works with any Vault-compatible economy plugin (EssentialsX, CMI, etc.)
\n– Optional **configurable tax** applied to seller payouts as an economy sink (disabled by default)
\n– Refunds are always exact \u2014 no rounding errors<\/p>\n
### Admin & Configuration
\n– **`\/orders admin reload`** \u2014 hot-reload `config.yml` and `messages.yml` without a server restart
\n– Fully configurable **max orders per player**
\n– Configurable **order expiry duration** (days)
\n– Configurable **allowed materials list** \u2014 control exactly which items can be traded
\n– All player-facing strings in **`messages.yml`** \u2014 fully translatable, supports `&` color codes and `#RRGGBB` hex colors<\/p>\n
### Technical
\n– **Full Folia support** \u2014 all scheduling uses regionised entity\/global schedulers; also works on standard Paper\/Spigot
\n– **SQLite + HikariCP** \u2014 orders are persisted to a local database with WAL mode; no external database required
\n– Async database I\/O \u2014 DB reads and writes never block the main thread or region threads
\n– Shaded & relocated dependencies \u2014 no classpath conflicts with other plugins<\/p>\n
—<\/p>\n
## Commands<\/p>\n
| Command | Description | Permission |
\n|—|—|—|
\n| `\/orders` | Open your orders (aliases: `\/order`, `\/market`) | `donutorders.use` |
\n| `\/orders admin reload` | Reload config and messages | `donutorders.admin` |<\/p>\n
—<\/p>\n
## Permissions<\/p>\n
| Permission | Default | Description |
\n|—|—|—|
\n| `donutorders.use` | Everyone | Use `\/orders` and all GUI features |
\n| `donutorders.admin` | OP | Access admin sub-commands |<\/p>\n
—<\/p>\n
## GUI Overview<\/p>\n
| Screen | Purpose |
\n|—|—|
\n| **Your Orders** | View your own buy orders, check status and stash, cancel orders |
\n| **New Order** | Pick an item, set amount and price via chat prompts |
\n| **Browse Market** | Paginated list of all active orders posted by any player |
\n| **Deliver Items** | 45-slot grid to drop items into for a chosen order |
\n| **Confirm Delivery** | Review the delivery before it is processed |
\n| **Order Detail** | Full info on one of your own orders with cancel and collect options |
\n| **Collect Stash** | Take all delivered items out of your virtual stash |<\/p>\n
—<\/p>\n
## Configuration<\/p>\n
“`yaml
\norders:
\n max-per-player: 10 # Max simultaneous active orders per player
\n default-expiry-days: 7 # Days before an unfilled order expires
\n tax-percent: 0.0 # % of seller payout taken as economy sink (0 = off)<\/p>\n
database:
\n filename: donutorders.db # SQLite file in the plugin’s data folder<\/p>\n
allowed-materials:
\n – DIAMOND
\n – EMERALD
\n – GOLD_INGOT
\n – IRON_INGOT
\n – NETHERITE_INGOT
\n – COAL
\n – LAPIS_LAZULI
\n – REDSTONE
\n – QUARTZ
\n – AMETHYST_SHARD
\n – GLOWSTONE_DUST
\n – BLAZE_ROD
\n – ENDER_PEARL
\n – GHAST_TEAR
\n – NETHER_STAR
\n – ELYTRA
\n – TOTEM_OF_UNDYING
\n – SHULKER_SHELL
\n – HEART_OF_THE_SEA
\n – TRIDENT
\n – OAK_LOG
\n # … and any other Bukkit Material name
\n“`<\/p>\n
—<\/p>\n
## Requirements<\/p>\n
| Requirement | Version |
\n|—|—|
\n| Paper \/ Folia | 1.20+ |
\n| Java | 17+ |
\n| Vault | Any compatible release |
\n| Economy plugin | EssentialsX, CMI, or any Vault economy |<\/p>\n
—<\/p>\n
## Installation<\/p>\n
1. Drop `DonutOrders-1.0.0.jar` into your `plugins\/` folder.
\n2. Make sure **Vault** and an economy plugin are installed.
\n3. Start the server \u2014 `config.yml` and `messages.yml` are generated automatically.
\n4. Edit `allowed-materials` and other options, then run `\/orders admin reload`.<\/p>\n
—<\/p>\n
## Support & Source<\/p>\n
Open an issue or pull request on the project repository.<\/p>\n
\n
![\"BisectHosting](\"https:\/\/www.bisecthosting.com\/partners\/custom-banners\/db9c3eef-25e8-4ac0-93b6-bf386644dcef.webp\")
<\/p>\n","protected":false},"excerpt":{"rendered":"
A player-driven buy-order marketplace.<\/p>\n","protected":false},"featured_media":58221,"template":"","meta":{"_minecraft_slug":"donut-orders","_minecraft_project_id":"Tu41GNf3","_minecraft_author":"NAIZO","_minecraft_license":"LicenseRef-All-Rights-Reserved","_minecraft_downloads":2112,"_minecraft_follows":2,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"donut-orders.zip","_minecraft_size_bytes":27539536,"_minecraft_version_count":2,"_minecraft_updated_at":"2026-05-16T06:19:38.071012Z","_minecraft_date_created":"2026-04-15T22:48:26.367752Z","_minecraft_date_modified":"2026-05-03T08:49:36.220001Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/donut-orders","_minecraft_icon_attachment_id":58221,"_minecraft_imported_at":"2026-06-03T04:48:18+00:00","_minecraft_import_hash":"60e345575cef16e11893d7193c9fc5e4","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,844,125,873,126,127,128,129,91,92],"mod_loader":[130,131,132,133,134],"minecraft_version":[59,36,60,93,94,101,102,62,37,40,41,73,74,38,78,79,80,81,82,83,167,163],"class_list":["post-58220","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-bukkit","mod_category-economy","mod_category-folia","mod_category-library","mod_category-management","mod_category-paper","mod_category-purpur","mod_category-spigot","mod_category-storage","mod_category-utility","mod_loader-bukkit","mod_loader-folia","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","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","minecraft_version-26-1","minecraft_version-26-1-1","minecraft_version-26-1-2"],"yoast_head":"\n