{"id":35369854,"url":"https://github.com/ez-plugins/ezauction","last_synced_at":"2026-05-12T00:01:57.374Z","repository":{"id":331957342,"uuid":"1126243630","full_name":"ez-plugins/EzAuction","owner":"ez-plugins","description":"Free auction plugin with advanced configuration options","archived":false,"fork":false,"pushed_at":"2026-05-11T22:08:52.000Z","size":503,"stargazers_count":3,"open_issues_count":0,"forks_count":1,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-11T22:27:14.679Z","etag":null,"topics":["auction","auction-house","minecraft","papermc-plugin","plugin","spigotmc-plugin"],"latest_commit_sha":null,"homepage":"https://ez-plugins.github.io/EzAuction/","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ez-plugins.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2026-01-01T13:29:21.000Z","updated_at":"2026-05-11T22:05:57.000Z","dependencies_parsed_at":null,"dependency_job_id":"d11a8d24-5fa9-4415-adfe-55a02df32684","html_url":"https://github.com/ez-plugins/EzAuction","commit_stats":null,"previous_names":["ez-plugins/ezauction"],"tags_count":7,"template":false,"template_full_name":null,"purl":"pkg:github/ez-plugins/EzAuction","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ez-plugins%2FEzAuction","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ez-plugins%2FEzAuction/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ez-plugins%2FEzAuction/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ez-plugins%2FEzAuction/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ez-plugins","download_url":"https://codeload.github.com/ez-plugins/EzAuction/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ez-plugins%2FEzAuction/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32917885,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-11T17:09:15.040Z","status":"ssl_error","status_checked_at":"2026-05-11T17:08:45.420Z","response_time":120,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["auction","auction-house","minecraft","papermc-plugin","plugin","spigotmc-plugin"],"created_at":"2026-01-02T02:45:05.193Z","updated_at":"2026-05-12T00:01:57.357Z","avatar_url":"https://github.com/ez-plugins.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"# EzAuction\r\n\r\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)\r\n[![Build](https://github.com/ez-plugins/ezauction/actions/workflows/ci.yml/badge.svg)](https://github.com/ez-plugins/ezauction/actions/workflows/ci.yml)\r\n[![codecov](https://codecov.io/gh/ez-plugins/ezauction/graph/badge.svg)](https://codecov.io/gh/ez-plugins/ezauction)\r\n[![Java](https://img.shields.io/badge/java-21%2B-blue)](https://adoptium.net/)\r\n\r\n**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.\r\n\r\n**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](https://modrinth.com/plugin/teams-api) soft-dependency.\r\n\r\n---\r\n\r\n## 📑 Table of Contents\r\n- [EzAuction](#ezauction)\r\n  - [📑 Table of Contents](#-table-of-contents)\r\n  - [📦 Requirements](#-requirements)\r\n  - [🚀 Installation](#-installation)\r\n    - [New Installation](#new-installation)\r\n  - [✨ Features](#-features)\r\n  - [⚙️ Configuration](#️-configuration)\r\n  - [🛡️ Permissions \\\u0026 Commands](#️-permissions--commands)\r\n  - [📚 Documentation](#-documentation)\r\n  - [🛠️ Usage Examples](#️-usage-examples)\r\n    - [Creating a Listing](#creating-a-listing)\r\n    - [Listening for Events](#listening-for-events)\r\n  - [🤝 Contributing](#-contributing)\r\n  - [🛡️ Support \\\u0026 Community](#️-support--community)\r\n  - [📄 License](#-license)\r\n\r\n---\r\n\r\n## 📦 Requirements\r\n- Java 21 or higher ([Adoptium](https://adoptium.net/))\r\n- Paper server 1.21+ (Bukkit/Spigot compatible)\r\n\r\n## 🚀 Installation\r\n\r\n### New Installation\r\n1. Download the latest EzAuction JAR from the [releases page](https://github.com/ez-plugins/ezauction/releases).\r\n2. Place the JAR in your server's `plugins/` directory.\r\n3. Start or reload your server.\r\n4. Configure the plugin as needed (see below).\r\n\r\n## ✨ Features\r\n- Intuitive auction GUI for browsing, buying, and selling\r\n- Buy/sell items with in-game currency\r\n- Configurable listing rules, durations, and permissions\r\n- Search, filter, and sort auction listings\r\n- Expiry and auto-removal of old listings\r\n- Customizable messages and GUI appearance\r\n- Full event and API support for developers\r\n- Multi-language support (via config)\r\n- **NEW in 2.0**: EzShops 2.0.0+ integration support\r\n- **NEW in 2.0**: Enhanced navigation with Back buttons and search tips\r\n- **NEW in 2.0**: Quick access to pending returns via Claims button\r\n- **NEW in 2.0**: Low-price warnings in confirmation dialogs\r\n- **NEW in 2.0**: Consolidated \"My Activity\" menu\r\n- Actively maintained and open source\r\n- **NEW in 2.0.1** Orders-Only Mode\r\n  If you only want the Orders feature (buy orders, no auction house), set `orders-only-mode: true` in `orders-only.yml`. This disables all auction house features and enables the `/orders` and `/order` commands for players to create and manage buy orders.\r\n- **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](https://github.com/ez-plugins/teams-api) soft-dependency. Toggle with `team-auctions.enabled` in `auction.yml`.\r\n\r\n## ⚙️ Configuration\r\nDefault configuration files are generated on first run in `plugins/EzAuction/`.\r\n\r\n**Key configuration options in `config.yml`:**\r\n\r\n- `listing-max-duration`: Maximum time (in hours) a listing can stay active\r\n- `listing-fee`: Flat or percentage fee for creating a listing\r\n- `currency-type`: Vault, XP, or custom economy\r\n- `max-listings-per-player`: Limit the number of active listings per player\r\n- `allow-bidding`: Enable/disable bidding (if supported)\r\n- `gui-title`: Customize the auction GUI title\r\n- `language`: Set the plugin language (see `lang/` folder)\r\n\r\nAfter editing, reload the plugin or restart the server to apply changes.\r\n\r\n## 🛡️ Permissions \u0026 Commands\r\n\r\n**Orders-Only Mode Command:**\r\n\r\n| Command   | Description                        | Permission                |\r\n|-----------|------------------------------------|---------------------------|\r\n| `/orders` | Open the Orders (buy orders) menu  | `ezauction.auction.order` |\r\n\r\nWhen `orders-only-mode` is enabled, all other auction commands are disabled.\r\n\r\n**Main Commands:**\r\n\r\n| Command                | Description                        | Permission                |\r\n|------------------------|------------------------------------|---------------------------|\r\n| `/auction`             | Open the auction browser GUI       | `ezauction.use`           |\r\n| `/auction sell \u003cprice\u003e`| List held item for sale            | `ezauction.sell`          |\r\n| `/auction cancel`      | Cancel your active listing         | `ezauction.cancel`        |\r\n| `/auction reload`      | Reload plugin configuration        | `ezauction.admin.reload`  |\r\n| `/auction history [player]` | View your auction history (or another player's, if permitted) | `ezauction.auction.history` / `ezauction.auction.history.others` |\r\n| `/auction team`             | Browse team-scoped auction listings                           | `ezauction.auction.team`                                          |\r\n| `/auction team sell`        | List held item as a team auction                              | `ezauction.auction.team.sell`                                     |\r\n\r\n**Key Permissions:**\r\n\r\n- `ezauction.use`: Access the auction GUI\r\n- `ezauction.sell`: List items for sale\r\n- `ezauction.cancel`: Cancel own listings\r\n- `ezauction.admin.*`: All admin permissions\r\n\r\n- `ezauction.auction.history`: View your own auction history in the GUI\r\n- `ezauction.auction.history.others`: View other players' auction history (if permitted)\r\n- `ezauction.auction.team`: Browse team-scoped auction listings (hidden when disabled or TeamsAPI absent)\r\n- `ezauction.auction.team.sell`: Create team-scoped listings via `/auction team sell`\r\n\r\nSee the [docs/permissions.md](docs/permissions.md) for a full list.\r\n\r\n## 📚 Documentation\r\n\r\nFull documentation is available at **[ez-plugins.github.io/ezauction](https://ez-plugins.github.io/ezauction)**.\r\n\r\n- [Getting Started](https://ez-plugins.github.io/ezauction/getting-started) - Installation and first setup\r\n- [Configuration](https://ez-plugins.github.io/ezauction/configuration) - All config files explained\r\n- [Commands \u0026 Permissions](https://ez-plugins.github.io/ezauction/reference/commands) - Full command and permission reference\r\n- [Developer API \u0026 Events](https://ez-plugins.github.io/ezauction/reference/api) - Public API and custom Bukkit events\r\n- [Integrations](https://ez-plugins.github.io/ezauction/integrations) - Discord, TeamsAPI, EzShops\r\n- [Changelog](CHANGELOG.md) - Version history and notable changes\r\n\r\n## 🛠️ Usage Examples\r\n\r\n### Creating a Listing\r\n```java\r\nAuctionOperationResult result = auctionManager.createListing(player, itemStack, price, duration);\r\nif (result.success()) {\r\n    // Listing created\r\n} else {\r\n    player.sendMessage(result.message());\r\n}\r\n```\r\n\r\n### Listening for Events\r\n```java\r\n@EventHandler\r\npublic void onAuctionListingCreate(AuctionListingCreateEvent event) {\r\n    // Custom logic here\r\n}\r\n```\r\n\r\n---\r\n\r\n## 🤝 Contributing\r\nContributions are welcome! Please see [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines, or open an issue/PR.\r\n\r\n## 🛡️ Support \u0026 Community\r\n- For help, open an issue on GitHub or contact the maintainers.\r\n- Feature requests and bug reports are encouraged.\r\n\r\n## 📄 License\r\nEzAuction is licensed under the [MIT License](LICENSE). Copyright (c) 2026 Gyvex (63536625).\r\n\r\n---\r\n\r\nFor full documentation, see the [docs/](docs/) folder. For support, open an issue or contact the maintainers.\r\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fez-plugins%2Fezauction","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fez-plugins%2Fezauction","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fez-plugins%2Fezauction/lists"}