NEXAAUCTIONS
Advanced Auction House for Paper, Purpur and Folia Servers
BIN listings • Timed bidding • Bulk sales • SQL storage • Redis-ready networking • Folia support • Recovery tools • Configurable GUIs
━━━━━━━━━━━━━━━━━━━━
A COMPLETE AUCTION ECONOMY LAYER
━━━━━━━━━━━━━━━━━━━━
NexaAuctions is a premium auction house plugin built for modern Paper, Purpur and Folia server environments.
It is designed for server owners who need more than a basic marketplace GUI. NexaAuctions combines a polished player trading experience with SQL-backed storage, configurable menus, economy controls, recoverable transactions, staff tools and developer extension surfaces.
Players can browse the market, create listings, buy fixed-price items, place timed bids, sell stacked items, claim deliveries and review their activity through clear GUI flows.
Administrators can inspect storage and network health, review logs, detect suspicious transactions, recover items, retry payouts, manage the auction cache and migrate data through dedicated commands and runtime staff menus.
━━━━━━━━━━━━━━━━━━━━
PLATFORM SUPPORT
━━━━━━━━━━━━━━━━━━━━
✓ Paper support
✓ Purpur support
✓ Folia support
✓ Folia-aware scheduler layer
✓ Java 25 target
✓ Paper and Purpur 1.21.x–26.1.x product target
✓ Configurable YAML-based setup
✓ Single-server and network-ready deployment options
NexaAuctions uses a scheduler-aware architecture so server operations can be handled correctly across standard Paper-style runtimes and Folia environments.
━━━━━━━━━━━━━━━━━━━━
MAIN FEATURES
━━━━━━━━━━━━━━━━━━━━
✓ BIN fixed-price listings
✓ Timed bidding auctions
✓ Bulk BIN listings for stacked items
✓ Optional partial amount trading module
✓ 26 configurable YAML GUI menus
✓ SQLite, MySQL and MariaDB storage
✓ SQLite WAL support for reliable local setups
✓ SQL-authoritative network architecture
✓ Redis heartbeat, cache invalidation and distributed lock helpers
✓ Mailbox deliveries and item recovery workflows
✓ Seller payout retry queue
✓ Admin logs and suspicious transaction views
✓ Configurable currencies, taxes, fees, categories and limits
✓ TPS, ping, cooldown, world and item-rule protections
✓ PlaceholderAPI, Discord webhook and LuckPerms surfaces
✓ Public API and lifecycle events
✓ Migration tools with preview and rollback workflows
━━━━━━━━━━━━━━━━━━━━
THREE AUCTION STYLES
━━━━━━━━━━━━━━━━━━━━
BIN LISTINGS
Players can list an item for a fixed price. Another player can purchase it directly through the market GUI or command flow.
Purchase confirmation, economy checks, configured taxes, mailbox fallback, seller payout and transaction logging are handled by the plugin.
TIMED BIDDING
Players can create timed auctions with a starting price.
New bids must respect the configured minimum increment. Previous bidders can be refunded automatically, bids are stored and the winning bidder receives the item when the auction expires.
BULK BIN LISTINGS
Stacked items can be listed as bulk sales.
By default, the complete listed stack is purchased as a single transaction. An optional amount-trading module can be enabled when partial quantity purchases are needed.
Price inputs support shorthand values such as k, m, b and t.
Duration inputs support seconds, minutes, hours, days and weeks.
━━━━━━━━━━━━━━━━━━━━
CONFIGURABLE GUI EXPERIENCE
━━━━━━━━━━━━━━━━━━━━
NexaAuctions includes a Triumph GUI powered menu system backed by 26 separate YAML files.
Players can browse listings, search the market, filter categories, change sorting modes, create auctions, confirm purchases, place bids, claim deliveries, inspect their profile and review transaction history through clear menu flows.
Included menu surfaces:
✓ Main auction browser
✓ Categories
✓ Auction details
✓ Create auction flow
✓ Duration selector
✓ Currency selector
✓ Price editor
✓ Purchase confirmation
✓ Bid confirmation
✓ Player profile
✓ Active listings
✓ Active bids
✓ Purchases
✓ Sold items
✓ Expired items
✓ Deliveries
✓ Transaction history
✓ Statistics
✓ Shulker preview
✓ Admin overview
✓ Admin logs
✓ Suspicious transactions
✓ Recovery tools
✓ Player listing inspection
✓ Network status
✓ Performance status
The live marketplace includes pagination, market-type filters, category counts, free-text search and sorting options such as newest, oldest, highest price, lowest price, ending soon and most bids.
━━━━━━━━━━━━━━━━━━━━
SAFE AND RECOVERABLE TRANSACTIONS
━━━━━━━━━━━━━━━━━━━━
Item and currency movement should never feel fragile.
NexaAuctions models auction actions around controlled state transitions, transaction checks and recovery paths. Purchase, bid, expiration, cancellation and claim flows are designed to reduce duplicate actions and invalid listing movement.
✓ Mailbox returns for purchased, expired or cancelled items
✓ Winning bidder delivery claims
✓ Offline-safe item handling
✓ Payout retry queue when an economy provider is temporarily unavailable
✓ Duplicate transaction protection
✓ Auction and claim lock helpers
✓ Deleted item recovery paths
✓ Integrity checks for pending auctions and stale transactions
✓ Ghost listing cleanup tools
✓ Transaction and staff action logs
If a player inventory is full, claimable items remain safely stored instead of being lost.
━━━━━━━━━━━━━━━━━━━━
SQL STORAGE AND REDIS-READY NETWORKING
━━━━━━━━━━━━━━━━━━━━
NexaAuctions supports different deployment models for different server sizes.
SINGLE-SERVER SETUP
SQLite is available out of the box with WAL enabled for improved local reliability.
PRODUCTION STORAGE
MySQL and MariaDB are available for larger servers and network deployments.
NETWORK HELPERS
Redis can provide heartbeat events, cache invalidation signals and distributed lock helpers while SQL remains the authoritative source of auction data.
Network health information can expose the active mode, server identity, known servers, Redis channel and latest reported error.
Recommended for networks:
Configure MySQL or MariaDB first, then enable Redis helpers and validate purchase and claim flows in your staging environment before launch.
━━━━━━━━━━━━━━━━━━━━
FOLIA SUPPORT
━━━━━━━━━━━━━━━━━━━━
NexaAuctions includes Folia support through a scheduler-aware runtime layer.
The plugin separates standard scheduler behavior from Folia-aware execution paths so auction operations, menu actions, background tasks and administrative flows can run correctly in Folia environments.
This makes NexaAuctions suitable for server owners who want a modern auction platform without limiting their runtime choice to traditional Paper-based scheduling.
━━━━━━━━━━━━━━━━━━━━
CURRENCIES, FEES AND LIMITS
━━━━━━━━━━━━━━━━━━━━
NexaAuctions provides economy surfaces for:
✓ Vault
✓ PlayerPoints
✓ YAML economy
✓ XP levels
✓ Item-backed currencies
Currency definitions can include permissions, minimum and maximum prices, auction-type-specific price limits, online requirements and auto-claim behavior.
The fee system can cover:
✓ Listing fees
✓ Sale taxes
✓ Purchase taxes
✓ Bid fees
✓ Cancellation fees
✓ Duration fees
✓ Price-range fees
✓ Category fees
✓ Currency fees
✓ Item-rule-based adjustments
✓ Permission-based reductions
Seller-side, buyer-side, both-side and disabled tax modes can be configured where applicable.
Rank-based benefits such as VIP or elite tax reductions can also be configured through permissions.
━━━━━━━━━━━━━━━━━━━━
RULES AND ABUSE PROTECTION
━━━━━━━━━━━━━━━━━━━━
NexaAuctions includes practical controls for protecting your server economy.
✓ Action cooldowns
✓ TPS guards
✓ Ping guards
✓ World restrictions
✓ Active listing limits
✓ Active bid limits
✓ Category caps
✓ Minimum and maximum prices
✓ Duration limits
✓ Expensive listing confirmation
✓ Suspicious price thresholds
✓ Item blacklist and whitelist modes
✓ Nested shulker and container inspection
The item-rule engine can match materials, names, lore, enchantments, custom model data, persistent data keys and custom item contexts.
Composite and / or / not rules can be reused for listing validation, categories and fee matching.
━━━━━━━━━━━━━━━━━━━━
STAFF OPERATIONS AND RECOVERY TOOLS
━━━━━━━━━━━━━━━━━━━━
NexaAuctions gives administrators more than a reload command.
Staff can inspect live auction operations, investigate unusual activity and recover problematic items through dedicated commands and runtime GUI views.
✓ Staff overview menu
✓ Storage health reports
✓ Network health reports
✓ Integration status
✓ Debug information
✓ Integrity checks
✓ Ghost listing cleanup
✓ Admin action logs
✓ CSV and JSON exports
✓ Suspicious transaction views
✓ Player auction statistics
✓ Listing cancellation
✓ Deleted item recovery
✓ Mailbox recovery
✓ Performance timings
✓ Cache status, rebuild and clear actions
✓ Migration scan, preview, import and rollback workflows
These tools are useful when handling support tickets, reviewing economy issues or preparing your market before launch.
━━━━━━━━━━━━━━━━━━━━
INTEGRATIONS
━━━━━━━━━━━━━━━━━━━━
NexaAuctions provides optional integration surfaces without forcing unnecessary dependencies.
✓ PlaceholderAPI
✓ Discord webhooks
✓ Vault
✓ PlayerPoints
✓ LuckPerms
✓ LiteBans
✓ AdvancedBan
✓ Custom item resolver registry
✓ Bukkit ServicesManager API
✓ Auction lifecycle events
✓ Economy provider registration
✓ Cluster bridge access
Discord webhook events can cover listing creation, purchases, sales, cancellations, bids and recoveries.
The custom item resolver registry provides extension surfaces for popular item ecosystems such as ItemsAdder, Oraxen, Nexo, MMOItems and EcoItems.
━━━━━━━━━━━━━━━━━━━━
DEVELOPER API AND EVENTS
━━━━━━━━━━━━━━━━━━━━
Developers can integrate external plugins through the public NexaAuctions API.
The API surface includes auction lookup, queries, listing creation, fake auction creation, purchases, bids, cancellation, claims, economy registration, custom item resolver registration and cluster bridge access.
Available event surfaces cover:
✓ Auction creation
✓ Purchase
✓ Bid
✓ Cancellation
✓ Expiration
✓ Claim
✓ Recovery
✓ Preview
✓ Price calculation
✓ Item validation
━━━━━━━━━━━━━━━━━━━━
COMMON PLAYER COMMANDS
━━━━━━━━━━━━━━━━━━━━
/ah
Open the main auction menu.
/ah browse
Browse active listings.
/ah sell
Open the listing creation GUI.
/ah sell
Create a quick BIN listing.
/ah sell <bin|normal|bulk> [amount] [duration]
Create a specific auction type.
/ah buy [amount] [confirm]
Purchase a BIN or bulk listing.
/ah bid
Place a bid.
/ah search
Search the market.
/ah category
Open category filters.
/ah profile
Open player profile shortcuts.
/ah deliveries
Open winning bid deliveries.
/ah claim
Claim mailbox items.
/ah history
View transaction history.
/ah stats
View personal statistics.
━━━━━━━━━━━━━━━━━━━━
COMPATIBILITY
━━━━━━━━━━━━━━━━━━━━
✓ Java 25
✓ Paper support
✓ Purpur support
✓ Folia support
✓ Paper and Purpur 1.21.x–26.1.x product target
✓ SQLite, MySQL and MariaDB
✓ Redis-ready network helpers
✓ Triumph GUI powered menus
✓ Configurable YAML files
✓ PlaceholderAPI surfaces
✓ Discord webhook surfaces
✓ Public API and lifecycle events
━━━━━━━━━━━━━━━━━━━━
BUILD A CLEANER PLAYER ECONOMY
━━━━━━━━━━━━━━━━━━━━
Give players polished trading flows.
Keep auction data in reliable storage.
Run your market on Paper, Purpur or Folia.
Recover items when something goes wrong.
Tune your economy without editing code.
Inspect operational issues before they become support problems.
Extend the plugin through API events and provider surfaces.
NexaAuctions is built for servers that need more than a marketplace screen.
Advanced auctions.
Reliable storage.
Folia support.
Recoverable transactions.
