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

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