xAuctions is a high-performance, cross-platform auction house plugin for Folia and Paper. It provides a fully asynchronous marketplace where players can safely list, browse, search, purchase, cancel, and manage items with multi-currency support, network-ready storage, anti-duplication protections, and a public developer API.

Features

Auction Marketplace

Players can:

• Instantly list items through commands or the GUI
• Browse auctions using /ah or configured aliases
• Purchase items through an instant Buy-It-Now system
• Cancel listings and safely retrieve items
• Receive items back when auctions expire
• Manage their own auctions
• Receive instant sale notifications

Listings can display the item name, quantity, enchantments, price, seller, and expiration.

Special-item support includes shulker boxes, enchanted items, custom items, and damaged items.

Screenshots

Search & Filtering

Search auctions by:

• Item name
• Seller
• Item type

Partial-match searching is supported, along with configurable price formatting and transparent marketplace pricing.

Economy & Currency

Supported integrations:

• Vault
• PlayerPoints
• TokenManager

Vault-compatible providers can include EssentialsX, CMI, UltraEconomy, and other compatible economies.

Economy features include:

• Automatic economy detection
• Multi-currency support
• Multi-currency earnings management
• Secure earnings collection
• Configurable listing fees
• Configurable sales tax
• Real-time minimum and maximum price validation

Player Management

The My Auctions dashboard covers:

• Active listings
• Sold listings
• Expired listings
• Cancelled listings

Additional controls include permission-based listing limits, VIP/Premium/Unlimited tiers, configurable listing durations, pre-listing limit enforcement, player blacklists, and instant sale notifications.

Security & Anti-Duplication

Protection includes:

• Smart item blacklisting
• Item validation before listing
• Anti-duplication protection
• Transaction locking
• Atomic operations
• Creative-mode restrictions
• Inventory validation
• Thread-safe high-concurrency operations
• Asynchronous retry logic
• Validated transactions

Storage & Database

SQL backends support HikariCP connection pooling.

Storage functionality also includes multi-server synchronization, unified network marketplaces, backend migration tools, automatic JSON and SQL backups, auction cleanup, graceful shutdown saving, and flexible backend configuration.

Multi-Server Networks

SQL storage can synchronize auction data across multiple servers, allowing a network to operate a unified marketplace.

Configuration & Administration

config.yml controls settings such as:

• Economy configuration
• Listing durations
• Listing fees
• Sales taxes
• Creative-mode restrictions
• Damaged-item rules
• Broadcast notifications
• Storage backend

messages.yml provides customizable plugin messages.

Administrative functionality includes configuration reloads, debugging, removing player auctions, item and player blacklist management, logging, debug mode, and automatic update checks.

Permissions can control plugin usage, selling, buying, administration, fee exemptions, and listing limits.

Integrations

• PlaceholderAPI
• Discord webhooks
• Vault
• PlayerPoints
• TokenManager
• SQL-backed multi-server networks

Notifications

• New-listing broadcasts
• Completed-sale broadcasts
• Instant seller notifications
• Discord webhook notifications
• Configurable notification messages

Developer API

AuctionService

Supports:

• Creating auctions
• Purchasing auctions
• Cancelling auctions
• Collecting auctions

EconomyService

Supports:

• Multi-currency handling
• Balance checks
• Transactions

Events

• AuctionCreateEvent
• AuctionBuyEvent
• AuctionCancelEvent
• AuctionExpireEvent

The API also provides auction model access, builder support, success/failure result handling, thread-safe asynchronous operations, and a developer-friendly architecture.

Performance & Reliability

xAuctions includes:

• Fully asynchronous database operations
• Fully asynchronous file operations
• Folia-compatible region-threaded architecture
• Full Paper support
• Modular async-first architecture
• High-concurrency thread safety
• Production-ready backups and logging
• Graceful error handling
• Asynchronous retry logic
• Unified marketplace synchronization

Why Choose xAuctions?

1. Folia & Paper — Designed for both modern server environments.
2. Async Marketplace — Database and file operations are fully asynchronous.
3. Multi-Currency — Vault, PlayerPoints, TokenManager, and multiple earnings currencies.
4. Flexible Storage — JSON, SQLite, MySQL, MariaDB, and PostgreSQL.
5. Network Ready — SQL storage supports synchronized multi-server marketplaces.
6. Security Focused — Atomic transactions, locking, validation, and anti-duplication protections.
7. Player-Friendly — Clean GUI, search, filters, and My Auctions management.
8. Permission Tiers — VIP, Premium, Unlimited, fee exemptions, and listing limits.
9. Developer Friendly — Public services, events, models, builders, and async APIs.
10. Highly Configurable — Customize fees, taxes, durations, messages, restrictions, notifications, and storage.

Compatibility

• Paper
• Folia
• Vault
• PlayerPoints
• TokenManager
• PlaceholderAPI
• JSON
• SQLite
• MySQL
• MariaDB
• PostgreSQL
• Single-server installations
• Multi-server networks using SQL storage

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