Donut Auctions & Orders

# DonutOrdersAuction

**A lightweight Auction House and Player Orders plugin for Minecraft Paper servers.**

DonutOrdersAuction brings two trading systems together in one plugin. Players can list items for sale through the Auction House or create buy orders for items they need, allowing other players to fulfil those orders for money.

Designed for economy and survival servers, with configurable settings, simple inventory menus and SQLite storage.

### Features

## Auction House
- List items for sale using `/ah sell <price>`.
- Browse and purchase items listed by other players.
- Search and filter auction listings.
- Manage your own listings.
- Configurable listing limits and expiration times.
- Reclaim expired auction items.

### Player Orders
- Create buy orders for items you want to purchase.
- Choose the item, quantity and price per item.
- Other players can deliver the requested items to earn money.
- Supports partial fulfilment of larger orders.
- Payments are handled through your server's economy.
- Collect completed orders in batches.
- Collected items drop onto the ground, making them useful for hopper-based storage systems and farms.
- Configurable order limits, prices and expiration times.

### Additional Features
- Inventory-based menus.
- SQLite database storage.
- Vault economy integration.
- Transaction records and recovery checks.
- Marketplace maintenance mode.
- Admin commands for managing and diagnosing marketplace issues.
- Configurable settings through `config.yml`.

## Dependencies

**Required:**
- **Paper** — The plugin is developed for Paper-based Minecraft servers.
- **Vault** — Used to connect the marketplace to your server's economy.
- **A Vault-compatible economy plugin** — Such as EssentialsX Economy, to provide player balances and handle payments.

**Optional:**
<details>
<summary>Spoiler</summary>

</details>

- **PlaceholderAPI** — Optional integration.
- **LuckPerms** — Optional permission management. Bukkit permissions are also supported.

**Database:** SQLite is used by default. The plugin declares its SQLite JDBC library automatically, so no separate SQLite plugin is normally required.

## Commands

| Command | Description |
|---|---|
| `/ah` | Open the Auction House |
| `/ah sell <price>` | List the item you're holding |
| `/ah mine` | View your own listings |
| `/ah search <item>` | Search auction listings |
| `/orders` | Open Player Orders |
| `/ahclaim` | Reclaim expired auction items |
| `/ahmaintenance` | Manage marketplace maintenance mode (admin) |
| `/ahescrow` | Inspect unresolved auction transactions (admin) |

## Installation

1. Install Paper on your Minecraft server.
2. Install Vault and a compatible economy plugin.
3. Download DonutOrdersAuction and place the JAR inside your server's `plugins` folder.
4. Restart the server.
5. Edit `plugins/DonutOrdersAuction/config.yml` to customise the marketplace.

## Compatibility

- **Server software:** Paper
- **Minecraft:** Declares API version 1.20; compatibility with individual newer versions should be verified.
- **Economy:** Vault
- **Storage:** SQLite

## Important Notes

Player Orders uses batch-based collections to handle larger quantities. Items are dropped at the player's location rather than being inserted into their inventory.

Ground items follow normal Minecraft behaviour, including despawning and being collected by hoppers or other players.

Back up your server before updating the plugin and test economy transactions before using it on a production server.

---

**Developed by PRNTR**

Copyright © 2026 PRNTR. All rights reserved.

Redistribution, resale and modification rights are governed by the included LICENSE.txt. Applicable copyright exceptions remain unaffected.