EzAuction is a modern, extensible Minecraft auction plugin for Bukkit/Spigot servers. It features a user-friendly GUI, robust API, and comprehensive event system for both server owners and plugin developers.
Version 2.0.0 introduced enhanced GUI navigation, detailed confirmation dialogs, and full compatibility with EzShops 2.0.0+. Version 2.2.0 adds Team Auctions, team-scoped listings visible and purchasable only by your team, powered by the optional TeamsAPI soft-dependency. Version 2.3.0 overhauls the live auction engine — sellers queue items directly from the browser GUI, players bid via the /bid command with clickable chat suggestions, per-player countdown preferences persist across restarts, and a new Claim GUI shows pending return items with configurable expiry dates. Version 2.3.1 hardens live-auction settlement safety by refunding winner escrow if seller payout fails.
- Java 21 or higher (Adoptium)
- Paper server 1.21+ (Bukkit/Spigot compatible)
- Download the latest EzAuction JAR from the releases page.
- Place the JAR in your server's
plugins/directory. - Start or reload your server.
- Configure the plugin as needed (see below).
- Intuitive auction GUI for browsing, buying, and selling
- Buy/sell items with in-game currency
- Configurable listing rules, durations, and permissions
- Search, filter, and sort auction listings
- Expiry and auto-removal of old listings
- Customizable messages and GUI appearance
- Full event and API support for developers
- Multi-language support (via config)
- NEW in 2.0: EzShops 2.0.0+ integration support
- NEW in 2.0: Enhanced navigation with Back buttons and search tips
- NEW in 2.0: Quick access to pending returns via Claims button
- NEW in 2.0: Low-price warnings in confirmation dialogs
- NEW in 2.0: Consolidated "My Activity" menu
- Actively maintained and open source
- NEW in 2.0.1 Orders-Only Mode
If you only want the Orders feature (buy orders, no auction house), set
orders-only-mode: trueinorders-only.yml. This disables all auction house features and enables the/ordersand/ordercommands for players to create and manage buy orders. - NEW in 2.2.0: Team Auctions — team-scoped listings visible and purchasable only by members of the seller's team. Requires the optional TeamsAPI soft-dependency. Toggle with
team-auctions.enabledinauction.yml. - NEW in 2.3.0: Live Auction Overhaul — dedicated
/bidcommand (alias/livebid), clickable bid suggestions in chat, item hover previews, per-player countdown preferences via EzCountdown (optional), opt-in chat filter, and five new Bukkit events. - NEW in 2.3.0: Live Auction Seller Management — queue items for the live auction directly from the browser GUI or
/liveauction sell. Receive queue-position feedback on enqueue, cancel your entry via the GUI or/liveauction cancel, and admins can force-cancel active auctions with/liveauction cancel <id>. - NEW in 2.3.0: Live Auctions shortcut in Auction House — a quick-access beacon button (slot 47) in the main
/auctionbrowser opens the Live Auction picker directly. - NEW in 2.3.0: Claim GUI —
/auction claimand the Claims button now open a 54-slot GUI showing each pending return item with its expiry date. A Claim All button collects everything; a Back button returns to the browser. Expiry is configurable viaclaim.expiry-daysinauction.yml(default 7 days). - FIXED in 2.3.0: First-bid minimum — the opening bid on a live auction now only requires the starting price; the increment applies to subsequent bids only. An empty
/bidresponse automatically places the minimum. - FIXED in 2.3.1: Live auction escrow safety — if the economy plugin fails to credit a seller at auction end, the winner is now refunded automatically and the item is returned to the seller.
Default configuration files are generated on first run in plugins/EzAuction/.
Key configuration options in config.yml:
listing-max-duration: Maximum time (in hours) a listing can stay activelisting-fee: Flat or percentage fee for creating a listingcurrency-type: Vault, XP, or custom economymax-listings-per-player: Limit the number of active listings per playerallow-bidding: Enable/disable bidding (if supported)gui-title: Customize the auction GUI titlelanguage: Set the plugin language (seelang/folder)
After editing, reload the plugin or restart the server to apply changes.
Orders-Only Mode Command:
| Command | Description | Permission |
|---|---|---|
/orders |
Open the Orders (buy orders) menu | ezauction.auction.order |
When orders-only-mode is enabled, all other auction commands are disabled.
Main Commands:
| Command | Description | Permission |
|---|---|---|
/auction |
Open the auction browser GUI | ezauction.use |
/auction sell <price> |
List held item for sale | ezauction.sell |
/auction cancel |
Cancel your active listing | ezauction.cancel |
/auction reload |
Reload plugin configuration | ezauction.admin.reload |
/auction history [player] |
View your auction history (or another player's, if permitted) | ezauction.auction.history / ezauction.auction.history.others |
/auction team |
Browse team-scoped auction listings | ezauction.auction.team |
/auction team sell |
List held item as a team auction | ezauction.auction.team.sell |
/liveauction |
Open the live auction viewer | ezauction.live |
/liveauction sell |
Queue held item for the live auction | ezauction.auction.live.sell |
/liveauction cancel |
Cancel your own queued live auction entry | ezauction.auction.live.sell |
/liveauction cancel <id> |
Force-cancel an active live auction (admin) | ezauction.auction.live.admin |
/bid [amount] |
Place a bid or view session status in a live auction | ezauction.bid |
Key Permissions:
-
ezauction.use: Access the auction GUI -
ezauction.sell: List items for sale -
ezauction.cancel: Cancel own listings -
ezauction.admin.*: All admin permissions -
ezauction.auction.history: View your own auction history in the GUI -
ezauction.auction.history.others: View other players' auction history (if permitted) -
ezauction.auction.team: Browse team-scoped auction listings (hidden when disabled or TeamsAPI absent) -
ezauction.auction.team.sell: Create team-scoped listings via/auction team sell -
ezauction.auction.live.sell: Queue items for live auction and cancel own entries -
ezauction.auction.live.admin: Force-cancel active live auctions by ID -
ezauction.bid: Place bids and manage notification preferences via/bid
See the docs/permissions.md for a full list.
Full documentation is available at ez-plugins.github.io/ezauction.
- Getting Started - Installation and first setup
- Configuration - All config files explained
- Commands & Permissions - Full command and permission reference
- Developer API & Events - Public API and custom Bukkit events
- Integrations - Discord, TeamsAPI, EzShops
- Changelog - Version history and notable changes
AuctionOperationResult result = auctionManager.createListing(player, itemStack, price, duration);
if (result.success()) {
// Listing created
} else {
player.sendMessage(result.message());
}@EventHandler
public void onAuctionListingCreate(AuctionListingCreateEvent event) {
// Custom logic here
}Contributions are welcome! Please see CONTRIBUTING.md for guidelines, or open an issue/PR.
- For help, open an issue on GitHub or contact the maintainers.
- Feature requests and bug reports are encouraged.
EzAuction is licensed under the MIT License. Copyright (c) 2026 Gyvex (63536625).
For full documentation, see the docs/ folder. For support, open an issue or contact the maintainers.