A professional, production-ready **GUI-only marketplace plugin** for Minecraft Paper 1.21+.<\/p>\n
Players can create fixed-price listings and auctions, browse, buy, bid, claim items, and withdraw earnings \u2014 all through intuitive GUIs. **No complex commands to learn!**<\/p>\n
## \u2728 Features<\/p>\n
### \ud83d\uded2 Fixed-Price Market
\n– Create listings with custom prices and durations
\n– Browse paginated listings with sorting
\n– Safe atomic purchases to prevent double-buying
\n– Configurable taxes on sales<\/p>\n
### \ud83d\udd28 Auction System
\n– Start auctions with minimum bid and optional buyout price
\n– **Anti-snipe protection** extends auction when bids arrive near the end
\n– Bid history and automatic outbid notifications
\n– Safe handling of auction endings and payouts<\/p>\n
### \ud83d\udce6 Claim Storage
\n– Items from expired listings go to claim storage
\n– Won auction items are safely delivered
\n– Handles full inventories gracefully<\/p>\n
### \ud83d\udcb0 Earnings Management
\n– Pending earnings from sales accumulate
\n– Withdraw all earnings at once
\n– Complete transaction history<\/p>\n
### \ud83d\udd10 Admin Features (GUI-based)
\n– View all listings and auctions
\n– Remove any listing or cancel auctions
\n– Force-end auctions
\n– Reload configuration in-game<\/p>\n
### \ud83c\udfae Intuitive GUI Flow
\nThe creation flow for listings and auctions:
\n1. **Main Menu** – Central hub for all actions
\n2. **Select Item** – Click an item from your inventory
\n3. **Select Quantity** – Choose how many to sell (for stackable items)
\n4. **Settings** – Set price and duration with easy click-to-adjust controls
\n5. **Confirm** – Review and create your listing\/auction<\/p>\n
## \ud83d\udccb Requirements<\/p>\n
| Requirement | Version |
\n|————-|———|
\n| **Server** | Paper 1.21+ (or Purpur, Folia-compatible forks) |
\n| **Java** | Java 21+ |
\n| **Economy** | Vault + economy plugin **OR** EssentialsX |<\/p>\n
### Economy Support
\nCommunityMarket supports two economy configurations:<\/p>\n
1. **Vault + Economy Plugin** (Recommended)
\n – Install Vault
\n – Install an economy plugin: EssentialsX, CMI, or any Vault-compatible economy<\/p>\n
2. **EssentialsX Standalone** (Fallback)
\n – Install EssentialsX with economy enabled
\n – CommunityMarket will use EssentialsX directly if Vault is not present<\/p>\n
## \ud83d\udce5 Installation<\/p>\n
1. Download the latest `CommunityMarket-x.x.x.jar` from Modrinth
\n2. Place it in your server’s `plugins\/` folder
\n3. Ensure you have an economy system installed (see above)
\n4. Start or restart your server
\n5. Edit `plugins\/CommunityMarket\/config.yml` as needed
\n6. Use `\/market` to open the marketplace!<\/p>\n
## \ud83c\udfae Commands<\/p>\n
| Command | Alias | Description | Permission |
\n|———|——-|————-|————|
\n| `\/market` | `\/cmarket` | Opens the main market GUI | `communitymarket.use` |<\/p>\n
**That’s it!** Everything else is done through GUIs.<\/p>\n
## \ud83d\udd12 Permissions<\/p>\n
| Permission | Description | Default |
\n|————|————-|———|
\n| `communitymarket.*` | All permissions | op |
\n| `communitymarket.use` | Access the market GUI | everyone |
\n| `communitymarket.sell` | Create fixed-price listings | everyone |
\n| `communitymarket.auction` | Create auctions | everyone |
\n| `communitymarket.buy` | Purchase from the market | everyone |
\n| `communitymarket.bid` | Bid on auctions | everyone |
\n| `communitymarket.claim` | Claim items from storage | everyone |
\n| `communitymarket.withdraw` | Withdraw earnings | everyone |
\n| `communitymarket.admin` | Access admin functions | op |
\n| `communitymarket.admin.viewall` | View all listings\/auctions | op |
\n| `communitymarket.admin.remove` | Remove any listing\/auction | op |
\n| `communitymarket.admin.reload` | Reload configuration | op |<\/p>\n
## \u2699\ufe0f Configuration<\/p>\n
### config.yml Highlights<\/p>\n
“`yaml
\n# Language setting (available: en_US, pt_PT)
\nlanguage: en_US<\/p>\n
# Database: sqlite (default) or mysql
\ndatabase:
\n type: sqlite<\/p>\n
# Economy settings
\neconomy:
\n currency-format: “$#,##0.00”
\n taxes:
\n market-tax: 5.0 # Tax on fixed-price sales
\n auction-tax: 7.5 # Tax on auction sales<\/p>\n
# Fixed-Price Market
\nmarket:
\n max-listings-per-player: 20
\n default-duration-hours: 168 # 7 days
\n min-price: 1.0
\n max-price: 1000000000.0<\/p>\n
# Auctions
\nauction:
\n max-auctions-per-player: 10
\n default-duration-hours: 24
\n anti-snipe:
\n enabled: true
\n trigger-seconds: 30
\n extension-seconds: 30<\/p>\n
# GUI Settings
\ngui:
\n show-help-button: true # Toggle help button visibility
\n sounds:
\n click: UI_BUTTON_CLICK
\n success: ENTITY_PLAYER_LEVELUP
\n error: ENTITY_VILLAGER_NO
\n“`<\/p>\n
### Available Languages
\n– `en_US` – English (default)
\n– `pt_PT` – Portuguese<\/p>\n
Language files are located in `plugins\/CommunityMarket\/lang\/` and can be customized.<\/p>\n
## \ud83d\udd27 Troubleshooting<\/p>\n
### “No compatible economy provider found!”<\/p>\n
This error appears when CommunityMarket cannot find an economy system.<\/p>\n
**Solutions:**
\n1. **Install Vault + an economy plugin:**
\n – Download Vault
\n – Download EssentialsX or another economy plugin
\n – Restart your server<\/p>\n
2. **Using EssentialsX without Vault:**
\n – Make sure EssentialsX is installed and enabled
\n – Check that `economy` is not disabled in EssentialsX’s `config.yml`<\/p>\n
### Items stuck in claim storage<\/p>\n
If a player’s inventory was full when they purchased an item or won an auction, the item goes to their claim storage. They can retrieve it from the main menu \u2192 “Claim Items”.<\/p>\n
### Auctions not ending<\/p>\n
Auctions are checked periodically (every 5 seconds by default). If auctions seem stuck:
\n– Check server console for errors
\n– Verify the database is working properly
\n– Try `\/market admin` \u2192 View Auctions to see auction status<\/p>\n
### Database issues<\/p>\n
By default, CommunityMarket uses SQLite (no setup required). For larger servers, MySQL is recommended:<\/p>\n
“`yaml
\ndatabase:
\n type: mysql
\n mysql:
\n host: localhost
\n port: 3306
\n database: communitymarket
\n username: your_user
\n password: your_password
\n“`<\/p>\n
## \ud83d\udcdc License<\/p>\n
This project is licensed under the MIT License – see the [LICENSE]([LICENSE](https:\/\/github.com\/henriquescrrrr\/CommunityMarket\/main\/LICENSE)) file for details.<\/p>\n","protected":false},"excerpt":{"rendered":"
A professional, production-ready GUI-only marketplace plugin for Minecraft Paper 1.21+.<\/p>\n","protected":false},"featured_media":44693,"template":"","meta":{"_minecraft_slug":"communitymarket","_minecraft_project_id":"poNRu5DN","_minecraft_author":"roguiii","_minecraft_license":"MIT","_minecraft_downloads":91,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"communitymarket.zip","_minecraft_size_bytes":13629524,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-15T19:53:40.202591Z","_minecraft_date_created":"2026-01-25T01:04:34.059437Z","_minecraft_date_modified":"2026-01-15T12:52:28.287012Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/communitymarket","_minecraft_icon_attachment_id":44693,"_minecraft_imported_at":"2026-06-02T03:15:52+00:00","_minecraft_import_hash":"fcc8d1d1b5093d89568dc98c384eb7d3","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[87,844,127,128,867,92],"mod_loader":[132,133],"minecraft_version":[62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-44692","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-adventure","mod_category-economy","mod_category-paper","mod_category-purpur","mod_category-social","mod_category-utility","mod_loader-paper","mod_loader-purpur","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