AT-AuctionHouse | Cross-Server Market 1.0.0

📋 Overview

Players list an item at a price they set, other players buy it. No bidding, no waiting for a timer to run out, no watching a listing you already wanted. Click and it is yours.

Everything a player needs is in one menu: eight categories that fill themselves from what is actually listed, four sort orders, a search bar, and a collection box holding anything waiting to be picked up. Point several servers at one database and they all share the same auction house.

Your own listings, with everything you have up for sale in one place

🧩 Dependencies

• Vault (required) plus an economy plugin, for every purchase and payout. Get it here
• Redis and MySQL or MongoDB (optional) only if you want several servers sharing one auction house. A single server needs neither

On Folia, Vault and your economy plugin must themselves be Folia-compatible. Upstream Vault is not, so use a Folia-compatible fork. Every Vault-based plugin has this same requirement.

🔍 Browse, Filter, Sort, Search

• Eight categories plus All, worked out automatically from what is listed. Nothing to tag, nothing to maintain
• Four sort orders, so a player can find the cheapest or the newest without scrolling
• Search by name, through an anvil, a sign, or plain chat. Pick whichever suits your players, chat works on clients where anvil menus are restricted
• Look inside a shulker before you buy it. Shift-click any listed shulker box to see its contents
• View one player's listings with /ah <player>

Filtering by category, with each one filled from what is actually listed


Four sort orders, so the cheapest or the newest is one click away


Searching by name, here through the anvil menu

📦 It Never Loses an Item

Every path that takes an item from a player has a matching path that gives it back: a failed listing, a cancelled one, a full inventory, a player logging out mid-sale, and a clean server shutdown. Anything that cannot be handed over on the spot goes to that player's collection box and waits for them.

This is the part of an auction house that generates tickets when it goes wrong, so it is the part that got the most attention.

The collection box, with everything waiting to be picked up and a collect all button

🌐 Cross-Server

Point several servers at one database and one Redis instance and they share a single auction house. A sale on one server shows up in the menus on every other within a second, so a player never buys something that is already gone.

Running one server? Leave it all switched off. SQLite is the default and needs no setup at all.

🧵 Real Folia Support

Not just the flag in the plugin file. Every piece of work is routed to the thread that actually owns it, which is what makes item handling safe on a regionised server. The same jar runs on Paper, so there is nothing separate to download.

🖥 Menus You Actually Control

gui.yml goes further than most. Every button's material, name, lore, stack size, glint and custom model data are yours to set.

Everything the plugin knows is exposed as a placeholder you can put anywhere or leave out entirely: the price, the seller, the time left, the page, the category, the search query. That applies to the lore appended to listed items, to collection box items, and to history entries too.

The transactions menu, every buy and sell a player has made

💰 Prices That Read the Way You Want

Set your own currency symbol, or leave it blank for bare numbers. Set your own magnitude suffixes, so K and M can be anything you like.

The price prompt reads your suffixes back, so renaming K to mil also makes 2.5mil something a player can type. Time formats are translatable in the same way.

⌨️ Commands

Aliases: /auctionhouse and /atah.

For everyone (atauctionhouse.use)

• /ah open the auction house
• /ah <player> view one player's listings
• /ah search <query> search by name
• /ah sell [price] list the item in your hand (atauctionhouse.sell)
• /ah collect open your collection box
• /ah transactions your buy and sell history (alias: history)
• /ah help list the commands

For staff (atauctionhouse.admin)

• /ah reload reload config, menus and language
• /ah remove <id> force-remove a listing
• /ah about version and backend info

🔐 Listing Slots by Rank

How many listings a player can have open is permission-driven. The config value is the floor for everyone, then grant atauctionhouse.limit.25 for twenty-five slots, or atauctionhouse.limit.unlimited to remove the cap entirely. The highest match wins, so stacking ranks works the way you would expect.

🌍 Four Languages Built In

English, Spanish, French and Japanese all ship with the plugin. Any key you do not translate falls back to English on its own, per key, so a half-finished translation is still safe to use in production.

Colours support legacy codes, hex, gradients, rainbows and a 125-colour named palette, everywhere text can be coloured.

⚙️ Three Files, Nothing Hardcoded

• config.yml storage, limits, durations, prices, sounds
• gui.yml every menu: layout, materials, names, lore
• lang/*.yml every chat message

Every section carries an explanation of what it does and what the valid values are. Files update themselves too: a new release merges its new keys and their comments into your file while every value you set stays exactly as you left it. Nothing to diff, nothing to regenerate.

💾 Storage

SQLite by default, with no setup at all. MySQL and MongoDB are both supported for anything larger, and only the driver you actually configured is ever loaded. The server downloads them at startup, so there is nothing to install by hand.

🧪 Requirements

• Minecraft: 1.21.1 and newer, including the 26.x line
• Server software: Paper or Folia
• Java: 21 on 1.21.x, 25 on 26.x
• Storage: SQLite out of the box, MySQL or MongoDB optional
• Required: Vault plus an economy plugin

📈 Metrics

This plugin sends anonymous usage stats to ArrowStats. You can opt out anytime with GENERAL.METRICS in config.yml.

💬 Support & Docs

Full setup and configuration guides are in the documentation, including every config key and every menu placeholder. Have questions, found a bug, or want to suggest a feature? Join the Discord.