HyroAuctionHouse

🛒 HyroAuctionHouse — Modern Live Auction House & Marketplace

HyroAuctionHouse is a feature-packed, high-performance marketplace and auction plugin built specifically for Paper / Purpur (1.20 - 1.21.x) Minecraft servers. Designed with an emphasis on security, scam prevention, and zero lag, it provides your players with an intuitive trading hub featuring instant buyouts, anti-sniping live bids, Shulker Box live inspection, and an offline mailbox!

---

✨ Features

⚡ 1. Buy It Now (BIN) & Live Bidding

• Instant Listing: Sell the item in your hand immediately with /ah sell <price>.
• Competitive Bids: Host timed live auctions where players can outbid each other in real time.
• Sort & Filter: Easily filter listings by category, price, seller, or time remaining.

🛡️ 2. Smart Anti-Sniping Protection

• Prevents players from sniping auctions at the last second with automated bots or macro clicks.
• Any bid placed in the final 60 seconds will automatically extend the auction countdown by +30 seconds, ensuring fair bidding wars for rare loot!

📦 3. Live Shulker Box Preview (Anti-Scam)

• Players can right-click any Shulker Box directly inside the Auction House GUI to inspect its complete contents.
• Protects your community from "empty box" scams and fraudulent sales.

📬 4. Offline Mailbox (/ah mailbox)

• Never lose items or earnings again!
• If a player's inventory is full or they are offline when an item sells or expires, items and coins are automatically routed to their personal secure mailbox.

💎 5. Seamless Voucher & Cosmetic Integration

• Fully supports physical item vouchers with persistent PDC data from HyroTags and HyroCosmetics.
• Allows players to build an authentic in-game economy around custom titles, badges, and 3D cosmetics.

📉 6. Configurable Market Tax & Audit Logs

• Automatically deducts a configurable sales tax (default: 5%) upon transaction completion to maintain a healthy server economy and fight inflation.
• Complete transaction history and admin audit logs stored securely via SQLite.

---

⌨️ Commands & Permissions

Command	Permission	Description
/ah	hyroah.use	Opens the main Auction House menu
/ah sell <price>	hyroah.sell	Lists the held item for instant sale (BIN)
/ah bid <id> <amount>	hyroah.use	Places a bid on an active live auction
/ah mailbox	hyroah.use	Opens your personal mailbox for pending items
/ah listings	hyroah.use	Views and manages your active listings
/ah history	hyroah.use	Views your recent transaction history
/ah admin	hyroah.admin	Administrative menu to cancel or inspect listings
/ah reload	hyroah.admin	Reloads configuration files and caches

Aliases: /auctionhouse, /hah, /auction, /pasar

---

⚙️ Requirements & Installation

Requirements:

• Server Software: PaperMC or Purpur (1.20 - 1.21.x)
• Java Version: Java 21 or newer
• Required Dependencies:
  • HyroCore
  • Vault + An Economy Provider (e.g. EssentialsX)
• Optional Dependencies:
  • PlaceholderAPI

Quick Installation:

1. Make sure HyroCore.jar and Vault are installed in your server's plugins/ directory.
2. Download HyroAuctionHouse.jar and place it in the plugins/ folder.
3. Restart your server.
4. Open config.yml to customize listing limits, transaction taxes, and auction durations to match your server's economy!