Minecraft plugin zAuctionHouse

🔌 About zAuctionHouse

zAuctionHouse is a Minecraft plugin that implements a full-featured auction house for players to list, browse, and purchase items. It focuses on configurability, GUI-driven interfaces, and support for multiple economy types. The project is maintained by GroupeZ-dev and the repository and documentation show a V4 rewrite that targets modern Java and server architectures.

🎯 Purpose

zAuctionHouse solves the problem of in-game item trading by providing a central marketplace where players can create buy-now listings, perform bulk sales, and browse categorized inventories. It's aimed at servers that want an integrated marketplace with admin auditing and optional network synchronization.

⚙️ Features

• Instant-buy (buy-it-now) listings and bidding-style workflows where supported.
• Bulk sales: sell multiple items in a single listing.
• Shulker box preview so buyers can inspect contents before purchase.
• Category filtering, advanced sorting, and pagination for large listing sets.
• Multi-economy support (Vault, PlayerPoints, CoinsEngine, item-based currencies, XP/levels).
• Configurable tax system and permission-based tax reductions.
• Auto-claim or manual-claim money delivery, and offline sale notifications.
• zMenu integration for fully customizable GUIs and inventory templates.
• PlaceholderAPI and MiniMessage support for formatted messages and placeholders.
• Admin tools: an admin panel, action logs, transaction history, item recovery, and cache management commands.
• Multi-server synchronization via a Redis addon with distributed locking and pub/sub.
• Blacklist/whitelist item controls, world restrictions, listing and price limits, and transaction locking to prevent race conditions.
• Discord webhook support for sale notifications with configurable embed content.

🧩 Who It Is For

• Survival and SMP servers that want a player-driven marketplace.
• Skyblock, Factions, and economy-focused servers needing trade systems.
• Networks that require synchronized marketplaces across multiple backend servers.
• Server administrators who need audit logs and admin recovery tools.

🏗️ Example Use Cases

• Players list rare drops or crafted items for a fixed price for other players to buy instantly.
• A server operator enforces tax rules and VIP tax reductions via permissions.
• A multi-server network synchronizes listings and sales across hub and backend servers using the Redis addon.

⌨️ Commands

(Commands above are taken from the official project documentation and repository quick-start materials.)

🔐 Permissions

(Only permission nodes explicitly referenced in the official configuration and docs are listed.)

⚙️ Installation

📥 Setup

• Obtain the official zAuctionHouse jar from the project's distribution (official sales page or catalog).
• Place the zAuctionHouse jar (and required plugins) into the server plugins/ directory.
• Restart the server and verify the plugin initializes in the server console.
• Configure the plugin using plugins/zAuctionHouse/config.yml and customize GUI inventories in plugins/zAuctionHouse/inventories/.

📦 Dependencies

• Required: zMenu, PlaceholderAPI.
• Optional / supported integrations: Vault, LuckPerms, and the zAuctionHouse Redis addon for multi-server synchronization.

🧠 Technical Notes

• The project targets modern Java (the V4 rewrite targets Java 21) and uses a repository pattern / ORM in its architecture.
• Recommended server software includes Paper and Paper forks; Folia and several Paper-based forks are listed as supported.
• Official documentation and distribution show support for Minecraft 1.20 up through 1.21+ (check the project docs for exact build compatibility before deploying to production).

❓ FAQ

• Is there a free version?
  A free demo build is available (the project provides a free/demo release on some platforms), while full, supported releases are distributed via the project's premium channels.

🤝 When This Plugin Is Useful

If you need a configurable, GUI-driven marketplace with multi-economy support and optional multi-server synchronization, zAuctionHouse provides a maintained auction house implementation along with admin auditing and GUI customization via zMenu.