{"id":41527873,"url":"https://github.com/ez-plugins/ezshops","last_synced_at":"2026-05-14T00:02:12.411Z","repository":{"id":333949783,"uuid":"1134809500","full_name":"ez-plugins/EzShops","owner":"ez-plugins","description":"Advanced shop plugin with all your server shop needs - Free to use","archived":false,"fork":false,"pushed_at":"2026-05-11T02:46:42.000Z","size":613,"stargazers_count":5,"open_issues_count":0,"forks_count":4,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-11T04:43:44.069Z","etag":null,"topics":["bukkit-plugin","economy","minecraft-plugin","modrinth-plugin","shop-plugin"],"latest_commit_sha":null,"homepage":"https://ez-plugins.github.io/EzShops/","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":null,"dco":null,"cla":null}},"created_at":"2026-01-15T08:31:08.000Z","updated_at":"2026-05-11T02:46:46.000Z","dependencies_parsed_at":null,"dependency_job_id":"6db8e2e9-2ffb-4f54-9922-515e6ca666a7","html_url":"https://github.com/ez-plugins/EzShops","commit_stats":null,"previous_names":["ez-plugins/ezshops"],"tags_count":18,"template":false,"template_full_name":null,"purl":"pkg:github/ez-plugins/EzShops","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ez-plugins%2FEzShops","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ez-plugins%2FEzShops/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ez-plugins%2FEzShops/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ez-plugins%2FEzShops/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ez-plugins","download_url":"https://codeload.github.com/ez-plugins/EzShops/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ez-plugins%2FEzShops/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33004768,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-13T13:14:54.681Z","status":"ssl_error","status_checked_at":"2026-05-13T13:14:51.610Z","response_time":115,"last_error":"SSL_read: 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":["bukkit-plugin","economy","minecraft-plugin","modrinth-plugin","shop-plugin"],"created_at":"2026-01-23T22:29:28.635Z","updated_at":"2026-05-14T00:02:12.404Z","avatar_url":"https://github.com/ez-plugins.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"# EzShops\n\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)\n[![Java](https://img.shields.io/badge/java-21%2B-blue)](https://adoptium.net/)\n[![Release](https://img.shields.io/github/v/release/ez-plugins/EzShops)](https://github.com/ez-plugins/EzShops/releases/latest)\n[![Stars](https://img.shields.io/github/stars/ez-plugins/EzShops?style=social)](https://github.com/ez-plugins/EzShops/stargazers)\n[![Issues](https://img.shields.io/github/issues/ez-plugins/EzShops)](https://github.com/ez-plugins/EzShops/issues)\n[![CI](https://github.com/ez-plugins/EzShops/actions/workflows/ci.yml/badge.svg)](https://github.com/ez-plugins/EzShops/actions)\n[![Docs](https://github.com/ez-plugins/EzShops/actions/workflows/docs.yml/badge.svg)](https://ez-plugins.github.io/EzShops)\n[![Modrinth](https://img.shields.io/modrinth/v/zaW55ehx?label=modrinth\u0026color=00AF5C)](https://modrinth.com/plugin/ezshops)\n\n**EzShops** is a modern, feature-rich Minecraft shop plugin for Paper 1.21+ servers. It provides guided storefront menus, dynamic pricing, rotating daily specials, sign shop mirroring, player-run marketplaces, a live stock market system, and team-based shop bonuses via [TeamsAPI](https://modrinth.com/plugin/teams-api).\n\n---\n\n## 📑 Table of Contents\n- [Requirements](#-requirements)\n- [Installation](#-installation)\n- [Features](#-features)\n- [Configuration](#️-configuration)\n- [Permissions \u0026 Commands](#️-permissions--commands)\n- [Documentation](#-documentation)\n- [Usage Examples](#️-usage-examples)\n- [Contributing](#-contributing)\n- [Support \u0026 Community](#️-support--community)\n- [License](#-license)\n\n---\n\n## 📦 Requirements\n- Java 21 or higher ([Adoptium](https://adoptium.net/))\n- Paper / Purpur / Folia 1.21.4+\n- [Vault](https://www.spigotmc.org/resources/vault.34315/) + a compatible economy plugin\n- *(Optional)* [TeamsAPI ≥ 1.4.1](https://modrinth.com/plugin/teams-api) for team shop features\n\n## 🚀 Installation\n1. Download the latest EzShops JAR from the releases page.\n2. Place the JAR in your server's `plugins/` directory.\n3. Ensure Vault and a compatible economy plugin are installed.\n4. Start or reload your server.\n5. Configure the plugin as needed (see below).\n\n## ✨ Features\n- **Guided storefront menus** - Category icons, quantity pickers, bulk buttons, and lore templates\n- **Smart price automation** - Dynamic buy/sell multipliers that adjust after each transaction\n- **Rotating daily specials** - Schedule weighted or sequential rotations from `shop/rotations/`\n- **Sign shop mirroring** - Sync right-click signs with menu entries and customize headers/formats\n- **Specialty entries** - Sell spawners with correct block states, minion/vote crate keys\n- **Player-run marketplaces** - `[shop]` signs convert into owner-branded listings from linked chests\n- **Stock market system** - Real-time pricing based on supply/demand with admin controls\n- **Category commands** - Run server commands when clicking category icons (warps, info, etc.)\n- **Live config reload** - Use `/shop reload` to instantly reload configurations\n- **Multi-language support** - Bundled with English, Spanish, Dutch, and Chinese translations\n- **TeamsAPI integration** - Role-based sell multipliers \u0026 buy discounts, shared team treasury, and pooled stock for faction servers\n\n## ⚙️ Configuration\nDefault configuration files are generated on first run in `plugins/EzShops/`.\n\n**Key configuration options in `config.yml`:**\n\n- `language`: Set the plugin language (en, es, nl, zh)\n- `player-shops.enabled`: Toggle player shop system\n- `stock-market.enabled`: Enable/disable stock market features\n- `dynamic-pricing.enabled`: Enable automatic price adjustments\n\nShop categories, items, and rotations are configured in the `shop/` subdirectory.\n\nSee the [Configuration Guide](docs/configuration.md) for full details.\n\n## 🛡️ Permissions \u0026 Commands\n\n**Main Commands:**\n\n| Command                | Description                        | Permission                |\n|------------------------|------------------------------------|---------------------------|\n| `/shop`                | Open the shop GUI                  | `ezshops.shop`            |\n| `/shop buy \u003citem\u003e`     | Buy items from chat                | `ezshops.shop.buy`        |\n| `/shop sell \u003citem\u003e`    | Sell items from chat               | `ezshops.shop.sell`       |\n| `/sellhand`            | Sell item in hand                  | `ezshops.shop.sell`       |\n| `/sellinventory`       | Sell all sellable items            | `ezshops.shop.sell`       |\n| `/price \u003cmaterial\u003e`    | Check shop price                   | `ezshops.shop`            |\n| `/playershop`          | Create player shop sign            | `ezshops.playershop.create` |\n| `/stock buy \u003citem\u003e \u003camount\u003e` | Buy stock market item    | `ezshops.stock.view`      |\n| `/stock sell \u003citem\u003e \u003camount\u003e` | Sell stock market item  | `ezshops.stock.view`      |\n| `/teamshop`             | Open team shop dashboard           | `ezshops.teamshop`        |\n| `/teamshop treasury`    | View/deposit/withdraw team funds   | `ezshops.teamshop`        |\n| `/teamshop stocks`      | Browse team shared stock           | `ezshops.teamshop`        |\n\nSee the [Commands](docs/commands.md) and [Permissions](docs/permissions.md) documentation for complete lists.\n\n## 📚 Documentation\n\nFull documentation is available at **\u003chttps://ez-plugins.github.io/EzShops\u003e**.\n\n| Page | Description |\n|------|-------------|\n| [Commands](https://ez-plugins.github.io/EzShops/commands) | All commands and their usage |\n| [Permissions](https://ez-plugins.github.io/EzShops/permissions) | All permissions and defaults |\n| [Configuration](https://ez-plugins.github.io/EzShops/configuration) | Complete configuration reference |\n| [Shops](https://ez-plugins.github.io/EzShops/shops) | Pagination, price IDs, dynamic pricing, stock market |\n| [Integrations](https://ez-plugins.github.io/EzShops/integrations) | Vault, EzBoost, EzAuction, TeamsAPI, Adventure |\n| [API Reference](https://ez-plugins.github.io/EzShops/api) | Public classes, methods, and integration examples |\n| [MiniMessage](https://ez-plugins.github.io/EzShops/minimessage) | Text formatting guide |\n\n## 🛠️ Usage Examples\n\n### Opening the Shop\nPlayers can use `/shop` to open the main shop GUI. Admins can reload configuration with `/shop reload`.\n\n### Using the Stock Market\n```\n/stock buy DIAMOND 10  - Purchase 10 shares of DIAMOND at current price\n/stock sell DIAMOND 5  - Sell 5 shares of DIAMOND\n/stock info DIAMOND    - View current price and recent changes\n/stock list            - List all stock market items\n```\n\n### Creating a Player Shop\n1. Use `/playershop` to configure your shop\n2. Set quantity and pricing through the setup menu\n3. Place a `[shop]` sign linked to a chest with your items\n\n---\n\n## 🤝 Contributing\nContributions are welcome! Please see [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines, or open an issue/PR.\n\n## 🛡️ Support \u0026 Community\n- For help, open an issue on GitHub or contact the maintainers\n- Feature requests and bug reports are encouraged\n- Join our [Discord server](https://discord.gg/yWP95XfmBS)\n\n## 📄 License\nEzShops is licensed under the [MIT License](LICENSE). Copyright (c) 2026 ez-plugins.\n\n---\n\nFor full documentation, visit [ez-plugins.github.io/EzShops](https://ez-plugins.github.io/EzShops). For support, open an issue or join the [Discord](https://discord.gg/yWP95XfmBS).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fez-plugins%2Fezshops","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fez-plugins%2Fezshops","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fez-plugins%2Fezshops/lists"}