Grzybcio Wiki

Instalacja

Kolejność instalacji, pierwsze uruchomienie i test, że rynek faktycznie działa.

Kolejność ma znaczenie

Vault

Sam Vault nic nie robi — to warstwa pośrednia.

Plugin ekonomii

Na przykład EssentialsX. To on trzyma salda graczy.

GrzybcioRynek

Dopiero teraz. Przy starcie rynek szuka ekonomii przez Vault.

Szczegóły dwóch pierwszych kroków są w Vault i ekonomii.

Wymagania

WymaganieJak sprawdzić
Paper lub Spigot 26.2version w konsoli
Vault/plugins — na zielono
Plugin ekonomii/balance zwraca kwotę, nie błąd

Krok po kroku

Wgraj plik JAR

Vault.jar
EssentialsX.jar
GrzybcioRynek-1.0.3.jar

Zrestartuj serwer

Zwykły restart, nie /reload. Przy starcie plugin utworzy katalog plugins/GrzybcioRynek/ z plikami konfiguracyjnymi.

W konsoli sprawdź, czy nie ma ostrzeżenia o braku ekonomii. Jeśli jest — wróć do Vault i ekonomii.

Sprawdź, czy GUI się otwiera

/rynek

Powinno otworzyć się okno rynku — na razie puste.

Wystaw testowy przedmiot

Weź cokolwiek do ręki i wpisz:

/market sell 100

Przedmiot powinien zniknąć z ręki i pojawić się na rynku.

Kup go z drugiego konta

Zakup jest wyłącznie przez GUI: /rynek → kliknij ofertę → potwierdź.

Nie możesz kupić własnej oferty — plugin to blokuje. Do testu potrzebujesz drugiego konta albo kolegi.

Sprawdź, czy:

  • kupujący stracił pieniądze,
  • sprzedawca je dostał (pomniejszone o prowizję),
  • przedmiot trafił do ekwipunku kupującego.

Pliki po instalacji

config.yml
gui.yml
listings.yml
market-data.yml
PlikZawartośćEdytować ręcznie?
config.ymlLimity, prowizje, zabezpieczenia, komunikatyTak
gui.ymlUkład slotów w GUITak
listings.ymlAktywne oferty i licznik next-idNie
market-data.ymlSkrzynka, ulubione, alerty, oceny, historiaNie

Nie edytuj listings.yml ani market-data.yml przy działającym serwerze

Plugin trzyma te dane w pamięci i zapisuje je sam. Ręczna edycja przy włączonym serwerze zostanie nadpisana albo — gorzej — rozjedzie stan i pogubi przedmioty graczy.

Jeśli musisz w nich grzebać, zatrzymaj serwer, zrób kopię i dopiero wtedy edytuj.

Przeładowanie po zmianach

/market reload

Przeładowuje config.yml i gui.yml, wczytuje ponownie dane, robi kopię .bak i czyści wygasłe oferty.

Reload bywa zablokowany

Gdy trwa właśnie czyjś zakup, oferta jest zarezerwowana i przeładowanie zostaje odrzucone komunikatem o aktywnych transakcjach. To zabezpieczenie przed zgubieniem przedmiotu w połowie transakcji — poczekaj chwilę i spróbuj ponownie.

Aktualizacja

Zatrzymaj serwer — nie rób tego na żywo.
Skopiuj cały katalog plugins/GrzybcioRynek/.
Podmień plik JAR. Nie zostawiaj dwóch wersji w plugins/.
Uruchom serwer i sprawdź konsolę pod kątem ostrzeżeń o nowych opcjach konfiguracji.

Na tej stronie