First Setup

First changes in config.yml, /market and /wystaw commands, and reloading configuration.

Compatible with: GrzybcioRynek 1.0.3Minecraft 26.2Web 0.1.0

Based on GrzybcioRynek 1.0.3 and web 0.1.0 source.

For the administrator with a ready JAR: after the first start you edit plugins/GrzybcioRynek/config.yml, check /market, and list an item with /wystaw or /market sell. You do not need JDK or Gradle.

1. Open `config.yml`

Keys most often touched when starting a server:

yaml

settings:
  max-listings-per-player: 10
  listing-expiry-days: 7
  gui-rows: 6          # ŁADOWANE, NIEUŻYWANE — rozmiar GUI jest w gui.yml
  min-price: 1.0
  max-price: 1000000.0

market-fee:
  enabled: true
  listing-fee-percent: 0.0
  sale-fee-percent: 5.0
  minimum-fee: 0.0
  maximum-fee: 0.0
  sink-account: ""

Warning

settings.gui-rows does not change the browse row count. Change browse.size in gui.yml.

Leave history.enabled, favorites.enabled, price-alerts.enabled, mailbox.enabled, ratings.enabled, and anti-abuse.enabled as true until you want to turn a specific feature off. stats.enabled is loaded and never checked.

2. Messages

Texts are in the same file, under messages.*. Prefix example:

yaml

messages:
  prefix: "&8[&bGrzybcioRynek&8] &7"
  no-permission: "Nie masz uprawnień do tego!"
  sell:
    success: "Wystawiono przedmiot &e{item} &7za &a{price}"

Do not create messages.yml — the plugin does not read it.

3. Join the server and open the market

A player with market.use (default true):

/market
/rynek
/ah
/aukcje

All of these commands open the browse GUI (fixed-price). /aukcje does not start bidding.

4. List an item

Take an item in hand. You need market.use and market.sell (both default: true).

/wystaw 100
/market sell 100
/market sprzedaj 100

The price must be between min-price and max-price. When listing-fee-percent > 0, Vault charges a listing fee. Listing limit: max-listings-per-player.

Cancel chat input (search, alert, rating, relist): cancel or anuluj.

5. Reload configuration

/market reload

Requires market.reload or market.admin (both default: op).

Danger

Reload is blocked when reserved listings exist (someone is mid-purchase). Message: Trwają aktywne transakcje — spróbuj ponownie za chwilę.

Reload saves storage, backs up listings.yml and market-data.yml, reloads config.yml + gui.yml, and clears expired listings.

6. Quick checklist

Paper 26.2, Vault, economy — plugin enabled.
min-price / max-price / listing limit set for the server economy.
/market opens the GUI.
/wystaw <cena> creates a listing.
/market reload after editing YAML (when nobody is buying).

Installation

Vault Setup