Описание
# ⚡ 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**](https://modrinth.com/plugin/economyprovider-by-ilius) — Modern Vault economy with banknotes, baltop GUI, and transaction logging
- [**EconomyShop**](https://modrinth.com/plugin/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 [amt]` | List the item in your hand |
| `/ah search ` | Search listings |
| `/ah cancel ` | 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 ` | Remove any listing |
| `/ah admin return ` | Return items to player |
| `/ah admin stats` | Market statistics |
| `/ah admin lookup ` | Inspect a listing |
| `/ah admin transactions [player]` | Transaction log |
| `/ah admin purge ` | 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](https://modrinth.com/plugin/economyprovider-by-ilius), [EconomyShop](https://modrinth.com/plugin/economyshop)
---
## 💬 Need Help?
Join the [Discord](https://discord.gg/ns3q9ejGwR) 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 «](https://builtbybit.com/resources/auctionhouse-pro.103563/)
---
*Part of the ilius economy ecosystem. Built for servers that take their economy seriously.*