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.

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

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

Permissions

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