AuctionHouse by ilius

⚡ 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

- Datapack Items — Everything runs through inventory menus, no chat spam - Datapack Items — Review before money moves - Datapack Items — Bought items and expired listings go to your mailbox, nothing gets lost - Datapack Items — See what's inside shulkers before buying - Datapack Items — Right-click a listing to check the seller's stats and other items - Datapack Items — Weapons, Armor, Tools, Blocks, Food, Potions, Redstone, Decoration, Mob Drops, Misc - Datapack Items — Narrow down by category, price, seller, or keyword - Datapack Items — 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

- Anti-Exploit — Flat fee, percentage, sales tax — all configurable - Anti-Exploit — Works with Vault, PlayerPoints, EssentialsX, XP economy - Anti-Exploit — Set listing limits, expiry times, and fees per rank - Anti-Exploit — SQLite out of the box, switch to MySQL whenever - Anti-Exploit — Migrate from CrazyAuctions, zAuctionHouse, Fadah, or Akarian - Anti-Exploit — Messages, GUIs, icons, features — change whatever you want - Anti-Exploit — Get notified when items are listed or sold - Anti-Exploit — Placeholders for scoreboards and tab lists - Anti-Exploit — Restrict the AH to certain regions - Anti-Exploit — 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

- Optional: (or Purpur, Folia, etc.) - Optional: + an economy plugin - Optional: LuckPerms, PlaceholderAPI, WorldGuard, Optional:, %%MD1%%

---

💬 Need Help?

Join the Discord or open an issue.

---

🚀 Pro Edition — Available Now

Everything above, plus:

- Price Drop Notifications — Full order book matching engine with escrow and market demand GUI - Price Drop Notifications — Live stats, module toggles, and moderation tools - Price Drop Notifications — Guided listing with auction types and price suggestions - Price Drop Notifications — List and buy partial stacks - Price Drop Notifications — Pick exactly how much to buy - Price Drop Notifications — Per-player and per-group caps - Price Drop Notifications — Dump transactions for external analysis - Price Drop Notifications — 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.*