# Auction<\/p>\n
A clean, GUI-first Auction House plugin for **Paper 1.21+** using **Vault** for economy.
\nDesigned to be lightweight, permission-minimal, and easy for both players and developers.<\/p>\n
—<\/p>\n
## Requirements<\/p>\n
– **Paper**: 1.21+
\n– **Vault** (plugin)
\n– **A Vault-compatible economy plugin** (e.g., EssentialsX)<\/p>\n
> Vault does **not** store balances. You must install an economy provider.<\/p>\n
—<\/p>\n
## Commands<\/p>\n
### `\/ah`
\nOpens the global Auction House GUI.<\/p>\n
### `\/ah sell – Item must not be `AIR` ### `\/ah storage` ### `\/ah resell` ### `\/ah – Case-sensitive matching ### `\/ah search – No `minecraft:` namespace required Examples: —<\/p>\n ## Premium Features<\/p>\n Permission: Premium unlocks: Relist spam protection: —<\/p>\n ## GUI Overview<\/p>\n ### Auction House GUI Listing lore formatting: ### Confirm Purchase GUI Purchase logic: ### Auction Storage GUI Status display: —<\/p>\n ## Sounds<\/p>\n – Successful listing: \u201cding\u201d sound —<\/p>\n ## Configuration<\/p>\n Key config options include: *(Exact keys depend on your current shipped config.yml.)*<\/p>\n —<\/p>\n ## Installation<\/p>\n 1. Drop into `plugins\/`: —<\/p>\n ## Troubleshooting<\/p>\n ### Vault installed but economy not working ### \u201cInvalid plugin.yml\u201d Have fun<\/p>\n","protected":false},"excerpt":{"rendered":" Simple premium auction house plugin<\/p>\n","protected":false},"featured_media":172392,"template":"","meta":{"_minecraft_slug":"xiaoklunar-auction-house","_minecraft_project_id":"g4JvXts3","_minecraft_author":"Xiaoklunar","_minecraft_license":"LicenseRef-All-Rights-Reserved","_minecraft_downloads":142,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"xiaoklunar-auction-house.zip","_minecraft_size_bytes":106684,"_minecraft_version_count":2,"_minecraft_updated_at":"2026-05-15T18:47:54.157849Z","_minecraft_date_created":"2026-01-25T01:04:46.459971Z","_minecraft_date_modified":"2026-01-25T09:25:01.878890Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/xiaoklunar-auction-house","_minecraft_icon_attachment_id":172392,"_minecraft_imported_at":"2026-06-09T22:02:51+00:00","_minecraft_import_hash":"89926d6318eeb31d59c6a3e134743b06","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,844,126,127,92],"mod_loader":[130,132],"minecraft_version":[62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-172391","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-bukkit","mod_category-economy","mod_category-management","mod_category-paper","mod_category-utility","mod_loader-bukkit","mod_loader-paper","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n
\nLists the item currently in the player\u2019s hand for sale.<\/p>\n
\n– Item must not be blocked by config
\n– Price must be within configured limits
\n– Listing limit enforced (normal vs premium)<\/p>\n
\nOpens **Auction Storage**, showing:
\n– Active listings (click to cancel)
\n– Cancelled \/ expired returns (click to claim)
\n– Delivery overflow items (when inventory was full on purchase)<\/p>\n
\nRelists eligible stored items (premium feature + cooldown).<\/p>\n
\nOpens a view showing **only listings by that exact seller name**.<\/p>\n
\n– Does not validate whether the name belongs to a real player
\n– If no listings exist, GUI opens empty<\/p>\n
\nSearches auction listings by keyword.<\/p>\n
\n– Matches:
\n – Material key\/name (e.g., `iron_ingot`)
\n – Display name (custom items like \u201cBulldozer\u201d \/ \u201cDrill\u201d)<\/p>\n
\n– `\/ah search iron`
\n– `\/ah search net`
\n– `\/ah search note block 500` *(premium price filter)*<\/p>\n
\n– `auctionhouse.premium`<\/p>\n
\n– Increased listing limit (default: 20 vs 10)
\n– `\/ah resell` and \u201cRelist All\u201d button
\n– Advanced search price filter (max price argument)
\n– Cooldown on relist (default: 60s)<\/p>\n
\n– \u201cWait X seconds\u201d message is throttled to **max once per second** per player.<\/p>\n
\n– Paginated
\n– Edge glass border
\n– Buttons:
\n – **Refresh** (nether star)
\n – **Storage** (chest)
\n – **Prev\/Next page** arrows (hidden when not usable)<\/p>\n
\n– Seller name: **Yellow**
\n– Price: **Green**
\n– Expires in: **Red**
\n– Lore is **non-italic**<\/p>\n
\n– Click listing \u2192 confirm screen:
\n – Green: Buy
\n – Red: Cancel (returns to `\/ah`)<\/p>\n
\n– Checks balance **before** opening confirmation
\n– On successful buy:
\n – Money is withdrawn
\n – Item delivered to inventory
\n – If inventory full \u2192 moved to storage as delivery overflow<\/p>\n
\n– Title: **Auction Storage**
\n– Shows:
\n – Active listings (cancelable)
\n – Cancelled returns
\n – Expired returns
\n – Overflow deliveries
\n– Back arrow returns to main `\/ah`<\/p>\n
\n– Cancelled: red
\n– Expired: red
\n– Delivery: yellow<\/p>\n
\n– Listing denied (limit reached \/ not allowed): villager \u201cno\u201d
\n– Successful purchase: villager \u201cyes\u201d
\n– Seller receives notification + sound on successful sale<\/p>\n
\n– Listing limits for normal\/premium
\n– Maximum sell price
\n– Premium relist cooldown
\n– Blocked item list
\n– GUI sound toggles (if present in your build)<\/p>\n
\n – Vault
\n – Economy plugin (e.g., EssentialsX)
\n – Xiaoklunar Auction
\n2. Start server
\n3. Configure `config.yml`
\n4. Assign premium permission (optional)
\n – Example (LuckPerms):
\n “`
\n \/lp group premium permission set auctionhouse.premium true
\n “`<\/p>\n
\nVault needs an economy provider (EssentialsX, etc.). Check console for economy registration logs.<\/p>\n
\nYAML must use spaces (no tabs) and usage strings should be quoted.<\/p>\n