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.

!Version !Minecraft !Java

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

Command	Description	Permission
/market (aliases: /m, /shop, /cmarket, /servershop)	Open the Market hub GUI	market.use
/market reload	Reload configuration and prices	market.admin.reload
/sell (alias: /s)	Open the sell interface	market.sell

Permissions

Node	Description	Default
market.use	Access the market hub GUI	true
market.server	Access the server shop	true
market.community	Access the community market (listings)	true
market.auctions	Access auctions	true
market.sell	Create fixed-price listings	true
market.auction	Create auctions	true
market.claim	Claim items from storage	true
market.admin	Access admin functions	op
market.admin.reload	Reload configuration and prices	op
market.*	Grants all Market permissions	op

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