ArcaneAuctionHouse

# 🔮 ArcaneAuctionHouse **The ultimate modern Auction & Gifting solution for your server.** **ArcaneAuctionHouse** allows your players to buy, sell, and trade items through a sleek, fully GUI-based interface. Designed specifically for **Paper 1.21+**, it replaces old, clunky chat commands with a modern user experience. Whether you run a Survival, SkyBlock, or RPG server, ArcaneAuctionHouse provides a robust economy system with taxes, item expiration, and a unique gifting mechanic. --- ## ✨ Key Features ### 🛒 Advanced Marketplace GUI Browse items in a clean, paginated interface. No more spamming chat! * **Smart Search:** Find exactly what you need by typing the item name in a custom **Anvil GUI**. 🔍 * **Sorting:** Sort listings by Price (Low ↔ High) instantly. 📉 * **Player Stats:** Hover over your player head to see your **Total Balance** and **Total Sales** history. 📊 ### ⚡ Revolutionary Multi-Slot Selling Stop wasting time typing `/ah sell <price>` for every single stack. * **Sell Menu:** Open a dedicated 9-slot GUI. * **Bulk Listing:** Drag and drop up to **9 stacks** of items at once. * **Auto-Pricing:** Set the price *once*, and the plugin automatically creates individual listings for every stack you inserted. ### 🎁 Unique Gifting System Foster a community by allowing players to send gifts to each other, even when offline! * **Send Gifts:** Use `/gift` to send items to any player who has joined the server. * **Inbox System:** Recipients can claim their items from the "Inbox" menu whenever they log back in. * **Safe Transactions:** Sent a gift by mistake? You can view "Sent Gifts" and **cancel** them to retrieve your items if they haven't been claimed yet! ↩️ ### ⚙️ Economy & Admin Control Keep your server economy balanced and safe. * **Listing Tax:** Set a percentage fee (e.g., 5%) deducted from the player's balance when listing an item to control inflation. 💸 * **Expiry System:** Unsold items automatically expire after a configurable time (default: 48h) and are safely moved to the player's storage/inbox. ⏳ * **Listing Limits:** Cap the maximum number of active auctions per player. * **Blacklist:** Block specific items (like Bedrock or Barriers) from being sold. 🚫 ### 🎨 Fully Configurable & Immersive * **100% Translatable:** Every message, menu title, and item name can be edited in `config.yml`. * **Sound Effects:** Satisfying sounds for clicking, purchasing, selling, and errors. 🔊 * **Hex Colors:** Full support for modern color codes. --- ## 📋 Requirements & Dependencies To run **ArcaneAuctionHouse**, you need the following: 1. **Java 21** (Required for Minecraft 1.21). 2. **Vault** (Required) - To handle economy transactions. 3. **An Economy Plugin** (Required) - Any plugin compatible with Vault (e.g., **EssentialsX**, CMI, TheNewEconomy). > *Note: This plugin is optimized for **PaperMC**, Purpur, and Pufferfish. It also works on Spigot.* --- ## 🚀 Commands & Permissions | Command | Description | Permission | | :--- | :--- | :--- | | `/ah` | Opens the main Auction House menu. | `None` (Default) | | `/ah sell` | Opens the bulk selling menu. | `arcaneauctionhouse.sell` | | `/gift` | Opens the Gifting & Inbox menu. | `None` (Default) | | `/ah reload` | Reloads the `config.yml` file. | `arcaneauctionhouse.reload` | --- ## 💾 Installation 1. Download the `ArcaneAuctionHouse.jar` file. 2. Make sure you have **Vault** and an Economy plugin installed. 3. Place the jar into your server's `/plugins` folder. 4. Restart your server. 5. (Optional) Edit `plugins/ArcaneAuctionHouse/config.yml` to customize taxes, messages, and limits. 6. Enjoy a modern economy! 🎉 --- *Developed with ❤️ for the Minecraft community.*