⚡ AuctionHouse ⚡

A fast, clean auction house for Paper 1.20+

---

📦 Browse Listings

Scroll through pages, hover for details.

✅ Buy with Confidence

Confirmation screen before every purchase.

💰 Sell in Seconds

One command, confirm, listed.

🔍 Find What You Need

Filter by category, price, seller, or keyword.

📊 Price History

Bar chart with weekly paging and trends.

📋 Container Preview

Right-click shulkers to peek inside before buying.

---

✨ What's Included

For Players

• Clean GUI — Everything runs through inventory menus, no chat spam
• Buy & Sell Confirmation — Review before money moves
• Mailbox — Bought items and expired listings go to your mailbox, nothing gets lost
• Container Preview — See what's inside shulkers before buying
• Seller Info — Right-click a listing to check the seller's stats and other items
• 10 Categories — Weapons, Armor, Tools, Blocks, Food, Potions, Redstone, Decoration, Mob Drops, Misc
• Filters & Search — Narrow down by category, price, seller, or keyword
• Price History — Real bar chart with weekly views, highs/lows, and trend arrows
• Datapack Items — Custom items show up correctly with their own price history

For Server Owners

• Listing Fees & Tax — Flat fee, percentage, sales tax — all configurable
• Vault + More — Works with Vault, PlayerPoints, EssentialsX, XP economy
• LuckPerms — Set listing limits, expiry times, and fees per rank
• SQLite / MySQL / MariaDB — SQLite out of the box, switch to MySQL whenever
• Import Tool — Migrate from CrazyAuctions, zAuctionHouse, Fadah, or Akarian
• Everything is Configurable — Messages, GUIs, icons, features — change whatever you want
• Discord Webhooks — Get notified when items are listed or sold
• PlaceholderAPI — Placeholders for scoreboards and tab lists
• WorldGuard — Restrict the AH to certain regions
• Folia Support — Works on Folia out of the box
• Anti-Exploit — Atomic SQL, transaction locks, drag protection, dupe prevention

---

🔗 Part of the ilius Economy Ecosystem

AuctionHouse is the player-to-player marketplace of the ilius economy stack. Pair it with:

• EconomyProvider — Modern Vault economy with banknotes, baltop GUI, and transaction logging
• EconomyShop — Server shop with dynamic pricing, chest shops, and categories

All three plugins integrate seamlessly — same config style, same database support, same Discord. Use one or all three.

---

⌨️ Commands

Player

Command	Description
/ah	Open the auction house
/ah sell <price> [amt]	List the item in your hand
/ah search <keyword>	Search listings
/ah cancel <id>	Cancel your listing
/ah active	View your listings
/ah claim	Claim mailbox items
/ah help	Show commands

Admin

Command	Description
/ah admin reload	Reload config
/ah admin forcecancel <id>	Remove any listing
/ah admin return <player>	Return items to player
/ah admin stats	Market statistics
/ah admin lookup <id>	Inspect a listing
/ah admin transactions [player]	Transaction log
/ah admin purge <days>	Clear old records
/ah admin import	Import from other plugins

---

🔑 Permissions

Permission	Description	Default
auction.use	Open the AH	true
auction.sell	List items	true
auction.buy	Buy items	true
auction.cancel	Cancel own listings	true
auction.admin	Admin commands	op
auction.admin.reload	Reload config	op

---

📥 Setup

1. Drop the jar in plugins/
2. Restart
3. Edit plugins/AuctionHouse/config.yml if you want
4. /ah admin reload and you're good

Want MySQL instead of SQLite? Open config.yml, set storage.type to mysql, then fill in host, port, database, username, and password under the storage.mysql section. Restart and you're done.

---

📦 Requirements

• Paper 1.20+ (or Purpur, Folia, etc.)
• Vault + an economy plugin
• Optional: LuckPerms, PlaceholderAPI, WorldGuard, EconomyProvider, EconomyShop

---

💬 Need Help?

Join the Discord or open an issue.

---

🚀 Pro Edition — Available Now

Everything above, plus:

• Buy Orders — Full order book matching engine with escrow and market demand GUI
• Admin Dashboard — Live stats, module toggles, and moderation tools
• Sell Wizard — Guided listing with auction types and price suggestions
• Bulk Listings — List and buy partial stacks
• Quantity Selector — Pick exactly how much to buy
• Sale Limits — Per-player and per-group caps
• CSV Export — Dump transactions for external analysis
• Price Deviation Guards — Block manipulation attempts automatically
• Price Drop Notifications — Alert players when items hit their target price

» Get AuctionHouse Pro on BuiltByBit «

---

Part of the ilius economy ecosystem. Built for servers that take their economy seriously.