Getting Started

Overview

XAuctionHouse is a full-featured auction house addon for XCore. It provides a server-wide marketplace where players can list items for fixed-price sale or start timed auctions with competitive bidding.

Key features

• Dual listing modes — Fixed-price "Buy Now" listings and timed auctions with bidding
• Multi-currency — Uses XCore's economy system; sellers choose which currency to list in
• 7-category marketplace — All, Tools, Weapons, Blocks, Armors, Spawners, Other
• Advanced search — Filter by name, price range, material type, and listing type
• Favorites system — Bookmark items for quick access
• Bidding with snipe protection — Auctions automatically extend when bids arrive near the deadline
• Smart delivery — Purchased items go to a claim queue if the buyer's inventory is full
• Shulker box preview — View shulker contents before buying
• Tax system — Configurable buyer-side or seller-side commission
• Pending payments — Offline sellers receive their earnings when they next log in
• Server listings (money sink) — Admin-created listings where the buyer pays but the proceeds are destroyed, taking currency out of the economy
• Auction bans — Ban scammers from the auction house (temporary or permanent) with a configurable block scope
• Discord webhooks — Notifications for sales, bids, auction wins, and admin actions
• Web dashboard — Listings, sales history, statistics, player lookup, and a Bans management page
• Cross-server sync — Listings, bids, and bans propagate instantly across a network
• 8 GUI screens — Fully customizable via YAML files

Requirements

• Paper 1.21.1+ (or Folia)
• Java 21+
• XCore 1.0.0+ installed as a plugin
• PlaceholderAPI — Optional, for placeholders

Installation

1. Install XCore in your server's plugins/ folder.
2. Place XAuctionHouse.jar in plugins/XCore/addons/.
3. Start the server. XAuctionHouse generates its config in plugins/XCore/addons/XAuctionHouse/.
4. Edit config.yml and lang.yml to match your setup (currency, duration, taxes, blocked items, etc.).
5. Restart or use /ah reload to apply changes.