Market

A unified, GUI-only marketplace for Paper/Purpur 1.21.x — combining a Server Shop, a player-to-player Community Market, and Auctions in a single hub.

Market gives your economy three complementary ways to trade, all driven entirely through inventory menus — no chat commands to memorize, no signs to place.

Features

• Server Shop — buy and sell (almost) any item at server-set prices. A configurable buy/sell spread (default: server pays 25% on sells) encourages real player-to-player trading.
• Community Market — players create fixed-price listings that other players browse and buy through the GUI.
• Auctions — start timed auctions with bidding and optional buyout, protected by configurable anti-snipe extensions.
• Sell tools — sell from hand, sell all of a material, sell a whole container via the Sell Chest button (15-second selection timer), multi-select percentage selling, and safe shulker-box selling that never destroys contents.
• Taxes — separate configurable tax rates for market sales and auction sales.
• Item blacklist — block materials (command blocks, spawners, bedrock, etc.) and name/lore keywords from being traded.
• Dual economy backend — prefers MultiBank (native async, integer-cent precision) and falls back to Vault (EssentialsX, CMI, or any Vault economy). Selectable via auto, multibank, or vault mode.
• Optional integrations (soft, reflection-based, no hard dependency): PlayerSettings (per-player language), BuildersDream, LandClaim, DeathChest, and ToolMods (mod-aware sell bonuses).
• Notifications for sales, outbids, auction wins, and expirations.
• Storage — SQLite by default or MySQL (HikariCP pooled), all queries parameterized.

Commands

Permissions

Configuration

Key sections of config.yml:

economy:
  currency-symbol: "$"
  # auto = try providers in priority order; multibank / vault = force one
  mode: "auto"
  priority:
    - "MultiBank"
    - "Vault"
  # MultiBank account that server-shop funds flow to/from (create it in MultiBank first)
  server-account-id: "server-shop"
  taxes:
    market-tax: 5.0     # seller pays, fixed-price sales
    auction-tax: 7.5    # seller pays, auction sales

market:
  max-listings-per-player: 20
  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

server-shop:
  default-sell-multiplier: 0.25   # sell price = buy price * multiplier
  full-inventory-action: drop     # drop | cancel
  max-transaction-quantity: 2304

database:
  type: sqlite                    # sqlite | mysql

The full file also covers per-durations, GUI sounds, notifications, sell-inventory tools, shulker selling, and ToolMods sell bonuses.

Installation

1. Requires Paper or Purpur 1.21.x and Java 21.
2. Install an economy provider: either MultiBank, or Vault together with a Vault economy plugin (EssentialsX, CMI, etc.).
3. Drop Market-1.0.0.jar into your server's plugins/ folder.
4. Start the server to generate config.yml, then adjust prices, taxes, and the economy mode to taste.
5. If using MultiBank for the server shop, create the account named by economy.server-account-id.
6. Run /market reload after editing configuration.

Dependencies

• Economy (one required): MultiBank or Vault + a Vault economy plugin.
• Optional integrations: PlayerSettings, BuildersDream, LandClaim, DeathChest, ToolMods — all detected at runtime; none are required.

Support / Source

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