GrzybcioRynek

GrzybcioRynek is a Spigot/Paper plugin for Minecraft 1.21 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 pagination, and purchase items 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. The plugin enforces limits (default: 10 listings per player), listing expiry (default: 7 days), and safe transactions with rollback on failure. Administrators can reload the config and remove other players' listings.

Key features

• Market GUI with categories: Tools, Blocks, Combat, Other
• Listing items from hand (/market sell, /wystaw)
• Purchases with a confirmation GUI
• Vault economy — required for the plugin to run
• Nexo / Oraxen — proper saving and recreation of custom items
• Listing expiry — expired items are returned to the seller's inventory
• Sale notifications — instant when online, queued when offline
• Configurable messages, price limits, and market settings

Commands

Command	Description
/market, /rynek, /ah	Opens the market GUI
/market sell <price>	Lists the item in hand
/market remove <id>	Removes your listing (admins: any listing)
/market reload	Reloads the configuration
/wystaw <price>	Shortcut to list an item
/aukcje, /rynek-gui, /ah-gui	Opens the market GUI

Requirements

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

Permissions

Permission	Description	Default
market.use	Use the marketplace	everyone
market.sell	List items for sale	everyone
market.reload	Reload config	OP
market.admin	Remove other players' listings	OP

---

GrzybcioRynek to plugin Spigot/Paper dla Minecraft 1.21, który dodaje na serwer rynek graczy (aukcje domowe) 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 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, pilnuje limitów (domyślnie max. 10 ofert na gracza), wygasania ofert (domyślnie 7 dni) oraz bezpiecznych transakcji z rollbackiem w razie błędu. Administratorzy mogą przeładować konfigurację i usuwać cudze oferty.

Główne funkcje

• GUI rynku z kategoriami: Narzędzia, Bloki, Walka, Inne
• Wystawianie przedmiotów z ręki (/market sell, /wystaw)
• Zakup z potwierdzeniem w osobnym oknie GUI
• Ekonomia Vault — wymagana do działania pluginu
• Nexo / Oraxen — poprawne zapisywanie i odtwarzanie custom itemów
• Wygasanie ofert — po upływie czasu przedmiot wraca do ekwipunku sprzedawcy
• Powiadomienia o sprzedaży — online od razu, offline po wejściu na serwer
• Konfigurowalne wiadomości, limity cen i ustawienia rynku

Komendy

Komenda	Opis
/market, /rynek, /ah	Otwiera GUI rynku
/market sell <cena>	Wystawia przedmiot z ręki
/market remove <id>	Usuwa własną ofertę (admin: dowolną)
/market reload	Przeładowuje konfigurację
/wystaw <cena>	Skrót do wystawienia przedmiotu
/aukcje, /rynek-gui, /ah-gui	Otwiera GUI rynku

Wymagania

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

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	Usuwanie cudzych ofert	OP

---

Autor: Grzybcio · Wersja: 1.0.1