🔮 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:
- Java 21 (Required for Minecraft 1.21).
- Vault (Required) - To handle economy transactions.
- 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
- Download the
ArcaneAuctionHouse.jar file.
- Make sure you have Vault and an Economy plugin installed.
- Place the jar into your server's
/plugins folder.
- Restart your server.
- (Optional) Edit
plugins/ArcaneAuctionHouse/config.yml to customize taxes, messages, and limits.
- Enjoy a modern economy! 🎉
Developed with ❤️ for the Minecraft community.
