Its Auction!

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 and up