Grzybcio Wiki

Nexo, Oraxen i PlaceholderAPI

Integracje opcjonalne — przedmioty customowe na rynku i placeholdery w innych pluginach.

GrzybcioRynek działa bez żadnego z tych pluginów. Wszystkie trzy są zadeklarowane jako zależności miękkie — jeśli ich nie ma, rynek po prostu ich nie używa.

Nexo i Oraxen

Oba pluginy dodają do serwera własne przedmioty, wykraczające poza to, co ma vanilla. Bez integracji rynek traktowałby je jak zwykłe przedmioty bazowe i gubił ich tożsamość — customowy miecz wyglądałby na liście jak zwykły kij.

Co daje integracja

Rynek rozpoznaje customowy przedmiot, pokazuje go poprawnie w GUI i pozwala filtrować wyniki po typie przedmiotu. Dzięki temu serwer z własnym itemsetem ma rynek działający tak samo dobrze jak serwer na czystej vanilli.

Instalacja

Wgraj Nexo albo Oraxena zgodnie z ich własną dokumentacją i upewnij się, że działa — customowy przedmiot da się wydać komendą tego pluginu.

Zrestartuj serwer. GrzybcioRynek wykryje plugin przy starcie.

Wystaw customowy przedmiot na rynek i sprawdź, czy w GUI wygląda poprawnie.

Kolejność wczytywania

Nexo i Oraxen to zależności miękkie, więc serwer wczyta rynek nawet bez nich. Jeśli zainstalujesz je po rynku, potrzebny jest pełny restart, nie /market reload — wykrywanie dzieje się przy starcie pluginu.

Nexo i Oraxen naraz

Da się mieć oba, choć rzadko ma to sens. Rynek obsłuży przedmioty z obu.

Gdy odinstalujesz plugin z itemami

Oferty z customowymi przedmiotami przestaną mieć sens

Jeśli usuniesz Nexo albo Oraxena, a na rynku wiszą wystawione przez nie przedmioty, serwer nie będzie już wiedział, czym one są.

Zanim odinstalujesz plugin z itemami, wyczyść powiązane oferty — na przykład przez /market admin list, a potem /market admin forceexpire <id>. Przedmioty wrócą do właścicieli, zanim staną się nieczytelne.

Filtrowanie po typie przedmiotu

Most GrzybcioRynekWeb udostępnia parametr itemType z wartościami all, vanilla, nexo, oraxen i custom. Pozwala to stronie WWW pokazywać osobno przedmioty vanilla i customowe.

PlaceholderAPI

Integracja opcjonalna, przydatna, gdy chcesz pokazać dane z rynku gdzie indziej — na tablicy wyników, w tagu nad głową gracza albo w wiadomości powitalnej.

Instalacja

Wgraj PlaceholderAPI do plugins/.

Zrestartuj serwer.

Sprawdź, czy PlaceholderAPI widzi rozszerzenie rynku:

/papi list

Placeholdery działają tam, gdzie plugin je obsługuje

PlaceholderAPI samo z siebie niczego nie wyświetla — jest dostawcą wartości dla innych pluginów. Żeby zobaczyć dane rynku na tablicy wyników, potrzebujesz też pluginu od tablicy (na przykład TAB albo Scoreboard), który placeholdery obsługuje.

Test placeholdera

/papi parse me %nazwa_placeholdera%

Komenda zwraca wartość dla ciebie — najszybszy sposób sprawdzenia, czy dany placeholder w ogóle istnieje, zanim wstawisz go do konfiguracji innego pluginu.

Sprawdzenie, co rynek wykrył

/plugins

Nexo, Oraxen i PlaceholderAPI powinny być na zielono. Jeśli któryś jest czerwony, nie działa i rynek go nie użyje.

Po instalacji którejkolwiek z tych integracji zajrzyj do konsoli przy starcie serwera — tam widać, co rynek rozpoznał.

Na tej stronie