Fees

Listing and sale fees — formula, min/max, sink-account, and what happens on error.

Compatible with: GrzybcioRynek 1.0.3Minecraft 26.2Web 0.1.0

Based on GrzybcioRynek 1.0.3 and web 0.1.0 source.

Section market-fee in config.yml. Calculation: ConfigManager.calculateListingFee / calculateSaleFee. Result rounded to 2 places: Math.round(fee * 100.0) / 100.0.

Formula

fee = price * (percent / 100)
if fee < minimum-fee → minimum-fee
if maximum-fee > 0 and fee > maximum-fee → maximum-fee
if enabled == false → 0

maximum-fee: 0 means no cap, not “fee = 0”.

Default

yaml

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

With defaults: listing free, sale 5%, no min/max, fee burned.

Listing fee

Taken from the lister before the listing hits YAML. Insufficient funds: item stays in hand, fee.not-enough-listing. Success: fee.listing.

Listing-fee is not deposited to sink-account — it disappears from the player's account (Vault withdraw). On listing-creation exception: item returns, fee is deposited back.

Sale fee

Buyer pays full price. Seller receives max(0, round(price - fee, 2)).

Preview: Confirm (gui.confirm.fee, gui.confirm.seller-net) and fee.sale-preview in Detail lore.

Sink

yaml

sink-account: "skarbiec"

Empty / whitespace = sale fee goes nowhere (burn). Non-empty: VaultHook.depositAccount(sink, fee) after SELLER_PAID. Failed sink = warning in log, TX still goes to COMPLETED.

The account must exist in the economy plugin (Vault). This plugin does not create the account.

Disabling

enabled: false zeroes both fees without changing percentages in YAML.

Example 10% with cap

yaml

market-fee:
  enabled: true
  listing-fee-percent: 0.0
  sale-fee-percent: 10.0
  minimum-fee: 1.0
  maximum-fee: 250.0
  sink-account: "serwer"

Listing at 100 → fee 10 (above min 1). Listing at 10000 → fee 250 (cap).

Limits

Expiration