GrzybcioRynek

# 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 (https://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 (https://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 a