🔮 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.