Commands
Syntax, aliases, permissions and errors for /market, /wystaw and /aukcje in GrzybcioRynek 1.0.3.
Based on GrzybcioRynek 1.0.3 and web 0.1.0 source.
Three command classes: MarketCommand (/market), WystawCommand (/wystaw), AukcjeCommand (/aukcje). Package: com.example.marketplace.commands. Plugin 1.0.3, Paper 26.2.
On start /market and /aukcje require market.use. Listing additionally requires market.sell. /wystaw requires both.
/aukcje does not start auctions. It opens the same browse GUI as /market. There are no bids or outbidding.
There is no /market buy command. Purchase is GUI only: browse → detail (MarketDetailGUI) → confirm (MarketConfirmGUI).
Overview
| Command | Aliases | Permission | What it does |
|---|---|---|---|
/market | ah, rynek | market.use | Opens browse GUI |
/market sell <price> | sprzedaj | market.sell | Lists item from main hand |
/market browse | przegladaj | market.use | Opens browse GUI |
/market remove <id> | usun | market.use (owner) or market.admin | Removes listing |
/market reload | — | market.reload or market.admin | Reloads config and data |
/market my | moje | market.use | Own listings GUI |
/market search <phrase> | szukaj | market.use | Browse with search filter |
/market favorites | ulubione | market.use | Favorites GUI — only when favorites.enabled |
/market history | historia | market.use | History GUI — only when history.enabled (command) |
/market stats | statystyki | market.use | Statistics GUI |
/market mailbox | skrzynka | market.use | Mailbox GUI |
/market alerts | alert | market.use | Alerts GUI — when price-alerts.enabled |
/market alerts add <phrase> <max-price> | alert add | market.use | Adds alert from chat |
/market admin … | — | market.admin | Administrator tools |
/wystaw <price> | — | market.use and market.sell | Same as /market sell |
/aukcje | rynek-gui, ah-gui | market.use | Opens browse GUI |
Console can run reload and admin. Other subcommands require a player (messages.player-only).
/market
Syntax: /market [subcommand]
Aliases: ah, rynek
Permission: market.use (checked in Java, default: true)
Examples:
/market
/rynek
/ah browse
Errors:
| Situation | Message |
|---|---|
Missing market.use | messages.no-permission |
| Console without player subcommand | messages.player-only |
| Unknown subcommand | messages.usage.main |
With no arguments opens MarketBrowseGUI.
/market sell / sprzedaj
Syntax: /market sell <price>
Aliases: sprzedaj
Permission: market.sell (after prior market.use)
Lists the entire main-hand stack at a fixed price. Listing ID comes from listings.yml → next-id (auto-increment).
Examples:
/market sell 1500
/market sprzedaj 99.99
Errors:
| Situation | Message |
|---|---|
Missing market.sell | messages.no-permission |
| Missing price | messages.usage.sell |
| Empty hand / AIR | messages.sell.air-item |
Price outside min-price…max-price or not a number | messages.sell.invalid-price ({min}, {max}) |
| Listing limit | messages.sell.limit-reached ({limit}) |
| Listing cooldown | messages.anti-abuse.cooldown ({seconds}) |
| Not enough money for listing fee | messages.fee.not-enough-listing ({fee}) |
| Hand changed mid-process | messages.sell.no-item |
Success: messages.sell.success ({item}, {price}). With listing fee also messages.fee.listing. Then price hint (messages.price-hint or price-hint-none).
/market browse / przegladaj
Syntax: /market browse
Aliases: przegladaj
Permission: market.use
Opens the same GUI as bare /market.
/market browse
/rynek przegladaj
/market remove / usun
Syntax: /market remove <id>
Aliases: usun
Permission: listing owner (market.use) or market.admin
Owner gets the item with mailbox reason removed. Admin returns the item to the seller with reason admin-removed. Favorites with that ID are cleared.
Examples:
/market remove 42
/market usun 42
Errors:
| Situation | Message |
|---|---|
| Missing / non-numeric ID | messages.usage.remove |
| Missing listing | messages.remove.not-found ({id}) |
| Not your listing and not admin | messages.remove.not-owner |
| Listing reserved (purchase in progress) | messages.buy.listing-locked |
Success: messages.remove.success ({id}).
/market reload
Syntax: /market reload
Permission: market.reload or market.admin (default: op)
Saves data, makes .bak, reloads config.yml + gui.yml, loads listings.yml + market-data.yml, clears expired listings.
Reload is blocked when reserved listings exist (reservedListings — purchase in progress). Message: Trwają aktywne transakcje — spróbuj ponownie za chwilę.
Success: messages.reload.success.
/market my / moje
Syntax: /market my
Aliases: moje
Permission: market.use
Opens MyListingsGUI (54 slots). Empty: messages.my.no-listings.
/market my
/rynek moje
/market search / szukaj
Syntax: /market search <phrase>
Aliases: szukaj
Permission: market.use
Opens browse with BrowseContext and phrase. Phrase may contain spaces (remaining arguments joined).
Examples:
/market search diament
/market szukaj enchanted book
Missing phrase: messages.usage.search.
Search from GUI (compass, slot 45) asks for phrase on chat (messages.search.prompt). Cancel: cancel or anuluj.
/market favorites / ulubione
Syntax: /market favorites
Aliases: ulubione
Permission: market.use (flag favorites.enabled, no separate permission in Java)
When favorites.enabled: false → messages.favorites.disabled. Otherwise FavoritesGUI.
Favorites button in browse (slot 51) checks the same flag.
/market history / historia
Syntax: /market history
Aliases: historia
Permission: market.use
history.enabled gates only this command. The History button in browse GUI (slot 53, BOOK) does not check the flag and always opens HistoryGUI.
When history.enabled: false, the command sends hardcoded text: Historia transakcji jest wyłączona. (not a messages.* key).
market.history from plugin.yml is not checked in Java.
/market stats / statystyki
Syntax: /market stats
Aliases: statystyki
Permission: market.use
Opens StatsGUI (27 slots). stats.enabled is loaded and unused — command and button (slot 49) work regardless of that flag.
/market mailbox / skrzynka
Syntax: /market mailbox
Aliases: skrzynka
Permission: market.use
Opens MailboxGUI. The command does not check mailbox.enabled or market.mailbox (plugin.yml permission unused in Java). Flag mailbox.enabled controls where the item goes on return — not whether the GUI opens.
/market alerts / alert
Syntax:
/market alerts
/market alerts add <phrase> <max-price>
Aliases: alert
Permission: market.use + flag price-alerts.enabled
Without add opens AlertsGUI. add saves the alert in market-data.yml.
Examples:
/market alerts
/market alert add diamentowy miecz 5000
Errors:
| Situation | Message |
|---|---|
price-alerts.enabled: false | messages.alerts.disabled |
add without phrase/price or bad number | messages.usage.alerts |
Limit price-alerts.max-per-player | messages.alerts.limit ({limit}) |
Success add: messages.alerts.created ({query}, {price}).
market.alerts from plugin.yml is not checked in Java.
/market admin
Syntax: /market admin <list|inspect|remove|forceexpire|refund|selftest|reload>
Permission: market.admin (default: op)
Without subcommand: syntax list on chat. Details: Admin Tools.
| Subcommand | Syntax |
|---|---|
list | /market admin list |
inspect | /market admin inspect <id> |
remove | /market admin remove <id> |
forceexpire | /market admin forceexpire <id> |
refund | /market admin refund <tx-id> [reclaim] |
selftest | /market admin selftest [seller] [buyer] |
reload | /market admin reload |
selftest without nicks spawns FakePlayer SellerBot / BuyerBot. Admin reload has the same lock on reserved listings.
/wystaw
Syntax: /wystaw <price>
Aliases: none
Permission: market.use and market.sell (both at once)
Same MarketManager.sellItem as /market sell. Empty hand: sell.no-item (when item == null) or sell.air-item. Missing price: messages.usage.wystaw.
/wystaw 250
/aukcje
Syntax: /aukcje
Aliases: rynek-gui, ah-gui
Permission: market.use
Opens MarketBrowseGUI on page 1. No arguments, auctions, or bids.
/aukcje
/rynek-gui
/ah-gui
Tab complete
With market.use suggested: sell, sprzedaj, browse, przegladaj, remove, usun, reload, my, moje, search, szukaj, favorites, ulubione, history, historia, stats, statystyki, mailbox, skrzynka, alerts, alert. admin only with market.admin.
What is missing
/market buy— purchase GUI only.- Separate auction command.
- Checking
market.history/market.mailbox/market.alertsin Java.