DonutOrders - The Ultimate Player-Driven Marketplace


Supercharge your server's economy! DonutOrders is a complete, professional, and intuitive marketplace plugin inspired by the most popular SMP. It allows your players to create public buy orders for any item they want, at any price they're willing to pay.

This creates a living, dynamic economy where grinders, farmers, and miners can instantly sell their loot to active orders, and builders or buyers can get the exact materials they need without waiting.



✨ Key Features

• Create Public Buy Orders: Players can request any item, any amount, and set their own price.
  
  
• Instant Fulfilling: Sellers can browse the market and instantly sell their items to any active order for an immediate payout.
  
  
• Virtual Collection Stash: Delivered items go into a private, 6-row (54-slot) virtual chest for the buyer. No more clogged inventories! Buyers can collect their items whenever they want.
  
  
• ️ Safe 3-Step Delivery: A dedicated GUI system to prevent mistakes.
  
  1. Click Order: Opens the "Deliver Items" chest.
     
     
  2. Deposit Items: The player adds their items. The GUI rejects any wrong items.
     
     
  3. Confirm: A final "Confirm Delivery" menu shows the total payout before they commit.
     
• Full Order Management: A clean "Your Orders" menu where buyers can:
  
  • View all their active orders.
    
    
  • [Collect] items from their private stash.
    
    
  • [Cancel] an order for a full refund of the remaining money and any collected items.
    
• Easy Chat-Based Input: No clunky signs! Players set their desired amount and price by simply typing it in chat.
  
  
• Smart Number Formatting: Automatically formats large numbers (e.g., 1,000 -> 1K, 1,000,000 -> 1M, 21,500,000,000 -> 21.5B) for a clean, professional look.
  
  
• ⏳ Order Expiry: All orders show a countdown timer (e.g., "6d 18h 10m") and expire after a set time to keep the market fresh.
  
  
• ✨ Clean UI: Hides all distracting item attributes (like +4 Armor) for a beautiful, minimalist lore display.
  
  
• Fully Configurable: All GUI titles, messages, and settings can be changed in the config.yml and messages.yml files.
  
  
• Vault Integration: Hooks directly into any Vault-supported economy plugin.
  

How It Works: A Player's Guide




For Buyers ️ (Creating an Order):

1. Type /orders and click the "Your Orders" chest.
   
   
2. Click the "New Order" paper.
   
   
3. Click "Item" to select the material you want to buy.
   
   
4. Click "Amount", then type the total quantity you need in chat.
   
   
5. Click "Price", then type the price-per-item you are offering in chat.
   
   
6. Click "Confirm". Your money is taken, and the order is now public!
   

For Sellers ‍ (Fulfilling an Order):

1. Type /orders to see all public requests.
   
   
2. Click the order you want to sell to (e.g., "1K Bones for $29K").
   
   
3. The "Deliver Items" GUI opens. Place your items (e.g., Bones) into the chest.
   
   
4. Press ESC to close the GUI.
   
   
5. The "Confirm Delivery" GUI automatically opens, showing your total payout.
   
   
6. Click "Confirm"... Instant Payout!
   

For Buyers (Collecting Your Items):

1. Type /orders and click "Your Orders".
   
   
2. Click on your order (e.g., "Your Order: Bones").
   
   
3. Click the "COLLECT" chest.
   
   
4. A 6-row stash opens. Take your items out!
   
   
5. Any items you leave in the stash will be saved for later.