DonutAuctionHouse 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.

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

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 storage option and is ideal for:

• Small servers
• Simple installations
• Servers that do not require an external database

It works out of the box without requiring separate database infrastructure.

MySQL

MySQL can be used for larger installations and server networks.

MySQL support includes:

• External database storage
• HikariCP connection pooling
• Better suitability for larger networks
• High-performance connection management

DonutCore Integration

DonutCore support is completely optional.

When DonutCore is installed:

• Player names in auction listings can use the network's display-name system
• Listings can better match the identity system used across the network

When DonutCore is not installed, DonutAuctionHouse continues working normally without errors or hard dependencies.

Performance & Safety

DonutAuctionHouse is designed to keep database work away from the main server thread.

The plugin includes:

• Asynchronous database operations
• Executor-based task handling
• Server-responsive storage access
• Safe cancellation behavior
• Protection against common duplication scenarios
• Architecture designed with modern Paper threading practices in mind

Development

DonutAuctionHouse uses a modern Java plugin architecture.

Technical details include:

• Java 17
• Maven build system
• Modular service architecture
• Dedicated storage layer
• GUI abstraction
• Optional hook system
• Shaded dependencies
• Namespaced dependencies to reduce plugin conflicts
• Codebase designed to be extended or forked for custom behavior

Configuration

DonutAuctionHouse is designed to be configurable for different server economies and marketplace styles.

Depending on the version, configurable options may include:

• Maximum auction price
• Listing duration
• Database type
• MySQL connection information
• Inventory titles
• Button names
• Messages
• Marketplace appearance

The interface uses neutral white text with gold headers for improved clarity.

Why Choose DonutAuctionHouse?

1. Easy Setup — Drop the plugin jar into your plugins folder, configure a few values, and use the default SQLite storage immediately.
2. Low Overhead — Lightweight architecture with shaded and namespaced dependencies helps avoid unnecessary plugin conflicts.
3. Player-Friendly UI — Inventory-based controls make listing, browsing, searching, and purchasing straightforward.
4. Robust & Safe — Built with duplication prevention, race-condition awareness, and asynchronous server performance in mind.
5. Flexible Integration — Suitable for both smaller servers and larger networks using Vault, MySQL, and optional DonutCore integration.
6. Extensible Foundation — Modular architecture makes it easier for developers and server owners to customize or expand the plugin.

Compatibility

• Paper
• Folia
• Minecraft 1.20+
• Vault-compatible economies
• SQLite
• MySQL
• Small standalone servers
• Larger server networks

Requirements

DonutAuctionHouse requires a supported Paper or Folia server.

For economy functionality, install:

• Vault
• A Vault-compatible economy plugin

DonutCore is optional and is only used for enhanced player display-name integration.

Community & Support

• Discord: https://discord.gg/TJc3CxR4jK
• GitHub: https://github.com/MeherBenSalem
• Website: https://nightbeam.dev
• Store: https://nightbeam.dev/store
• CurseForge: https://www.curseforge.com/members/nightbeamstudio/projects
• Modrinth: https://modrinth.com/organization/nightbeam

If you encounter a bug or have a feature request, please join the Discord community or report it through the appropriate project page.

License

Donut Auction is licensed under the Apache License 2.0.

You are free to use, modify, and redistribute Donut Auction in accordance with the terms of the Apache License 2.0.

Feel free to include Donut Auction in modpacks