zenAuction
A lightweight, premium auction house plugin for your server.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
✦ Overview ✦
zenAuction is a clean, fast, and fully configurable auction house plugin built for modern Minecraft servers (1.20+). It features a sleek smallcaps UI, sign-based input for pricing & searching, smart item sorting/filtering, and a smooth navigation system — all without bloat.
Whether you run an SMP, a towny server, or a custom economy network, zenAuction gives your players a premium marketplace experience out of the box.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
✦ Features ✦
- ✔ Beautiful GUI Design — Smallcaps titles, clean lore formatting, custom hex color support (#RRGGBB)
- ✔ Sort & Filter — Sort by Highest Price, Lowest Price, Last Listed, or Recently Listed. Filter by category: Blocks, Tools, Food, Combat, Potions, Books, Ingredients, Utilities
- ✔ Sign-Based Input — Price entry and search use an in-game sign editor. No chat-based input clutter
- ✔ Smart Navigation — Closing a GUI automatically returns you to the previous screen. No back buttons needed
- ✔ Your Listings Panel — View all your active listings with time remaining, cancel items with one click, and sell new items via a dynamic Sell button
- ✔ Insert Item GUI — Compact hopper-style interface to drop in an item, then confirm or cancel
- ✔ Transaction History — Full purchase & sale history with paginated GUI
- ✔ Confirm Purchase — Players confirm before buying — no accidental purchases
- ✔ Price Shorthand — Players can type
10k,1m,2.5bin the sign — automatically parsed - ✔ Lightweight SQLite — Zero external database setup. Everything stored locally with fast queries
- ✔ Fully Configurable — Every GUI title, button material, lore line, slot, sound, and color is editable in config.yml
- ✔ Vault Economy — Integrates with Vault for seamless buy/sell transactions
- ✔ Auto Expiry — Listings automatically expire after a configurable duration. Expired items can be collected
- ✔ Custom Sounds — Every action (open GUI, click button, list item, purchase, error) has its own configurable sound
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
✦ Commands ✦
Code:
/ah — Open the auction house
/ah sell <price> — List the item in your hand for a price
/ah reload — Reload the config (admin)
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
✦ Permissions ✦
Code:
zenauction.use — Access the auction house (default: true)
zenauction.sell — List items for sale (default: true)
zenauction.admin — Reload config & create auction signs (default: op)
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
✦ Requirements ✦
- Server: Spigot / Paper 1.21+
- Java: 17+
- Economy: Vault + any economy provider (EssentialsX, CMI, etc.)
- Database: None required (uses built-in SQLite)
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
✦ Installation ✦
- Drop
ZenAuction.jarinto your/pluginsfolder - Restart your server
- Edit
plugins/ZenAuction/config.ymlto your liking - Run
/ah reloadto apply changes - Done! Use
/ahto open the auction house
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
✦ Configuration Preview ✦
YAML:
gui:
main-gui:
title: "ᴀᴜᴄᴛɪᴏɴ (Page %page%)"
rows: 6
items-per-page: 45
insert-item-gui:
title: "&8ɪɴꜱᴇʀᴛ ɪᴛᴇᴍ"
type: hopper
sounds:
open-gui: "BLOCK_AMETHYST_BLOCK_CHIME"
click-button: "BLOCK_NOTE_BLOCK_PLING"
page-turn: "ITEM_BOOK_PAGE_TURN"
list-item: "ENTITY_PLAYER_LEVELUP"
purchase: "ENTITY_VILLAGER_YES"
error: "ENTITY_VILLAGER_NO"
cancel: "UI_BUTTON_CLICK"
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
✦ Support ✦
Have a question or found a bug?
DM me or leave a message on this thread — I'll respond as soon as possible.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
zenAuction — built with performance and aesthetics in mind.
