MC Plugin zAuctionHouse 4.0.1.3

The most used auction house plugin in the world !

• Added ZAUCTIONHOUSE_SELL_LIMIT button - displays remaining sell slots visually using a list of inventory slots, configurable per item type (auction, bid, rent)
• Added %zauctionhouse_max_items_<type>% placeholder - returns the maximum number of items a player can list for a specific type (auction, bid, rent)
• Optimized item lore placeholder resolution, placeholders are now pre-detected at config load and only resolved when referenced, significantly reducing CPU and memory usage per item render
• Fixed /ah history stuck on "Loading..." when action.purchased-item.give-item: true is enabled
• Fixed default config values
• Fixed default table prefix to zauctionhousev4 (fixes compatibility with zAuctionHouse V3)
• %zauctionhouse_max_items_<type>% placeholder
• Returns the maximum number of items a player can list based on their permissions for the given type.

• %zauctionhouse_max_items_auction%
• %zauctionhouse_max_items_bid%
• %zauctionhouse_max_items_rent%

• Added zauctionhouse_category permissible for zMenu - allows conditional button visibility based on the player's currently selected category (defaults to main)
• Added ZAUCTIONHOUSE_CATEGORY_SWITCHER button - combines category cycling (left/right click) with dynamic lore showing enable/disable state per category
• Added %zauctionhouse_category_id% placeholder - returns the player's currently selected category ID
• Added ZAUCTIONHOUSE_HISTORY_INVENTORY button - opens the sales history inventory directly from any UI
• Added force-amount-one option in config.yml (item-lore section) - forces displayed item amount to 1 in the auction inventory while preserving the real amount internally
• Changed AuctionEconomy API - economy methods (get, has, deposit, withdraw) now accept UUID instead of OfflinePlayer for better compatibility
• Updated CurrenciesAPI dependency from 1.0.12 to 1.0.13
• Fixed category display name fallback - now uses the configured "all" category name instead of a hardcoded "All" string
• Fixed empty slot crash - list buttons (ListedItems, ExpiredItems, PurchasedItems, SellingItems) no longer crash when emptySlot is -1 and the list is empty
• Fixed history loading slot - HistoryItemsButton now properly handles loadingSlot set to -1 without throwing an error
• Fixed LoadingSlotLoader - added validation for invalid slot values with a clear error message

• Added Thai as a supported language
• Fixed support for Minecraft 1.20.4
• Fixed the /zauctionhouse command — it is no longer the default main command (this can be changed in config.yml)
• Fixed message system errors that could appear without reason
• Added the reset-category-on-open option, allowing categories to reset when reopening the inventory
• Added EXCELLENTEECONOMY economy support

zAuctionHouse V4 - Release Notes

What's New

zAuctionHouse V4 is a complete rewrite built for modern Minecraft servers (Paper 1.21+, Java 21).

Key Improvements

Performance

• Async-first architecture - All operations use CompletableFuture (non-blocking)
• Parallel sorting - Faster item list rendering
• FastUtil caching - Optimized per-player and global caches
• Database improvements - Repository pattern with Sarah ORM

Multi-Server Support

• Native cluster support - Built-in AuctionClusterBridge interface
• Distributed locking - Prevents duplicate purchases across servers
• Redis addon available - Real-time synchronization

Discord Integration

• Rich webhook embeds - Title, description, fields, images
• Auto color extraction - Dominant color from item textures
• Sell & Purchase notifications - Configurable webhook events

New Features

• Rule System - Composable rules (material, name, lore, tags, model data) with AND/OR logic
• 13 Plugin Hooks - ItemsAdder, Oraxen, Nexo, MMOItems, ExecutableItems, Slimefun, and more
• Bulk Item Viewer - Shulker box and container content preview
• Multi-Language - English, French, Spanish, Italian with auto-detection
• Separate API - API module for third-party developers
• Admin Monitoring - Transaction logs, history view, action tracking
• V3 Migration - Built-in migration tool

Economy & Taxes

Supported economies: Vault, PlayerPoints, CoinsEngine, Item-based, XP, Levels, zEssentials, EcoBits, RedisEconomy

Tax types:

• SELL - Fee when listing
• PURCHASE - Deducted from seller earnings
• BOTH - Applied at listing and sale
• CAPITALISM - VAT-style (buyer pays extra)

New: Per-item tax rules, tiered reductions (VIP/premium), bypass permissions

Commands

• /ah sell <price> [amount] [economy] - List item (new: economy parameter)
• /ah claim - Claim pending money
• /ah selling, /ah expired, /ah purchased, /ah history - Inventory shortcuts
• /ah admin migrate <source> confirm - V3 migration
• /ah admin history - View all transactions

Requirements

• Paper 1.20+ (Folia compatible via FoliaLib)
• Java 21
• zMenu (required)
• PlaceholderAPI (required)

Migration from V3

Code:

/ah admin migrate v3 confirm

Supports both SQL and JSON sources. Migrates all items, transactions, and player data.

• Fix Claim and seller show button

• Fix the issue where selling fails when players rapidly switch items

• Fix: Correction of minimessage when player is not found
• Fix: Update to last zMenu and Sarah Version

• Fix: Improved error handling for items with non-numeric model IDs
• Fix: Resolved an issue with purchasing items in the auction house
• Fix: Correction of the search list for the command /ah search

• Fix memory leak in Auction Item with cache

Fix the default configuration for storage system. If your configuration is bad, the plugin will use SQLITE instead of JSON.