📖 About zAuctionHouse

zAuctionHouse is a premium auction house plugin that allows players to buy and sell items on your Minecraft server. Built with performance, customization, and user experience in mind, it provides a complete trading solution for any server type - from small survival servers to large network infrastructures.

After nearly 5 years since the release of V3 (February 2021), zAuctionHouse V4 represents a complete rewrite from the ground up, leveraging modern Java features, a new architecture, and years of community feedback to deliver the ultimate auction house experience.

🎯 Perfect For

• Survival/SMP Servers - Let players trade items naturally
• Skyblock Servers - Essential for island economies
• Factions/Towny - Facilitate inter-faction commerce
• RPG Servers - Custom item trading with MMOItems, Oraxen, etc.
• Network Servers - Multi-server synchronization with Redis addon

✨ Key Features

🏪 Core Auction System

• Instant Buy Listings - List items for a fixed price
• Bulk Sales - Sell multiple items in a single listing
• Shulker Box Preview - View contents before purchasing
• Category Filtering - Organize items by type (weapons, armor, tools, etc.)
• Advanced Sorting - Sort by price, date, name, and more
• Pagination - Handle thousands of listings efficiently

💰 Economy & Transactions

• Multi-Economy Support - Vault, PlayerPoints, CoinsEngine, Item-based, XP
• Multiple Currencies - Enable different economies simultaneously
• Tax System - Configurable taxes (sell, purchase, VAT/capitalism style)
• Permission-based Tax Reductions - VIP discounts on taxes
• Auto-Claim - Automatic money delivery or manual claiming
• Offline Sales Notifications - Know what sold while you were away

🎨 Complete Customization

• zMenu Integration - Fully customizable GUI via YAML
• MiniMessage Support - Modern text formatting with gradients, hex colors
• Custom Lore Templates - Define exactly how items appear
• Pattern System - Reusable GUI components
• Placeholder Support - PlaceholderAPI integration

🔧 Administration

• Admin Panel - View/manage any player's items
• Action Logs - Complete audit trail of all transactions
• Transaction History - Detailed financial records
• Item Recovery - Retrieve items from logs
• Cache Management - Admin commands for cache control
• Performance Debugging - Built-in profiling tools

🌐 Multi-Server Support

• Redis Addon - Synchronize across multiple servers
• Distributed Locking - Safe concurrent transactions
• Real-time Updates - Instant synchronization via pub/sub
• Server Identification - Track item origin across network

🔒 Security & Protection

• Blacklist System - Block specific items from sale
• Whitelist System - Only allow specific items
• World Restrictions - Disable selling in certain worlds
• Listing Limits - Permission-based item limits
• Price Limits - Min/max price per economy
• Transaction Locking - Prevent race conditions

📊 Discord Integration

• Webhook Notifications - Post sales to Discord
• Rich Embeds - Beautiful sale announcements
• Dynamic Colors - Extract item colors for embeds
• Customizable Messages - Full control over webhook content

🔌 Supported Plugins

Economy Plugins

Custom Item Plugins

Required Dependencies

Optional Dependencies

🆚 V3 vs V4: What's New?

Architecture Overhaul

New in V4

Migration Path

V4 includes a built-in migration system to import your V3 data:

/ah admin migrate zauctionhousev3 confirm

Supports migration from:

• V3 SQLite database
• V3 MySQL/MariaDB database
• V3 JSON storage

🏆 Why Choose zAuctionHouse?

vs. Other Auction Plugins

What Sets Us Apart

1. 🎯 True Customization

   • Every GUI element is configurable via YAML
   • No hardcoded messages or interfaces
   • Pattern system for reusable components

2. ⚡ Performance First

   • Sorted item cache for instant browsing
   • Async database operations
   • Optimized for servers with 10,000+ listings

3. 🔧 Developer Friendly

   • Clean API for integration
   • Events for all major actions
   • Repository pattern for data access

4. 🛡️ Battle Tested

   • Used on major networks
   • 5+ years of development experience
   • Active community feedback

5. 📚 Excellent Documentation

   • Complete wiki with examples
   • Configuration file comments
   • Active Discord support

📥 Installation

1. Download zMenu and PlaceholderAPI
2. Download zAuctionHouse from Spigot
3. Place all JARs in your plugins folder
4. Restart your server
5. Configure in plugins/zAuctionHouse/config.yml
6. Customize GUIs in plugins/zAuctionHouse/inventories/

📝 Quick Start

Basic Commands

Admin Commands

🔗 Links

• 📖 Documentation: zauctionhouse.groupez.dev
• 💬 Discord: discord.groupez.dev
• 🛒 Spigot: spigotmc.org/resources/zauctionhouse
• 🐛 Issues: GitHub Issues

💝 Support the Development

zAuctionHouse is a premium plugin developed with passion. Your purchase supports:

• Continuous development and new features
• Bug fixes and compatibility updates
• Documentation and support
• Server infrastructure

📜 License

zAuctionHouse is a premium plugin. Purchase includes:

• Lifetime updates
• Discord support
• Access to all addons

🛠️ Development Roadmap

New Features (Planned)

• YAML file update system improvements
• Message enable/disable options
• Sell inventory improvements with zTextGenerator
• Admin item sales system
• Favorite items system
• Offline sales notification with history
• Page command /ah page <page>
• Sale removal reason tracking
• Custom model data for item images
• Transaction state modification
• Sell items on behalf of players
• Custom bulk sale naming
• Inventory button validation
• Renamed "owned" to "selling"
• More admin commands for item management
• Slot-based multi-item sales
• Custom Discord image URLs

Missing V3 Features

Commands

• /ah search <string> - Item search
• /ah blacklist - Player blacklist management
• /ah config - In-game configuration
• /ah version - Version display
• /ah convert - V2/PlayerAuctions conversion
• /ah purge <days> - Old transaction purge

Systems

• Tax system (global, per-item, bypass permissions)
• Priority system (VIP sorting)
• Per-item price limits
• Advanced search (chat, GUI, filters)
• Additional sort options (10 more)
• Cooldown system
• Player blacklist
• Global announcements
• Bid/auction system
• Rent system
• Dupe prevention (NMS/PDC)

Integrations

• Citizens NPC support
• ProtocolLib advanced search
• ZEssentials mailbox

zAuctionHouse Discord Bot (Planned)

• Private message notifications for sales
• Listing notifications
• Item filters for notifications
• Direct purchase from Discord