AuctionHouse

# 🛒 AuctionHouse – Paper-Only Auction Plugin **A lightweight, high-performance auction system built exclusively for Paper servers.** --- ## 📖 About **AuctionHouse** is a powerful auction plugin crafted specifically for **Paper**. It provides a clean, GUI-driven marketplace where players can buy and sell items effortlessly. Whether you're running a Survival server, Factions, Skyblock, or a large network, this plugin helps create a thriving player-driven economy with minimal setup. No more clunky chat trading — just a sleek, intuitive auction house built for Paper's modern API. --- ## 📦 Two Versions – Pick the Right One for Your Server This plugin is released in **two separate builds**, each optimized for a specific Paper version: | Build | Compatible Paper Versions | |-------|---------------------------| | **AuctionHouse v1.0.0 (1.20.1)** | Paper 1.20.1 only | | **AuctionHouse v1.0.0 (1.21.x)** | Paper 1.21, 1.21.1, 1.21.3, 1.21.4, 1.21.11, and all future 1.21.x builds | > ⚠️ **Important:** Download the build that matches your server's Paper version. The 1.20.1 build will **not** work on 1.21.x servers, and vice versa. --- ## ✨ Key Features (Both Versions) - 🖥️ **Modern GUI Interface** – Browse, buy, and sell items through a beautifully designed, page-based menu. - ⚡ **Optimized for Paper** – Fully asynchronous and built to maintain high TPS even under heavy traffic. Uses Paper's advanced threading model. - 💰 **Full Economy Integration** – Works seamlessly with Vault and any economy plugin (EssentialsX, CMI, GemsEconomy, etc.). - 💾 **Persistent Storage** – All auctions are automatically saved and survive server restarts. No data loss. - 🔒 **Permission-Based Access** – Control who can use the auction house with `auctionhouse.use`. - 🛠️ **Simple Commands** – Intuitive commands that are easy for players to learn and use. - 📦 **Lightweight** – No bloat, just clean, efficient code that does its job perfectly. --- ## 📋 Commands | Command | Description | |---------|-------------| | `/ah` | Opens the main auction house GUI | | `/ah sell <price>` | Lists the item in your hand for sale | | `/ah list` | Shows all items you currently have listed | | `/ah cancel <number>` | Removes an item from your listings | > **Aliases:** `/auction`, `/auc` --- ## 🛠️ Installation 1. **Download** the correct `AuctionHouse.jar` from the Versions tab above: - Choose `1.20.1` if your server runs **Paper 1.20.1**. - Choose `1.21.x` if your server runs any **Paper 1.21.x** version. 2. **Place** the `.jar` into your server's `plugins` folder. 3. **Restart** your server — the plugin will generate its configuration files automatically. 4. **Ensure** you have **Vault** and an economy plugin (like EssentialsX) installed. That's it! Your players can now start using `/ah` immediately. --- ## ⚙️ Dependencies - **(https://modrinth.com/plugin/vault)** – Required for economy management. - **An Economy Plugin** – EssentialsX, CMI, or any plugin that provides Vault-compatible economy. --- ## ✅ Supported Paper Versions | Build | Compatible Paper Versions | Java Required | |-------|---------------------------|---------------| | **1.20.1 Build** | Paper 1.20.1 | Java 17+ | | **1.21.x Build** | Paper 1.21, 1.21.1, 1.21.3, 1.21.4, 1.21.11+ | Java 21+ | > **Note:** The 1.21.x build is forward-compatible with all future 1.21.x patches. This plugin is designed exclusively for Paper — other server software is not officially supported. --- ## 🧩 Perfect For - 🏕️ **Survival Servers** – Encourage trading and build a strong economy. - ⚔️ **Factions / Skyblock** – Let players buy and sell rare resources. - ⛏️ **Prison / Mining** – Create a vibrant market for mined goods. - 🌐 **Hub Networks** – Add auction functionality across your Paper network. --- ## 💬 Support & Feedback - **Issues / Suggestions** – Open a ticket on our (https://github.com/yourusername/auctionhouse/issues) - **Source Code** – Available on (https://github.com/yourusername/auctionhouse) - **Discord** – Join our community for support and updates: (#) --- ## 📦 Download Choose the correct build from the **Versions** tab above: - **For Paper 1.20.1** → Download the `1.0.0 + 1.20.1` build. - **For Paper 1.21.x** → Download the `1.0.0 + 1.21.x` build. --- > ⭐ **Enjoying AuctionHouse?** Please consider leaving a review and starring the project on GitHub! Your support helps us keep improving. --- **Ready to take your Paper server economy to the next level? Download AuctionHouse today!** 🚀