Chunkwright Auction House

What it does

Players list the item in their hand with /ah sell and everyone browses the listings in a menu with categories, search, sorting and pages, then buys through a confirm menu. Money goes through Vault, with a listing fee and sales tax from config. Unsold items expire to a collection bin, offline sellers still get paid, and a black market picks random listings every few hours and sells them at a discount. Buying is duplication safe: our lab races up to six players clicking Buy on the same item at once, and every listing sells exactly once.

• /ah sell <price> with 1k, 2.5m and 1b shortcuts
• Browse menu with 6 categories plus All, 4 sort orders and pages
• Search from the menu (hidden chat prompt) or /ah search: names, types, enchantments, lore and sellers
• Confirm menu for every purchase, /ah view <id> to open one listing
• Listing limits per permission group (ah.limit.<group>)
• Listing fee (flat plus percent) and sales tax in config.yml
• Expiry to a collection bin with the reason, collect one or all, nothing lost on a full inventory
• Offline sellers paid through Vault, with an away summary when they join
• Duplication-safe buying, cancels and staff removals, tested with up to six players racing
• Black market: random discounted listings every few hours, seller gets full or discounted price
• Transaction log file and /ah log
• PlaceholderAPI placeholders
• Every message in messages.yml (MiniMessage), commented config, safe background saving

Install

1. Put AuctionHouse-1.0.0.jar in your plugins folder.
2. Make sure Vault and an economy plugin are installed.
3. Start the server. The plugin writes plugins/AuctionHouse/config.yml and messages.yml.
4. Change what you like and run /ah reload. Listings are kept on reload.

Requirements

• Paper or Purpur 1.21.4 to 26.1
• Java 21+
• Vault or VaultUnlocked with an economy plugin (for example EssentialsX)
• Optional: PlaceholderAPI