ArcaneAuctionHouse

🔮 ArcaneAuctionHouse

The ultimate modern Auction & Gifting solution for your server.

Paper 1.21+ 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! * Total Sales Find exactly what you need by typing the item name in a custom Total Sales. 🔍 * Total Sales Sort listings by Price (Low ↔ High) instantly. 📉 * Total Sales Hover over your player head to see your Total Sales and Total Sales history. 📊

⚡ Revolutionary Multi-Slot Selling

Stop wasting time typing `/ah sell <price>` for every single stack. * Auto-Pricing: Open a dedicated 9-slot GUI. * Auto-Pricing: Drag and drop up to Auto-Pricing: 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! * cancel Use `/gift` to send items to any player who has joined the server. * cancel Recipients can claim their items from the "Inbox" menu whenever they log back in. * cancel 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. * Blacklist: Set a percentage fee (e.g., 5%) deducted from the player's balance when listing an item to control inflation. 💸 * Blacklist: Unsold items automatically expire after a configurable time (default: 48h) and are safely moved to the player's storage/inbox. ⏳ * Blacklist: Cap the maximum number of active auctions per player. * Blacklist: Block specific items (like Bedrock or Barriers) from being sold. 🚫

🎨 Fully Configurable & Immersive

* Hex Colors: Every message, menu title, and item name can be edited in `config.yml`. * Hex Colors: 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. EssentialsX (Required for Minecraft 1.21). 2. EssentialsX (Required) - To handle economy transactions. 3. EssentialsX (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.*