GrzybcioRynek

GrzybcioRynek is a Spigot/Paper plugin for Minecraft 26.2 that adds a player marketplace (auction house) with a graphical interface, Vault economy integration, and support for custom items from Nexo and Oraxen.

Players can list the item in their hand for sale, browse other players' listings in a categorized GUI with search, sorting and pagination, and purchase them using the server's currency. Sellers are paid automatically and receive sale notifications — including after reconnecting if they were offline.

Listings are stored in listings.yml. Extended data (history, mailbox, favorites, alerts, ratings) is stored in market-data.yml. The plugin enforces limits (default: 10 listings per player), listing expiry (default: 7 days), market fees, anti-abuse checks, and safer transactions with transaction IDs and logging. Administrators can reload the config and manage listings.

Key features

• Market GUI with categories, search, sorting and pagination
• My listings, favorites, history, stats, seller profile
• Mailbox for expired / undelivered items
• Price alerts and seller ratings (1–5)
• Market fees and anti-abuse limits
• Vault economy — required for the plugin to run
• Nexo / Oraxen — proper saving and recreation of custom items
• PlaceholderAPI support (optional)
• Public API for other plugins (MarketAPI)
• Configurable messages, GUI layout (gui.yml), price limits and market settings
• Documentation wiki at wiki.grzybcio.pl

Commands

Command	Description
/market, /rynek, /ah	Opens the market GUI
/market sell <price>	Lists the item in hand
/market my / moje	Your active listings
/market search <query> / szukaj	Search listings
/market favorites / ulubione	Favorite listings
/market history / historia	Purchase / sale history
/market stats	Market statistics
/market mailbox / skrzynka	Market mailbox
/market alerts / alert	Price alerts
/market remove <id>	Removes your listing (admins: any listing)
/market reload	Reloads the configuration
/market admin …	Admin tools
/wystaw <price>	Shortcut to list an item
/aukcje, /rynek-gui, /ah-gui	Opens the market GUI

Requirements

• Spigot/Paper 26.2
• Vault + an economy plugin (e.g. EssentialsX Economy)
• Optional: Nexo, Oraxen, PlaceholderAPI

Permissions

Permission	Description	Default
market.use	Use the marketplace	everyone
market.sell	List items for sale	everyone
market.reload	Reload config	OP
market.admin	Manage the marketplace	OP

---

GrzybcioRynek to plugin Spigot/Paper dla Minecraft 26.2, który dodaje na serwer rynek graczy (aukcje) z graficznym interfejsem, integracją z ekonomią Vault oraz wsparciem dla przedmiotów z Nexo i Oraxen.

Gracze mogą wystawiać przedmiot trzymany w ręce na sprzedaż, przeglądać oferty innych w wygodnym GUI z kategoriami, wyszukiwaniem, sortowaniem i stronicowaniem, a także kupować przedmioty za serwerową walutę. Sprzedawca otrzymuje pieniądze automatycznie, a przy sprzedaży dostaje powiadomienie — także po ponownym wejściu na serwer, jeśli był offline.

Plugin zapisuje oferty w pliku listings.yml, a dane rozszerzone (historia, skrzynka, ulubione, alerty, oceny) w market-data.yml. Pilnuje limitów (domyślnie max. 10 ofert na gracza), wygasania ofert (domyślnie 7 dni), prowizji rynku, anty-abuse oraz bezpieczniejszych transakcji z ID i logami. Administratorzy mogą przeładować konfigurację i zarządzać ofertami.

Główne funkcje

• GUI rynku z kategoriami, wyszukiwaniem, sortowaniem i paginacją
• Moje oferty, ulubione, historia, statystyki, profil sprzedawcy
• Skrzynka odbiorcza dla wygasłych / niedostarczonych przedmiotów
• Alerty cenowe oraz oceny sprzedawców (1–5)
• Prowizja rynku i limity anty-abuse
• Ekonomia Vault — wymagana do działania pluginu
• Nexo / Oraxen — poprawne zapisywanie i odtwarzanie custom itemów
• PlaceholderAPI (opcjonalnie)
• Publiczne API dla innych pluginów (MarketAPI)
• Konfigurowalne wiadomości, układ GUI (gui.yml), limity cen i ustawienia rynku
• Dokumentacja wiki pod adresem wiki.grzybcio.pl

Komendy

Komenda	Opis
/market, /rynek, /ah	Otwiera GUI rynku
/market sell <cena>	Wystawia przedmiot z ręki
/market my / moje	Twoje aktywne oferty
/market search <fraza> / szukaj	Wyszukiwanie
/market favorites / ulubione	Ulubione oferty
/market history / historia	Historia zakupów / sprzedaży
/market stats	Statystyki rynku
/market mailbox / skrzynka	Skrzynka odbiorcza
/market alerts / alert	Alerty cenowe
/market remove <id>	Usuwa własną ofertę (admin: dowolną)
/market reload	Przeładowuje konfigurację
/market admin …	Narzędzia administracyjne
/wystaw <cena>	Skrót do wystawienia przedmiotu
/aukcje, /rynek-gui, /ah-gui	Otwiera GUI rynku

Wymagania

• Spigot/Paper 26.2
• Vault + plugin ekonomii (np. EssentialsX Economy)
• Opcjonalnie: Nexo, Oraxen, PlaceholderAPI

Uprawnienia

Uprawnienie	Opis	Domyślnie
market.use	Korzystanie z rynku	wszyscy
market.sell	Wystawianie przedmiotów	wszyscy
market.reload	Przeładowanie configu	OP
market.admin	Zarządzanie rynkiem	OP

---

Autor: Grzybcio · Wersja: 1.0.3 · Wiki: wiki.grzybcio.pl