CommunityMarket

A GUI-only community auction house for Paper/Purpur 1.21.x. Players list, browse, buy, and auction items entirely through inventory menus — one command opens everything.

!Version !Minecraft !Java

CommunityMarket is a focused, player-to-player marketplace: fixed-price listings and full auctions, with a claim-storage system so items and earnings are never lost when inventories are full.

Features

• Fixed-price listings — players list items at a set price; others browse and buy through the GUI.
• Auctions — timed auctions with bidding, buyout, minimum bid increments, and configurable anti-snipe extensions.
• Claim storage — items from sales, auction wins, and expired/returned listings wait safely in a claim menu.
• Pending earnings — sale proceeds accumulate and are withdrawn manually by the seller.
• Configurable taxes — separate rates for fixed-price sales and auction sales.
• Item blacklist — block materials and name/lore keywords from being listed.
• Notifications for sales, outbids, auction wins, and expirations.
• Economy via Vault (preferred) with a direct EssentialsX fallback.
• Storage — SQLite by default or MySQL (HikariCP pooled), fully async, with all queries parameterized.

Commands

Command	Description	Permission
/market (alias: /cmarket)	Open the Community Market main menu	communitymarket.use

Everything else — listing, buying, bidding, claiming, withdrawing, and admin actions — is done through the GUI.

Permissions

Node	Description	Default
communitymarket.use	Access the market GUI	true
communitymarket.sell	Create fixed-price listings	true
communitymarket.auction	Create auctions	true
communitymarket.buy	Purchase from the market	true
communitymarket.bid	Bid on auctions	true
communitymarket.claim	Claim items from storage	true
communitymarket.withdraw	Withdraw earnings	true
communitymarket.admin	Access admin functions	op
communitymarket.*	Grants all CommunityMarket permissions	op

Configuration

Key sections of config.yml:

economy:
  currency-symbol: "$"
  taxes:
    market-tax: 5.0     # seller pays, fixed-price sales
    auction-tax: 7.5    # seller pays, auction sales

market:
  max-listings-per-player: 20
  default-duration-hours: 168
  min-price: 1.0
  max-price: 1000000000.0

auction:
  max-auctions-per-player: 10
  min-bid-increment-percent: 5.0
  anti-snipe:
    enabled: true
    trigger-seconds: 30      # a bid this close to the end extends the auction
    extension-seconds: 30
    max-extensions: 10       # 0 = unlimited

database:
  type: sqlite               # sqlite | mysql

The full file also covers available durations, GUI sounds, notifications, and performance/cache intervals.

Installation

1. Requires Paper or Purpur 1.21.x and Java 21.
2. Install an economy provider: Vault together with a Vault economy plugin (EssentialsX, CMI, etc.), or EssentialsX on its own.
3. Drop CommunityMarket-1.0.0.jar into your server's plugins/ folder.
4. Start the server to generate config.yml, then adjust taxes, limits, and durations to taste.

If no economy provider is found on startup, the plugin logs clear guidance on what to install.

Dependencies

• Economy (required): Vault + a Vault economy plugin, or EssentialsX directly. Vault is listed as an optional dependency because the EssentialsX-direct path also works without Vault installed.

Support / Source

Source code: https://github.com/henriquescrrrr/carrageis-communitymarket