**EzAuction** is a fully-featured Minecraft auction house plugin for Paper, Spigot, Purpur, and Bukkit servers. Players list items for timed sale, create reserve-balance buy orders, and browse the live market through a smooth, paginated GUI – all backed by Vault economy, MySQL or YAML persistence, PlaceholderAPI support, and optional Discord webhook notifications.<\/p>\n
Whether you’re running a survival, skyblock, or factions server, EzAuction gives players a click-friendly, permission-controlled marketplace with timed listings, offline-safe returns, enchantment search, live broadcast auctions, and team auction support through TeamsAPI.<\/p>\n
| | |
\n|—|—|
\n| **Platforms** | Paper, Spigot, Purpur, Bukkit 1.13 \u2013 26.1.* |
\n| **Java** | 21+ |
\n| **Storage** | YAML (built-in) \u00b7 MySQL |
\n| **Languages** | English \u00b7 Dutch \u00b7 Spanish \u00b7 Chinese |
\n| **Dependencies** | Vault + any economy plugin |<\/p>\n
> **Requires Vault and a compatible economy plugin such as EzEconomy to process currency.**<\/p>\n
## Why Use EzAuction?
\n– **Menu-first trading** \u2013 Paginated browsers, sell\/order editors, and confirmation popups keep every transaction guided and click-friendly.
\n– **Listings + buy orders** \u2013 Run timed sales, reserve balance for buy requests, and fulfill either side straight from the GUI or command flow.
\n– **Team auctions** \u2013 TeamsAPI integration lets team members co-list and co-claim auctions, perfect for faction and skyblock economies.<\/p>\n
<\/p>\n
– **Async persistence & fallbacks** \u2013 Listings and history write through dedicated executors, automatically falling back to YAML storage if MySQL is unreachable.
\n– **Offline-safe returns** \u2013 Expired or undeliverable items go to a claimable stash with login reminders and `\/auction claim` recovery.
\n– **Rank-aware limits** \u2013 Plug in a custom `AuctionListingLimitResolver` service to scale slot caps with ranks, islands, or progression data.
\n– **Smart value overlays** \u2013 Surface configured price hints or pipe in EzShops buy\/sell estimates directly into menu lore.<\/p>\n
## Feature Highlights
\n– **Configurable menus & translations** \u2013 Override browser\/confirm layouts, filler glass, and button text across the bundled English, Dutch, Spanish, and Chinese menu files.
\n– **Flexible storage** \u2013 Start on lightweight YAML or flip to production-ready MySQL with connection pooling, SSL flags, and table prefixes.
\n– **Asynchronous history** \u2013 Background save queues batch player history writes to keep gameplay responsive, even during heavy auction traffic.
\n– **Player protections** \u2013 Deposit refunds, balance checks, expiry sweeps, and inventory-aware delivery prevent dupes and lost currency.
\n– **PlaceholderAPI support** \u2013 Drop `%ezauction_*%` placeholders into scoreboards, holograms, or chat to surface active listings, orders, limits, and pending returns.
\n– **Integration-ready API** \u2013 Register Bukkit services to override listing caps or provide custom value providers without forking the plugin.
\n– **Enchant-aware search** \u2013 Search `sharpness v`, `fortune 3`, or `minecraft:looting` to find listings and buy orders carrying exact enchantment stacks – supports roman numerals, numeric levels, namespaced keys, and underscore\/space variants.
\n– **Shulker box previews** \u2013 Buyers can inspect shulker contents directly from the auction browser before purchasing.<\/p>\n
## Discord Integration 1. Open the target Discord channel \u2192 **Edit Channel** \u2192 **Integrations** \u2192 **Webhooks** \u2192 **New Webhook** \u2192 **Copy Webhook URL**. “`yml For the full DiscordSRV integration guide and all options, see the Discord integration docs. ## Hologram Features “`yml ## Quick Start ## Live Auctions ## Commands & Permissions ## Setup Guide<\/p>\n **Need more details?** See the full documentation for all YAML, MySQL, menu, and advanced settings options.<\/p>\n ### Requirements ### Configuration Overview ### Optional Integrations ### Network Setup (Bungee\/Velocity) – EzAuction ships with `menu-layout_*.yml` and `menu-interactions_*.yml` bundles for English, Dutch, Spanish, and Chinese (`_en`, `_nl`, `_es`, `_zh`). “`java import com.skyblockexp.ezauction.api.AuctionListingLimitResolver; public final class AuctionLimitPlugin extends JavaPlugin {<\/p>\n @Override AuctionListingLimitResolver resolver = (sellerId, baseLimit) -> { Bukkit.getServicesManager().register( @Override “`yml “`yml This companion plugin registers before EzAuction enables and adds any configured bonus slots per player UUID on top of EzAuction’s base limit. Update the UUID keys or compute the bonus however you like to reflect your network’s progression rules. #### auction.yml #### auction-storage.yml #### auction-values.yml ## Support & Links —<\/p>\n **Ready to add an auction house to your Minecraft server?**<\/p>\n Deploy EzAuction today – a polished, GUI-driven auction house plugin for Paper, Spigot, Purpur, and Bukkit. Download, drop in the jar, configure Vault, and your players are trading in minutes.<\/p>\n","protected":false},"excerpt":{"rendered":" Menu-first marketplace with listings, buy orders, and async safety nets<\/p>\n","protected":false},"featured_media":67542,"template":"","meta":{"_minecraft_slug":"ezauction","_minecraft_project_id":"VaEk7CuZ","_minecraft_author":"Shadow48402","_minecraft_license":"MIT","_minecraft_downloads":1586,"_minecraft_follows":3,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"ezauction.zip","_minecraft_size_bytes":31613254,"_minecraft_version_count":6,"_minecraft_updated_at":"2026-05-16T07:03:47.601325Z","_minecraft_date_created":"2025-12-28T22:43:17.376606Z","_minecraft_date_modified":"2026-05-11T22:08:54.928458Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/ezauction","_minecraft_icon_attachment_id":67542,"_minecraft_imported_at":"2026-06-03T20:39:47+00:00","_minecraft_import_hash":"024741874b8542c41cbd3572acc5856d","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,844,88,89,126,90,127,128,129,92],"mod_loader":[130,132,133,134],"minecraft_version":[339,340,341,357,359,360,379,382,385,438,446,449,110,111,112,113,114,115,116,117,118,119,120,46,47,48,49,50,51,52,53,54,55,56,57,58,59,36,60,93,94,101,102,62,37,40,41,73,74,38,78,79,80,81,82,21,13,14,15,16,17,18,19,20,22,23,24,25,26,27,28,29,30,31,860,861,862,863,864,83,167,163],"class_list":["post-67541","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-bukkit","mod_category-economy","mod_category-equipment","mod_category-game-mechanics","mod_category-management","mod_category-optimization","mod_category-paper","mod_category-purpur","mod_category-spigot","mod_category-utility","mod_loader-bukkit","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","minecraft_version-1-10","minecraft_version-1-10-1","minecraft_version-1-10-2","minecraft_version-1-11","minecraft_version-1-11-1","minecraft_version-1-11-2","minecraft_version-1-12","minecraft_version-1-12-1","minecraft_version-1-12-2","minecraft_version-1-13","minecraft_version-1-13-1","minecraft_version-1-13-2","minecraft_version-1-14","minecraft_version-1-14-1","minecraft_version-1-14-2","minecraft_version-1-14-3","minecraft_version-1-14-4","minecraft_version-1-15","minecraft_version-1-15-1","minecraft_version-1-15-2","minecraft_version-1-16","minecraft_version-1-16-1","minecraft_version-1-16-2","minecraft_version-1-16-3","minecraft_version-1-16-4","minecraft_version-1-16-5","minecraft_version-1-17","minecraft_version-1-17-1","minecraft_version-1-18","minecraft_version-1-18-1","minecraft_version-1-18-2","minecraft_version-1-19","minecraft_version-1-19-1","minecraft_version-1-19-2","minecraft_version-1-19-3","minecraft_version-1-19-4","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","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","minecraft_version-1-7-10","minecraft_version-1-7-2","minecraft_version-1-7-3","minecraft_version-1-7-4","minecraft_version-1-7-5","minecraft_version-1-7-6","minecraft_version-1-7-7","minecraft_version-1-7-8","minecraft_version-1-7-9","minecraft_version-1-8","minecraft_version-1-8-1","minecraft_version-1-8-2","minecraft_version-1-8-3","minecraft_version-1-8-4","minecraft_version-1-8-5","minecraft_version-1-8-6","minecraft_version-1-8-7","minecraft_version-1-8-8","minecraft_version-1-8-9","minecraft_version-1-9","minecraft_version-1-9-1","minecraft_version-1-9-2","minecraft_version-1-9-3","minecraft_version-1-9-4","minecraft_version-26-1","minecraft_version-26-1-1","minecraft_version-26-1-2"],"yoast_head":"\n
\n– **Standalone webhook** \u2013 Post colour-coded embed notifications to any Discord channel by pasting a webhook URL into `discord.yml`. No DiscordSRV or bot setup required.
\n– **DiscordSRV support** \u2013 Optionally route notifications through an existing DiscordSRV installation with optional account-linking and role-gating per event.
\n– **Four event types** \u2013 Receive a message whenever an auction is listed, sold, bid on, or cancelled, each styled with its own accent colour (green \/ blue \/ yellow \/ red).
\n– **Live admin commands** \u2013 Configure, enable, disable, and test the webhook in-game with `\/auctiondiscord webhook` – changes take effect instantly without a restart.
\n– **Async & non-blocking** \u2013 All HTTP calls run on a background thread; a failed delivery is logged at WARNING level and never interrupts gameplay.<\/p>\nDiscord Webhook Quick Setup<\/summary>\n
\n2. In-game or via console, run:
\n “`
\n \/auctiondiscord webhook set url https:\/\/discord.com\/api\/webhooks\/YOUR_ID\/YOUR_TOKEN
\n “`
\n3. Verify with `\/auctiondiscord webhook test` – a test embed will appear in your channel immediately.<\/p>\n
\n# discord.yml – webhook section
\nwebhook:
\n enabled: true
\n url: “https:\/\/discord.com\/api\/webhooks\/123456789\/YOURTOKEN”
\n username: “EzAuction”
\n use-embeds: true
\n events:
\n auction_start: true
\n auction_end: true
\n auction_bid: true
\n auction_cancel: true
\n“`<\/p>\n
\n<\/details>\n
\n– **Auction holograms** \u2013 Place interactive holograms in the world to display live auction stats, top listings, or buy order summaries. Supports click\/touch interaction for quick info and future actions.
\n– **Performance optimized** \u2013 Configurable max hologram count and batch update options ensure smooth gameplay even with many holograms active.
\n– **Permission and proximity controls** \u2013 Optionally restrict hologram visibility and interaction by permission node or player proximity (distance).
\n– **Configurable types** \u2013 Choose which auction stats or listings to display via hologram type selection.<\/p>\nHologram Configuration<\/summary>\n
\nholograms:
\n enabled: true
\n update-interval-ticks: 100
\n search-radius: 2.5
\n height-offset: 1.75
\n max-holograms: 100
\n batch-update: true
\n require-permission: false # Set true to require a permission node
\n view-permission: ezauction.hologram.view # Permission node for viewing\/interacting
\n proximity-limit: false # Set true to restrict by distance
\n proximity-distance: 32.0 # Max distance for interaction
\n“`
\n<\/details>\n
\n1. Upload `EzAuction.jar`, restart your Paper or Purpur server, and confirm Vault plus an economy plugin are active.
\n2. Edit `plugins\/EzAuction\/auction.yml` for pricing rules, durations, and GUI slots, adjust `auction-storage.yml` for YAML\/MySQL persistence, and update `auction-values.yml` or `messages\/menu-interactions_*.yml` as needed.
\n3. Choose between YAML or MySQL storage, then grant players `ezauction.auction` (and optional sell\/order\/history nodes) so they can browse and trade.
\n4. Encourage `\/auction history` so buyers and sellers can audit their latest activity right from chat.<\/p>\n
\n– **Queue the spotlight listings** \u2013 Flip `live-auctions.enabled` on (and `queue-enabled` if you want a rolling lineup) so fresh sales are staged for broadcast and visible through `\/auction live`.
\n– **Hype them in chat** \u2013 Keep `display-in-chat` enabled to announce the next queued listing every `announcement-interval-ticks` ticks using your Vault currency formatting.
\n– **Curate from the live menu** \u2013 The Live Auctions GUI shows queue position, seller names, price summaries, and quick actions to refresh or jump back into the main browser.<\/p>\n
\n| Command | Description | Permission |
\n|———|————-|————|
\n| `\/auction` | Open the auction browser, claim items, and cancel listings. | ezauction.auction |
\n| `\/auction sell
\n| `\/auction order
\n| `\/auction cancel [id]` | Review and cancel active listings or buy orders. | ezauction.auction |
\n| `\/auction history [buy\/sell]` | Show the latest transactions for each category. | ezauction.auction.history |
\n| `\/auction live` | Preview upcoming live auction broadcasts and refresh the queue. | ezauction.auction.live |
\n| `\/auction claim` | Withdraw stored return items. | ezauction.auction |
\n| `\/auction search
\n| `\/auctionhologram Installation & Configuration<\/summary>\n
\n| Requirement | Notes |
\n|————-|——-|
\n| Java 21+ | Matches the Paper 1.21+ API target used by EzAuction. |
\n| Paper \/ Spigot \/ Purpur 1.21+ | The plugin relies on Paper-compatible server APIs. |
\n| Vault | Provides the economy bridge for deposits, buy orders, and payouts. |
\n| Economy plugin (recommended: EzEconomy) | A Vault-compatible provider is required. EzEconomy is recommended for best compatibility and modern features. |
\n| Optional: EzShops | Unlock live value overlays via `values.mode = ezshops-buy` or `ezshops-sell`. |
\n| Optional: Custom limit resolver | Expose `AuctionListingLimitResolver` as a Bukkit service to scale listing caps. |
\n| Optional: Menu localisation overrides | Duplicate the bundled `_nl`, `_es`, or `_zh` menu files to keep translations in sync with your branding. |<\/p>\n
\n– **Storage selection** \u2013 Toggle `storage.type` between `yaml` and `mysql`; MySQL connections support SSL flags and pool tuning.
\n– **Menus** \u2013 `menu.browser` and `menu.confirm` control inventory sizes, filler panes, and navigation slots across all language variants.
\n– **Sell & order editors** \u2013 Configure default price suggestions and click adjustments for both listing and buy-order editors.
\n– **Listing rules** \u2013 Clamp durations, enforce minimum pricing, schedule custom duration options, and reserve refundable deposits, with automatic executor-based expiry sweeps.
\n– **Menu interactions** \u2013 Tweak click increments, confirmation buttons, and chat prompts through `messages\/menu-interactions_*.yml` per locale.
\n– **Live auctions** \u2013 Manage `live-auctions.enabled`, `queue-enabled`, `display-in-chat`, and `announcement-interval-ticks` to stage listings for announcements or GUI previews.
\n– **Value display** \u2013 Display configured material prices or EzShops-sourced estimates, templated through `values.format`.<\/p>\n
\n– Expose a custom `AuctionListingLimitResolver` service to scale listing caps with ranks, islands, or other progression data.
\n– Install EzShops so the auction browser can display buy or sell prices directly in listing lore when configured.
\n– Install PlaceholderAPI to unlock `%ezauction_*%` placeholders for leaderboards, scoreboards, or Discord relays.<\/p>\n
\n1. Switch `storage.type` to `mysql` and point each Paper\/Purpur backend to the same credentials so listings, buy orders, and returns are stored centrally. The bundled MySQL driver implements `DistributedAuctionListingStorage` so inserts and claims remain atomic across servers.
\n2. Drop the same `EzAuction.jar` on every gameplay server behind your proxy, then copy a single set of tuned configs (`auction.yml`, `auction-storage.yml`, `messages\/*.yml`) to keep menus, limits, and language consistent network-wide.
\n3. Restart each backend (avoid \/reload) after editing the configs so every instance warms its cache from MySQL before players join. The manager only serves listings once storage is marked ready.
\n4. If a lobby should not show auctions, leave EzAuction off that node or point it at a different `table-prefix` so it maintains a separate pool.
\n5. Confirm every server shares the same Vault economy provider or synchronised balance backend. Currency withdrawals happen locally, so mismatched economy data across nodes can desync deposits and reserved funds.
\n<\/details>\nBundled menu translations<\/summary>\n
\n– Copy any bundle to another locale tag (for example `_de`) to introduce custom language support without touching code.
\n– Keep button text consistent across languages so navigation slots and confirmation buttons remain aligned with the GUI configuration.
\n<\/details>\nCustom listing limit resolver example<\/summary>\n
\npackage com.example.auctionlimits;<\/p>\n
\nimport org.bukkit.Bukkit;
\nimport org.bukkit.plugin.ServicePriority;
\nimport org.bukkit.plugin.java.JavaPlugin;<\/p>\n
\n public void onEnable() {
\n saveDefaultConfig();<\/p>\n
\n int bonus = getConfig().getInt(“extra-slots.” + sellerId.toString(), 0);
\n return Math.max(0, baseLimit + bonus);
\n };<\/p>\n
\n AuctionListingLimitResolver.class,
\n resolver,
\n this,
\n ServicePriority.Normal
\n );
\n }<\/p>\n
\n public void onDisable() {
\n Bukkit.getServicesManager().unregisterAll(this);
\n }
\n}
\n“`<\/p>\n
\nname: AuctionLimitPlugin
\nversion: 1.0.0
\nmain: com.example.auctionlimits.AuctionLimitPlugin
\nloadbefore: [EzAuction]
\n“`<\/p>\n
\n# plugins\/AuctionLimitPlugin\/config.yml
\nextra-slots:
\n 123e4567-e89b-12d3-a456-426614174000: 2
\n 2a2f4982-0c7a-4f13-86a1-4f85c4a94cf7: 4
\n“`<\/p>\n
\n<\/details>\nConfiguration at a Glance<\/summary>\n
\n“`yml
\nstorage:
\n type: yaml # or mysql
\n mysql:
\n host: localhost
\n port: 3306
\n database: skyblock
\n username: root
\n password: secret
\n use-ssl: true
\n table-prefix: ezauction_
\n pool:
\n maximum-pool-size: 10
\n minimum-idle: 2
\n connection-timeout-millis: 10000
\n idle-timeout-millis: 600000
\n max-lifetime-millis: 1800000
\nmenu:
\n browser:
\n title: “&2Auction House &7({page}\/{total_pages})”
\n size: 54
\n filler:
\n material: GRAY_STAINED_GLASS_PANE
\n display-name: “&8 ”
\n navigation:
\n previous-slot: 45
\n close-slot: 49
\n next-slot: 53
\n empty-listing-slot: 22
\n confirm:
\n title: “&2Confirm Purchase”
\n size: 27
\n filler:
\n material: GRAY_STAINED_GLASS_PANE
\n display-name: “&8 ”
\n confirm-slot: 11
\n listing-slot: 13
\n cancel-slot: 15
\nlistings:
\n default-duration-hours: 24
\n max-duration-hours: 72
\n minimum-price: 10.0
\n listing-deposit-percent: 5.0
\n max-listings-per-player: 3
\nlive-auctions:
\n enabled: false
\n queue-enabled: true
\n display-in-chat: true
\n announcement-interval-ticks: 200
\nvalues:
\n enabled: false
\n format: “&7Value: &6{value}”
\n materials:
\n diamond: 2500.0
\n“`<\/p>\n
\n“`yml
\ntype: yaml # or mysql
\nmysql:
\n host: localhost
\n port: 3306
\n database: skyblock
\n username: root
\n password: secret
\n use-ssl: true
\n table-prefix: ezauction_
\n pool:
\n maximum-pool-size: 10
\n minimum-idle: 2
\n connection-timeout-millis: 10000
\n idle-timeout-millis: 600000
\n max-lifetime-millis: 1800000
\n“`<\/p>\n
\n“`yml
\nenabled: false
\nmode: configured # or ezshops-buy \/ ezshops-sell
\nformat: “&7Value: &6{value}”
\nmaterials:
\n diamond: 2500.0
\n“`
\n<\/details>\n
\n– **Discord:** Join the EzPlugins server for help, bug reports, and release announcements.
\n– **Documentation:** ez-plugins.github.io\/ezauction
\n– **EzEconomy** – Modern Vault economy plugin, recommended for best compatibility.
\n– **EzShops** – Dynamic player shops and GUI, integrates with EzAuction value overlays.<\/p>\n