Donut Orders

<p align="center"> <img src="https://raw.githubusercontent.com/Fuzss/modresources/main/pages/commons/headers/about.png" alt="About"> </p> <p align="center"> <img src="https://i.imgur.com/MPFRlrF.png" alt="DonutOrders Marketplace" width="400"> </p> <p align="center"> <a href="https://nightbeam.dev/support"> <img src="https://i.imgur.com/R9eqHGA.png" alt="Support Nightbeam Studio" width="400"> </a> </p> <p align="center"> <strong>DonutOrders</strong> is a standalone buy-order marketplace plugin for Paper and Folia servers running Minecraft 1.20+. Players can post orders for items they want to buy, escrow the required funds automatically, and let other players fulfill those orders for instant payment. No chest shops and no admin-created marketplace are required — everything is handled through a clean GUI with Vault-compatible economy integration. </p> <p align="center"> <a href="https://discord.gg/TJc3CxR4jK"> <img src="https://img.shields.io/static/v1?label=&message=Discord&color=ECEBE6&labelColor=2F4858&style=for-the-badge&logo=discord&logoColor=white" alt="Discord"> </a> <a href="https://www.youtube.com/@nightbeamstudio"> <img src="https://img.shields.io/static/v1?label=&message=YouTube&color=ECEBE6&labelColor=2F4858&style=for-the-badge&logo=youtube&logoColor=white" alt="YouTube"> </a> <a href="https://github.com/MeherBenSalem"> <img src="https://img.shields.io/static/v1?label=&message=GitHub&color=ECEBE6&labelColor=2F4858&style=for-the-badge&logo=github&logoColor=white" alt="GitHub"> </a> <a href="https://www.curseforge.com/members/nightbeamstudio/projects"> <img src="https://img.shields.io/static/v1?label=&message=CurseForge&color=ECEBE6&labelColor=2F4858&style=for-the-badge&logo=curseforge&logoColor=white" alt="CurseForge"> </a> <a href="https://modrinth.com/organization/nightbeam"> <img src="https://img.shields.io/static/v1?label=&message=Modrinth&color=ECEBE6&labelColor=2F4858&style=for-the-badge&logo=modrinth&logoColor=white" alt="Modrinth"> </a> </p> # Features | Feature | Description | | --- | --- | | Player Buy Orders | Players can create public buy orders for allowed materials with custom quantities and prices | | Escrow System | Funds are withdrawn when an order is created so buyers cannot spend money already committed to an order | | Marketplace Browser | Sellers can browse active orders through a clean paginated GUI | | Instant Seller Payments | Sellers receive payment immediately when valid items are delivered | | Partial Order Fills | Orders can be fulfilled gradually by one or multiple deliveries | | Virtual Stash | Purchased items are stored safely until the buyer is ready to collect them | | Vault Economy Support | Works with Vault-compatible economy plugins such as EssentialsX, CMI, and other supported providers | | Configurable Tax | Optional seller payout tax can be used as an economy sink | | SQLite & HikariCP | Persistent local SQLite storage with HikariCP connection management | | Paper & Folia Support | Designed for modern Paper and Folia servers with region-aware scheduling | | Async Database Operations | Database reads and writes are handled asynchronously to avoid blocking server threads | | Customizable Experience | Configure order limits, expiry duration, allowed materials, messages, colors, and marketplace behavior | <p align="center"> <a href="https://builtbybit.com/creators/nightbeamstudio.617578/"> <img src="https://i.imgur.com/IeI5PsC.png" alt="Upgrade to Premium" width="350"> </a> </p> # How It Works DonutOrders creates a player-driven marketplace centered around **buy orders** rather than traditional chest shops or item listings. The process is simple: 1. **Buyer** opens `/orders`, selects **New Order**, chooses an item, and enters the quantity and price-per-unit through chat prompts. 2. The required funds are immediately placed into escrow. 3. **Sellers** browse active orders, select one, and deliver matching items through the delivery GUI. 4. Sellers are paid instantly for accepted items. 5. Purchased items are stored in the buyer's personal stash until collected. 6. Unfilled orders expire automatically after the configured duration, refunding any remaining escrow balance. # Buyer Experience Buyers can create and manage orders directly through the GUI. ## Buyer Features * Post buy orders for materials allowed by the server * Choose the desired quantity * Set a price per item * Track Active, Completed, Expired, and Cancelled orders * View order progress and remaining quantity * Cancel active orders * Receive exact refunds for unspent escrow funds * Collect delivered items from a personal virtual stash * Keep delivered items safe even when the player's inventory is full When collecting stash items, anything that cannot fit in the player's inventory is safely dropped at their feet. # Seller Experience Sellers can browse active demand across the server and fulfill orders without creating