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
• Discord webhooks — Notifications for sales, bids, auction wins, and admin actions
• Web dashboard — Full API for listings, sales history, statistics, and player lookup
• Cross-server sync — All listings 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.