🏛️ 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)

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