Donut Auction

<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://cdn.modrinth.com/data/cached_images/28757d5361eb632ec38e204883e7e5a1645a5857.png" alt="DonutAuctionHouse Auction Browser" 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>DonutAuctionHouse</strong> is a standalone auction house plugin for Paper and Folia servers running Minecraft 1.20+. It provides a clean, intuitive GUI-powered marketplace where players can list, browse, search, and purchase items using any Vault-compatible economy. Optional DonutCore integration can also resolve player display names and improve the browsing experience across larger server networks. </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 | | --- | --- | | GUI Auction Browser | 54-slot inventory browser with pagination, sorting, category filters, refresh controls, search, and personal listings | | Player Auction Management | Players can view, cancel, collect, and manage their own active, sold, and expired listings | | Vault Economy Support | Compatible with Vault-backed economy plugins such as EssentialsX and other supported providers | | SQLite & MySQL Storage | Uses SQLite by default with optional MySQL support for larger server networks | | HikariCP Pooling | High-performance database connection pooling for MySQL-backed installations | | DonutCore Integration | Optional hook for resolving network display names without making DonutCore a hard dependency | | Async Database Operations | Storage operations run away from the main server thread to maintain responsiveness | | Paper & Folia Support | Designed for modern Paper and Folia server environments | | Modular Codebase | Java 17 and Maven-based architecture organized into services, storage, GUI, and hook layers | | Customizable Experience | Configurable pricing, listing duration, messages, titles, button names, and visual presentation | <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> # Auction Browser DonutAuctionHouse provides an inventory-based marketplace designed to be simple for players to understand and fast to navigate. The auction browser includes: * 54-slot inventory interface * Pagination for large auction inventories * Price sorting * Category filtering * Text search * Manual refresh controls * Personal listing access * Clear auction status information Players do not need to memorize complicated command syntax to browse and purchase items. # Player Auction Management Players can manage their own listings directly through the plugin. Supported listing states include: * Active auctions * Sold auctions * Expired auctions Players can: * View their current listings * Cancel active auctions * Collect items from expired listings * Track sold listings * Recover cancelled items immediately Cancellation logic is designed to return items safely while preventing duplication exploits. # Economy DonutAuctionHouse integrates with **Vault**, allowing it to work with Vault-compatible economy plugins. Features include: * Instant payment handling during purchases * Economy-backed listing transactions * Configurable maximum listing price * Configurable listing duration * Compatibility with common Vault economy providers such as EssentialsX A compatible Vault economy provider is required for monetary transactions. # Storage DonutAuctionHouse supports multiple storage options depending on the size of the server. ## SQLite SQLite is the default sto