Przegląd
Rynek gracz–gracz na Paper i Spigot — GUI z kategoriami, wyszukiwarką, prowizjami i płatnościami przez Vault.
GrzybcioRynek zdejmuje z administracji obowiązek prowadzenia sklepu. Gracz wystawia przedmiot prosto z ekwipunku, ustala cenę, a reszta serwera przegląda oferty w GUI z kategoriami, wyszukiwarką, sortowaniem i stronicowaniem.
Płatność przechodzi przez ekonomię Vault, a pieniądze trafiają do sprzedawcy automatycznie — również wtedy, gdy akurat nie ma go na serwerze.
Na podstawie kodu 1.0.3
Ta sekcja opisuje GrzybcioRynek 1.0.3 na Paper 26.2 — wersję wydaną na Modrincie.
Publiczne repozytorium Grzybcio-plugins/GrzybcioRynek zawiera w tej chwili starszą wersję 1.0.0 — nie sugeruj się nim przy konfiguracji.
Co dostaje gracz
| Funkcja | Szczegóły |
|---|---|
| GUI rynku | Kategorie, wyszukiwarka, sortowanie, stronicowanie |
| Wystawianie | Cały stack z głównej ręki, za stałą cenę |
| Ulubione | Zapisywane po stronie serwera, dostępne z GUI i komendą |
| Alerty cenowe | Ping, gdy pojawi się oferta pasująca do frazy i ceny |
| Historia zakupów | Własne transakcje w osobnym GUI |
| Profile sprzedawców | Kto ile sprzedał i z jaką oceną |
| Oceny | Skala 1–5, po zakupie |
| Skrzynka | Przedmioty, które wygasły albo nie zmieściły się w ekwipunku |
Zakup wyłącznie przez GUI
Nie ma komendy /market buy. Droga zakupu to zawsze: przegląd → szczegóły oferty →
ekran potwierdzenia. To celowe — potwierdzenie pokazuje pełną cenę i prowizję, zanim
pieniądze zmienią właściciela.
/aukcje nie jest aukcją
Mimo nazwy /aukcje nie uruchamia licytacji. Otwiera dokładnie to samo GUI
przeglądania co /market. Nie ma bidów, przebijania ceny ani czasu do końca licytacji.
Co dostaje administrator
| Funkcja | Szczegóły |
|---|---|
| Prowizje | Od wystawienia i od sprzedaży, z minimum i sufitem |
| Konto skarbca | Prowizje mogą trafiać na wskazane konto Vault albo znikać |
| Zabezpieczenia | Cooldown wystawiania, limit zakupów od jednego gracza, sufit wartości transakcji |
| Narzędzia admina | Podgląd, usuwanie, wymuszone wygaśnięcie, refundacja, autotest |
| Wygasanie ofert | Automatyczne, z konfigurowalnym terminem |
Czego wymaga
| Wymaganie | Szczegóły |
|---|---|
| Serwer | Paper lub Spigot 26.2 |
| Vault | Wymagany |
| Plugin ekonomii | Np. EssentialsX — sam Vault nie wystarczy |
| Opcjonalnie | Nexo, Oraxen (przedmioty customowe), PlaceholderAPI |
Rodzina projektów
GrzybcioRynek działa samodzielnie, ale ma dwa dodatki:
GrzybcioRynekWeb
Most REST + SSE, który wystawia dane rynku na zewnątrz.
Rynek — strona WWW
Frontend w Next.js, na którym gracze oglądają oferty z przeglądarki.