# 🏛️ AuctionHouse **A clean, fully-featured auction house plugin for Paper 1.21.1.** List items, browse listings, search by name, and buy with a single click — all through a polished GUI powered by Vault economy. --- ## ✨ Features - **Full GUI auction browser** — paginated, refreshable, always up to date - **One-click purchasing** — click an item to buy it instantly - **Sell from hand** — `/ah sell <price>` lists the item you're holding in seconds - **Bulk sell GUI** — `/ah sellgui` opens a chest where you drag in multiple items and set prices one by one - **Player storefronts** — `/ah <player>` to browse a specific player's listings - **Search** — `/ah search <name>` finds items by name, category, or material with tab-completion - **My Items** — view and cancel your own active listings; title shows your slot usage (e.g. `3/5`) - **Storage system** — items unsold after **2 days** move to a personal storage; unclaimed items are permanently deleted after **7 days** - **Real-time "sold" indicator** — if someone buys an item while you're looking at it, the slot instantly turns into a **gray wool** block with a notification - **Sale notifications** — sellers receive a chat message the moment their item is purchased - **Vault economy** — fully integrated with Vault + EssentialsX (or any compatible economy plugin) - **Configurable tax** — optional listing/sale tax in percent - **Per-player listing limit** — prevent spam listings (default: 5 per player) - **Fully configurable** — every message, GUI title, time limit, price cap, and currency symbol is editable in `config.yml` - **Auto folder creation** — on first launch the plugin creates its folder and config automatically --- ## 📋 Commands | Command | Description | |---|---| | `/ah` | Open the main auction house | | `/ah sell <price>` | List the item in your hand | | `/ah sellgui` | Open the bulk-sell GUI | | `/ah search <query>` | Search listings by name | | `/ah <player>` | Browse a player's listings | --- ## 🔑 Permissions | Permission | Default | Description | |---|---|---| | `auctionhouse.use` | Everyone | Use all `/ah` commands | | `auctionhouse.admin` | OP | Admin access | --- ## ⚙️ Configuration (config.yml) ```yaml settings: expire-hours: 48 # Hours until unsold items move to storage storage-hours: 168 # Hours until storage items are deleted max-listings-per-player: 5 # Max active listings per player tax-percent: 5 # Sale tax in percent (0 = disabled) currency-symbol: "$" # Display symbol min-price: 1.0 # Minimum listing price max-price: 0 # Maximum listing price (0 = unlimited) ``` Every message and GUI label is also editable — see the full `config.yml` generated on first launch. --- ## 📦 Requirements - **Paper** 1.21.1+ - **Vault** - Any Vault-compatible economy plugin (e.g. **EssentialsX**) --- ## 🚀 Installation 1. Drop `AuctionHouse.jar` into your `/plugins` folder 2. Make sure **Vault** and an economy plugin are installed 3. Start the server — the `plugins/AuctionHouse/` folder and `config.yml` are created automatically 4. Edit `config.yml` to your liking and run `/reload` or restart --- *Built with ❤️ for Paper 1.21.1 and up*