Wiele pluginów i modów opiera się na innych: plugin sklepu potrzebuje Vault i pluginu ekonomii, plugin menu potrzebuje PlaceholderAPI, a mod Fabric potrzebuje Fabric API. Jeśli tej podstawy brakuje, jest za stara albo sama się nie uruchamia, zależny plugin wyłącza się całkowicie lub częściowo. W większości przypadków serwer działa dalej, brakuje tylko funkcji danego pluginu.

Każda sekcja poniżej omawia jeden komunikat. Pełny komunikat znajdziesz w zakładce Konsola albo w Pliki w logs/latest.log. Przeczytaj też wcześniejsze linie, bo często widać tam, który plugin zawiódł jako pierwszy. Zanim wymienisz pluginy lub zmienisz pliki konfiguracyjne, utwórz kopię zapasową w zakładce Kopie zapasowe. Po każdej zmianie uruchom serwer ponownie w pełni, zamiast używać /reload, aby wszystkie pluginy załadowały się we właściwej kolejności.

NoClassDefFoundError i ClassNotFoundException: brakuje klasy lub inicjalizacja się nie powiodła

Tak wygląda komunikat:

java.lang.NoClassDefFoundError: com/comphenix/protocol/events/PacketListener
org.bukkit.plugin.InvalidPluginException: java.lang.NoClassDefFoundError: com/github/retrooper/packetevents/event/PacketListenerCommon
java.lang.NoClassDefFoundError: Could not initialize class com.sk89q.worldguard.bukkit.util.Materials

Co się za tym kryje: Pluginy i mody składają się z klas, czyli elementów składowych programu. Najczęściej brakuje jakiejś zależności albo jej wersja nie pasuje; com/comphenix/protocol/… należy do ProtocolLib, a com/github/retrooper/packetevents/… do PacketEvents. Przy „Could not initialize class” nie powiodła się inicjalizacja, czyli przygotowanie klasy do działania. Dana funkcja przestaje działać; reszta serwera zwykle działa dalej, ale przy starcie może też się nie uruchomić.

Jak to naprawić:

  1. Znajdź dany plugin lub mod w stacktrace, czyli liście wywołań pod błędem. Nazwa pliku przed .jar// pomoże Ci go zidentyfikować.
  2. Przy „Could not initialize class” przeczytaj wcześniejsze komunikaty w logs/latest.log i znajdź pierwszy błąd dotyczący tej klasy.
  3. Porównaj wymagane zależności i wersje na stronie projektu ze swoimi Pluginy lub Mody. Sprawdź, czy wymagane pluginy zostały poprawnie załadowane.
  4. Przy net/minecraft/client/… sprawdź, czy mod obsługuje serwery.
  5. Zatrzymaj serwer. Usuń mody przeznaczone wyłącznie dla klientów zgodnie z instrukcją projektu i zainstaluj brakujące zależności lub pasujące wydania. W przypadku klas bibliotek, takich jak adnotacje JetBrains, sprawdź wydanie pluginu lub moda, zamiast doładowywać pojedyncze klasy.
  6. Uruchom serwer ponownie w pełni i jeszcze raz sprawdź Konsola.

„Cannot execute command … plugin is disabled”: polecenie pluginu jest wyłączone

Tak wygląda komunikat:

Unexpected exception while parsing console command "<Polecenie>"
org.bukkit.command.CommandException: Cannot execute command '<Polecenie>' in plugin <Plugin> v<Wersja> - plugin is disabled.
[Essentials] Cannot execute command '<Polecenie>' in plugin <Plugin> v<Wersja> - plugin is disabled.

Co się za tym kryje: Polecenie należy do pluginu, którego nie udało się włączyć podczas startu serwera. Właściwa przyczyna znajduje się wyżej w logu startowym, często jest to „unsupported server version”: wersja pluginu nie pasuje do wersji serwera. Liczy się nazwa po „in plugin”, nawet jeśli na początku widnieje „Essentials”. Jeśli wyłączony plugin zastępuje podstawowe polecenia, takie jak list, one również przestają działać. Sam serwer działa dalej.

Jak to naprawić:

  1. Otwórz w Pliki plik logs/latest.log i wyszukaj nazwę pluginu podaną po „in plugin”. Przeczytaj komunikaty startowe, np. „Error occurred while enabling …”.
  2. Wpisz w Konsola polecenie plugins. Wyłączone pluginy są tam wyświetlane na czerwono.
  3. Usuń błąd startu. Sprawdź wersję serwera w Wersja i zainstaluj w Pluginy pasujące wydanie pluginu. Przed wymianą zatrzymaj serwer. Więcej na ten temat: Plugin nie pasuje do wersji serwera.
  4. Uruchom serwer ponownie i sprawdź poleceniem plugins, czy plugin jest zielony. Następnie przetestuj polecenie.

Dobrze wiedzieć: Komunikat o poleceniu jest skutkiem błędu startu. Zniknie, gdy tylko plugin znów zacznie się uruchamiać.

„Vault economy not found”: brak połączenia Vault z pluginem ekonomii

Tak wygląda komunikat:

[<Plugin>] Vault is required by this plugin for economy support!
[<Plugin>] Vault is installed but no economy provider is registered! … Until then every money transaction will be refused.
[<Plugin>] java.lang.IllegalStateException: Found Vault but no economy, please check whether your economy plugin supports Vault.

Co się za tym kryje: Dany plugin korzysta przez Vault z pluginu ekonomii, gdy chodzi o pieniądze, ceny czy nagrody za głowę. Vault jest przy tym tylko interfejsem, a konta prowadzi plugin ekonomii. Jeśli brakuje jednego z nich albo został on załadowany dopiero po zależnym pluginie, ten – zależnie od pluginu – wyłącza się lub odrzuca transakcje pieniężne. Serwer działa dalej.

Jak to naprawić:

  1. Sprawdź w Pluginy, czy Vault jest zainstalowany.
  2. Sprawdź, czy zainstalowany jest plugin ekonomii obsługujący Vault, na przykład EssentialsX z wbudowaną funkcją ekonomii, CMI lub XConomy.
  3. Zainstaluj to, czego brakuje, za każdym razem w wersji dla Twojej wersji serwera.
  4. Wykonaj pełny restart serwera. /reload albo doładowywanie pojedynczych pluginów łatwo psuje kolejność ładowania.
  5. Wpisz w Konsola polecenie vault-info. Przy „Economy” powinien teraz widnieć Twój plugin ekonomii.

Dobrze wiedzieć: Komunikat pojawia się także wtedy, gdy Vault jest obecny, ale sam plugin ekonomii nie uruchamia się poprawnie. Wyszukaj wtedy jego nazwę w logs/latest.log.

„Failed to register events”: brakuje wymaganego pluginu lub elementu oprogramowania serwera

Tak wygląda komunikat:

[NCasino] Failed to register events for class <Klasa> because lol/pyr/znpcsplus/api/event/NpcInteractEvent does not exist.
[PaperTextDisplay] Failed to register events for class <Klasa> because io/papermc/paper/event/player/PlayerClientLoadedWorldEvent does not exist.
[NAuras] Failed to register events for class <Klasa> because wtf/n1zamu/api/DepositMoneyEvent does not exist.

Co się za tym kryje: Plugin nie może zarejestrować listenerów, czyli funkcji reagujących na zdarzenia w grze, ponieważ brakuje wymaganej klasy. Klasy to elementy programu, które w tym przypadku zwykle dostarcza inny plugin. Dotknięte funkcje nie działają, pozostałe funkcje serwera mogą działać dalej. W przypisaniu pomaga ścieżka po because:

  • me/clip/placeholderapi: PlaceholderAPI; net/milkbowl/vault: Vault.
  • com/ghostchu/quickshop: QuickShop-Hikari; net/ess3: EssentialsX.
  • com/vexsoftware/votifier: Votifier; com/projectkorra: ProjectKorra.
  • lol/pyr/znpcsplus: ZNPCsPlus.

Jak to naprawić:

  1. Sprawdź w dokumentacji zgłaszającego pluginu, która zależność odpowiada podanej ścieżce i jaka wersja jest wymagana.
  2. Jeśli jej brakuje, zainstaluj pasujące wydanie w Pluginy. Jeśli jest zainstalowana, sprawdź jej zgodność wersji oraz jej własne błędy startu w logs/latest.log. Najpierw usuń te błędy.
  3. W przypadku io/papermc lub org/bukkit sprawdź zamiast tego, jakie oprogramowanie serwera i jaką wersję obsługuje zgłaszający plugin. Wybierz pasujące do siebie połączenie.
  4. Uruchom serwer ponownie i sprawdź Konsola.

Dobrze wiedzieć: Brakujące klasy serwera mogą wskazywać na inną lub niepasującą wersję oprogramowania serwera. Plugin nie pasuje do wersji serwera.

„Could not hook into …”: brakuje wymaganego pluginu lub nie jest on załadowany

Tak wygląda komunikat:

[<Plugin>] Could not hook into PlaceholderAPI!
<Plugin> will now disable!

Co się za tym kryje: „Hook” oznacza tu podłączenie. Zgłaszający plugin chciał przy starcie połączyć się z innym pluginem, którego potrzebuje do działania. Tego pluginu jednak brakowało albo nie był jeszcze wtedy załadowany. Wiele pluginów w takiej sytuacji samo się wyłącza. Serwer działa normalnie dalej, ale funkcje zgłaszającego pluginu są całkowicie niedostępne – w przypadku pluginu do menu wszystkie menu.

Jak to naprawić:

  1. Odczytaj z komunikatu obie nazwy: w nawiasach kwadratowych jest zgłaszający plugin, a po „hook into” ten brakujący.
  2. Jeśli brakującego pluginu nie ma w Pluginy, zainstaluj go w wersji dla Twojej wersji serwera. Bardzo często jest to PlaceholderAPI.
  3. Jeśli jest już zainstalowany, wyszukaj jego nazwę w logs/latest.log. Jeśli sam zgłasza błąd przy starcie, to właśnie jest prawdziwa przyczyna. Najpierw usuń ten błąd.
  4. Wykonaj pełny restart serwera.

Dobrze wiedzieć: Nie musisz ponownie instalować zgłaszającego pluginu. Znów zacznie działać, gdy tylko zależność będzie dostępna przy starcie.

„YOUR VIAVERSION IS OUTDATED”: ViaBackwards wyłącza się z powodu zbyt starego ViaVersion

Tak wygląda komunikat:

[ViaBackwards] YOUR VIAVERSION IS OUTDATED
[ViaBackwards] VIABACKWARDS WILL NOW DISABLE

Co się za tym kryje: ViaVersion pozwala graczom z nowszymi wersjami Minecraft dołączać do Twojego serwera, a ViaBackwards uzupełnia to o starsze wersje. ViaBackwards jest rozszerzeniem ViaVersion i wymaga pasującego, odpowiednio nowego buildu ViaVersion. Jeśli ViaVersion jest starszy, ViaBackwards się wyłącza. Serwer działa dalej, ale gracze ze starszymi klientami nie mogą już dołączyć.

Jak to naprawić:

  1. Sprawdź w Pluginy, jakie wersje ViaVersion i ViaBackwards są zainstalowane.
  2. Zaktualizuj oba jednocześnie do aktualnych, pasujących do siebie buildów. Sam komunikat podaje oficjalną stronę pobierania. Jeśli używasz też ViaRewind, zaktualizuj go w tym samym kroku.
  3. Uruchom serwer ponownie i sprawdź poleceniem plugins w Konsola, czy ViaBackwards jest wyświetlany na zielono.

Dobrze wiedzieć: Zawsze aktualizuj pluginy Via razem. Kto odświeży tylko ViaBackwards, trafi właśnie na ten komunikat.

Szczegółowo: Konfiguracja ViaVersion: łączenie starszych i nowszych klientów

UltimateDonutSmp wyłącza się bez PlaceholderAPI

Tak wygląda komunikat:

[UltimateDonutSmp] UltimateDonutSmp requires PlaceholderAPI
[UltimateDonutSmp] UltimateDonutSmp is disabling itself to prevent broken sidebar output.

Co się za tym kryje: UltimateDonutSmp wyświetla wartości na pasku bocznym, czyli na panelu przy prawej krawędzi ekranu. Te wartości pochodzą z placeholderów, małych zmiennych takich jak %player_name%, które PlaceholderAPI wypełnia prawdziwymi wartościami. Jeśli brakuje PlaceholderAPI lub jest ono wyłączone, UltimateDonutSmp celowo się wyłącza, żeby gracze nie widzieli zepsutych placeholderów. Sam serwer działa dalej normalnie.

Jak to naprawić:

  1. Zainstaluj PlaceholderAPI w sekcji Pluginy w wersji zgodnej z wersją Twojego serwera.
  2. Jeśli jest już zainstalowane, sprawdź w logs/latest.log, czy podczas uruchamiania zgłasza błąd, i najpierw go napraw.
  3. Zatrzymaj serwer, a potem uruchom go ponownie. Przeładowanie komendą tutaj nie wystarczy.

Dobrze wiedzieć: Jeśli pasek boczny pokazuje potem tekst w rodzaju %vault_eco_balance% zamiast liczb, brakuje rozszerzenia PlaceholderAPI. Pobierzesz je w Konsoli komendą papi ecloud download <rozszerzenie> i aktywujesz komendą papi reload.

„plugin is not found”: brakuje wymaganego pluginu lub się nie uruchamia

Tak wygląda komunikat:

[<Plugin>] Citizens не найден или не включён! <Plugin> отключается.
[<Plugin>] AnvilORM plugin is not found. It is mandatory dependency.
[<Plugin>] Please install ProtocolLib and restart your server.

Co się za tym kryje: Plugin opiera się na innym pluginie i nie znajduje go podczas uruchamiania. Nazwę tej zależności podaje sam komunikat, czasem nawet z adresem do pobrania. W zależności od pluginu wyłącza się on całkowicie albo część jego funkcji nie działa. Komunikat pojawia się też wtedy, gdy zależność leży jako plik w folderze plugins, ale sama się nie uruchamia.

Jak to naprawić:

  1. Zapisz nazwę brakującej zależności z komunikatu.
  2. Sprawdź w sekcji Pluginy, czy jest zainstalowana. Jeśli nie, zainstaluj ją w wersji pasującej do wersji Twojego serwera. Jak to zrobić: Instalowanie pluginów i zarządzanie nimi.
  3. Jeśli jest zainstalowana, wyszukaj jej nazwę w logs/latest.log. Właściwą przyczyną jest wtedy błąd podczas uruchamiania.
  4. Uruchom serwer ponownie.

Dobrze wiedzieć: Jeśli plugin zgłaszający problem nie jest Ci już potrzebny, możesz go po prostu usunąć. Wtedy zniknie też komunikat.

„Economy provider not found”: plugin nie znajduje systemu ekonomii

Tak wygląda komunikat:

[<Plugin>] Vault economy provider not found. Disabling plugin.
[<Plugin>] Economy provider not found! Disabling plugin.
[<Plugin>] Vault is not found or no economy plugin found

Co się za tym kryje: Do obsługi pieniędzy, cen i nagród plugin potrzebuje dwóch partnerów: Vault lub VaultUnlocked jako interfejsu oraz pluginu ekonomii, takiego jak EssentialsX, który prowadzi stany kont. Jeśli nie znajdzie obu, wyłącza się albo nie przyznaje nagród pieniężnych. Sam Vault nie prowadzi stanów kont. Na czystym Fabricu pluginy Bukkit, takie jak Vault i EssentialsX, nie działają; oprogramowanie serwera musi je obsługiwać.

Jak to naprawić:

  1. Sprawdź na stronach pluginów, czy obsługują one oprogramowanie Twojego serwera.
  2. Sprawdź w sekcji Pluginy, czy zainstalowany jest Vault lub VaultUnlocked.
  3. Sprawdź, czy działa plugin ekonomii, na przykład EssentialsX. W razie błędów przy uruchamianiu przeczytaj jego komunikaty w Konsoli.
  4. Zatrzymaj serwer, zainstaluj brakujące pluginy w odpowiednich wersjach i uruchom go ponownie.
  5. W przypadku Vault sprawdź komendą vault-info w Konsoli, czy przy „Economy” widnieje plugin ekonomii. Następnie przetestuj funkcję, której dotyczył problem.

Dobrze wiedzieć: Jak skonfigurować EssentialsX, opisujemy w poradniku Konfiguracja EssentialsX.

Plugin nagród za głowę Bountys nie znajduje Vault

Tak wygląda komunikat:

[Bountys] Vault Plugin wasn't detected!

Co się za tym kryje: Bountys wypłaca nagrody za głowę przez Vault i zwykle potrzebuje do tego dodatkowo pluginu ekonomii, który prowadzi stany kont. Podczas uruchamiania nie znaleziono Vault. Dlatego funkcje pieniężne Bountys nie działają, więc nagród za głowę nie da się wypłacić. Nie ma to wpływu na sam serwer ani na inne pluginy.

Jak to naprawić:

  1. Zdecyduj, czy potrzebujesz Bountys. Jeśli nie, usuń go w sekcji Pluginy, a komunikat zniknie.
  2. Jeśli chcesz go zachować, umieść Vault i kompatybilny plugin ekonomii, taki jak EssentialsX, w folderze pluginów, najprościej przez sekcję Pluginy.
  3. Jeśli Vault już tam jest, sprawdź w logs/latest.log, czy sam Vault zgłasza błąd podczas uruchamiania.
  4. Uruchom serwer ponownie i sprawdź komendą vault-info w Konsoli, czy Vault znalazł plugin ekonomii.

Dobrze wiedzieć: Jeśli kolejne pluginy zgłaszają brak Vault lub ekonomii, wszystkie te komunikaty naprawisz tym samym krokiem.

AuthMe nie znajduje przez Vault pluginu uprawnień

Tak wygląda komunikat:

[AuthMe] Error while hooking into Vault [PermissionHandlerException]: Could not load permissions provider service

Co się za tym kryje: AuthMe to plugin logowania, w którym gracze logują się hasłem. Na potrzeby funkcji grup i uprawnień odpytuje przez Vault usługę uprawnień, czyli plugin uprawnień. Vault jest wprawdzie zainstalowany, ale nie udostępnia AuthMe takiej usługi. Dlatego funkcje grup i uprawnień w AuthMe nie działają. Komunikat dotyczy tylko tych dodatkowych funkcji.

Jak to naprawić:

  1. Zainstaluj w sekcji Pluginy LuckPerms lub inny plugin uprawnień z obsługą Vault.
  2. Zaktualizuj Vault i AuthMe do wersji przeznaczonych dla wersji Twojego serwera.
  3. Uruchom serwer ponownie.
  4. Wpisz w Konsoli vault-info. Przy „Permission” powinien teraz widnieć Twój plugin uprawnień.

Dobrze wiedzieć: Jak tworzyć grupy i uprawnienia, pokazuje poradnik Konfiguracja LuckPerms.

StackSpawners wymaga DecentHolograms

Tak wygląda komunikat:

[StackSpawners] DecentHolograms was not found. The plugin will not work

Co się za tym kryje: StackSpawners łączy spawnery i do wyświetlania unoszących się napisów, tzw. hologramów, używa pluginu DecentHolograms. Sam nie ma tej funkcji. Jeśli StackSpawners nie znajdzie DecentHolograms podczas uruchamiania, nie może działać. Serwer działa dalej, ale funkcji StackSpawners brakuje.

Jak to naprawić:

  1. Zainstaluj DecentHolograms w sekcji Pluginy w wersji pasującej do wersji Twojego serwera i do StackSpawners. Obsługiwane wersje znajdziesz na stronie pluginu StackSpawners.
  2. Jeśli DecentHolograms jest już zainstalowany, poszukaj w logs/latest.log błędu uruchamiania DecentHolograms i najpierw go napraw.
  3. Całkowicie zatrzymaj serwer i uruchom go ponownie. Dzięki temu oba pluginy załadują się we właściwej kolejności.

Dobrze wiedzieć: Jeśli nie korzystasz już ze StackSpawners, usuń go. Wtedy odpada też ta zależność.

LightAntiCheat-Plus nie może znaleźć PacketEvents

Tak wygląda komunikat:

(LightAntiCheat-Plus) Failed to start listener-mode … com/github/retrooper/packetevents/event/PacketListenerCommon

Co się za tym kryje: LightAntiCheat-Plus to plugin anty-cheat. Śledzi ruch sieciowy graczy za pomocą PacketEvents, osobnego pluginu, który przygotowuje pakiety sieciowe dla innych pluginów. Jeśli brakuje PacketEvents albo jest zainstalowany w wersji, której LightAntiCheat-Plus się nie spodziewa, jego monitorowanie się nie uruchamia. Serwer działa dalej, ale ochrona przed cheatami jest wtedy całkowicie lub częściowo wyłączona.

Jak to naprawić:

  1. Sprawdź na stronie LightAntiCheat-Plus, jakiej wersji PacketEvents wymaga.
  2. Zainstaluj lub zaktualizuj PacketEvents w sekcji Pluginy do tej wersji, dopasowanej do wersji Twojego serwera.
  3. W razie potrzeby zaktualizuj również LightAntiCheat-Plus, aby oba pluginy do siebie pasowały.
  4. Całkowicie zatrzymaj serwer i uruchom go ponownie.

Warto wiedzieć: Inne pluginy często również korzystają z PacketEvents. Po zmianie sprawdź w logs/latest.log, czy nadal uruchamiają się bez błędów.

„The plugin is disabling itself”: plugin wyłączony po błędzie

Tak wygląda komunikat:

[<Plugin>] The plugin is disabling itself.
[<Plugin>] [<Plugin>] Disabling plugin...
[<Plugin>] [PacketEvents] Nie udało się uruchomić systemu pakietowego kostiumów po <Liczba> próbach.

Co się za tym kryje: Jeśli plugin zgłasza, że wyłącza się po błędzie, jego funkcje są niedostępne aż do następnego udanego uruchomienia. Serwer Minecraft działa przy tym dalej. Polskojęzyczna linia PacketEvents wskazuje system kostiumów, którego nie udało się uruchomić po kilku próbach; dodatkowe komunikaty o wyłączaniu pokazują, czy przestaje działać cały plugin. Właściwa przyczyna znajduje się zwykle we wcześniejszych liniach, czasem w innym języku.

Jak to naprawić:

  1. Otwórz w sekcji Pliki logs/latest.log i przeczytaj linie przed komunikatem. Sprawdź, czy są tam wskazówki dotyczące brakujących zależności, niepasujących wersji lub błędów konfiguracji.
  2. Zaktualizuj problematyczny plugin i sprawdź na jego stronie, czy pasuje do wersji Twojego serwera i czy wymaga innych pluginów.
  3. Uruchom serwer ponownie i sprawdź w Konsoli, czy plugin i dana funkcja się uruchamiają.
  4. Jeśli błąd nadal występuje, zrób kopię folderu pluginu, usuń plugin na próbę i uruchom serwer ponownie. Zgłoś błąd autorowi pluginu, dołączając zanonimizowane linie z logu.

Warto wiedzieć: Błędy występujące w trakcie działania serwera ocenisz za pomocą poradnika Plugin zgłasza błędy w trakcie działania.

AuthMeBia nie pasuje do Twojej wersji AuthMe

Tak wygląda komunikat:

[AuthMeBia] AuthMe DataSource reflection unavailable; premium skip and session autologin both disabled

Co się za tym kryje: AuthMeBia to rozszerzenie pluginu logowania AuthMe. Korzysta z wewnętrznej funkcji AuthMe, która w Twojej wersji AuthMe nie istnieje w takiej formie. Dlatego AuthMeBia wyłącza dwie funkcje: Premium-Skip, dzięki któremu gracze z kupionym kontem Minecraft wchodzą bez hasła, oraz Session-Autologin, czyli automatyczne logowanie, gdy ktoś wraca na serwer krótko po wyjściu. Samo AuthMe działa dalej, a gracze logują się wtedy jak zwykle hasłem.

Jak to naprawić:

  1. Sprawdź w sekcji Pluginy, jakie wersje AuthMe i AuthMeBia są zainstalowane.
  2. Sprawdź na stronie AuthMeBia, dla której wersji AuthMe zostało stworzone.
  3. Zaktualizuj oba pluginy do pasujących do siebie wersji i uruchom serwer ponownie.
  4. Przetestuj na kupionym koncie, czy wejście bez hasła znowu działa.

„NoSuchMethodError” w ProjectKorra: rozszerzenie nie pasuje do wersji głównej

Tak wygląda komunikat:

java.lang.NoSuchMethodError: '<Type> com.projectkorra.projectkorra.<Klasa>.<Metoda>()'
	at ProjectAddons-<Wersja>.jar//…
com.jedk1.jedcore.ability.<Umiejętność>@<Identyfikator>[…]

Co się za tym kryje: ProjectKorra dodaje na serwer umiejętności bendingu, a rozszerzenia takie jak JedCore czy ProjectAddons dokładają kolejne. Każde rozszerzenie jest zbudowane dla określonej wersji ProjectKorra. Jeśli wywołuje metodę, czyli funkcję, której nie ma w Twojej wersji ProjectKorra, przerywa działanie z błędem „NoSuchMethodError”. Czasem zapisuje przy tym w logu stan umiejętności jako długą linię. Dotknięte umiejętności przestają wtedy działać, ale reszta serwera działa dalej.

Jak to naprawić:

  1. W liniach at pod komunikatem odczytaj nazwę pliku z .jar. Wskazuje ona, którego rozszerzenia dotyczy problem.
  2. W zakładce Pluginy zanotuj wersję ProjectKorra oraz wersje wszystkich rozszerzeń.
  3. Otwórz stronę pobierania każdego rozszerzenia. Znajdziesz tam informację, jakiej wersji ProjectKorra wymaga.
  4. Zainstaluj ProjectKorra i wszystkie rozszerzenia w wersjach, które pasują do siebie nawzajem i do wersji Twojego serwera.
  5. Zrestartuj serwer i przetestuj jedną z umiejętności rozszerzenia.

Dobrze wiedzieć: Jeśli dane rozszerzenie nie jest dostępne dla Twojej wersji ProjectKorra, lepiej je usuń, zamiast mieszać stare i nowe wersje.

AppleSkin się nie uruchamia, bo brakuje Fabric API

Tak wygląda komunikat:

Mod 'AppleSkin' (appleskin) <Wersja> requires any version of fabric-api, which is missing!

Co się za tym kryje: Większość modów Fabric wymaga biblioteki Fabric API, czyli zbioru wspólnych elementów, których nie ma w samym Fabric Loaderze. AppleSkin jest zainstalowany, ale Fabric API nie. Fabric Loader sprawdza to podczas uruchamiania i przerywa start. Twój serwer uruchomi się więc dopiero wtedy, gdy dodasz Fabric API lub wyłączysz AppleSkin.

Jak to naprawić:

  1. Zainstaluj w sekcji Mody Fabric API w wersji dla Twojej wersji Minecraft.
  2. Jeśli nie potrzebujesz AppleSkin, użyj zamiast tego przycisku naprawy przy komunikacie w sekcji Kondycja serwera. Wyłącza on AppleSkin (plik zostaje zachowany) i uruchamia serwer ponownie.
  3. Sprawdź w Konsoli, czy serwer w pełni się uruchamia.

Warto wiedzieć: Fabric API musi pasować do Twojej wersji Minecraft. Komunikat mówi „any version”, więc sam AppleSkin nie stawia żadnych szczególnych wymagań.

Więcej szczegółów: Fabric Loader i Fabric API: skuteczne rozwiązywanie błędów wersji

Odczyt stanu konta nie działa, bo EssentialsX nie jest jeszcze gotowy

Tak wygląda komunikat:

[ajLeaderboards] Placeholder <Placeholder> for player <Gracz> threw an error:
Essentials API is called before Essentials is loaded.

Co się za tym kryje: Placeholder to skrót tekstowy, który zostaje zastąpiony wartością, na przykład stanem konta. Tutaj zapytanie do EssentialsX kończy się niepowodzeniem, ponieważ jego interfejs ekonomii nie jest w danej chwili dostępny. Przez to nie można zaktualizować wartości w rankingu. Serwer działa dalej.

Jak to naprawić:

  1. Sprawdź w Konsoli, czy komunikat pojawia się podczas uruchamiania, zatrzymywania czy w trakcie działania serwera.
  2. Przeczytaj wcześniejsze błędy startowe EssentialsX. Jeśli plugin nie załadował się poprawnie, najpierw usuń te błędy.
  3. Sprawdź w sekcji Pluginy EssentialsX, Vault, PlaceholderAPI i ajLeaderboards oraz zainstalowane rozszerzenie Vault. Używaj wersji, które do siebie pasują.
  4. Zatrzymaj serwer przed podmianą plików, a następnie uruchom go ponownie w całości. Po zakończeniu uruchamiania ponownie sprawdź ranking.

SmartWithdraw: test kondycji zgłasza problem

Tak wygląda komunikat:

[SmartWithdraw] SmartWithdraw is NOT working properly. Fix the problem(s) below:

Co się za tym kryje: SmartWithdraw wykrył problem podczas testu kondycji. Z tego powodu funkcje pluginu, których to dotyczy, nie działają prawidłowo; serwer działa dalej. Konkretna przyczyna jest podana bezpośrednio pod tym podsumowaniem. Może to być na przykład brak połączenia z systemem ekonomii.

Jak to naprawić:

  1. Przeczytaj w Konsola wszystkie pojedyncze komunikaty pod podsumowaniem. Za pomocą /sw status możesz ponownie wyświetlić raport.
  2. Sprawdź w Pluginy konkretnie wymienione wymagania. Jeśli raport zgłasza brak Vault lub brak pluginu ekonomii, zainstaluj pasujące wersje i sprawdź również ich komunikaty startowe.
  3. Przed wprowadzeniem zmian zrób kopię ustawień, których to dotyczy, w Pliki. Po poprawce uruchom serwer całkowicie od nowa i ponownie wyświetl raport.
  4. Jeśli problem nadal występuje, zgłoś autorowi pluginu pełny, oczyszczony z danych wrażliwych raport oraz używane wersje pluginów.

Nie ma tu Twojego komunikatu?

Przeczytaj cały komunikat w logs/latest.log, łącznie z wcześniejszymi liniami. Zwykle serwer najpierw wymienia plugin, który zawiódł, a dopiero potem błędy następcze innych pluginów. W stacktrace nazwy plików przed .jar oraz nazwy folderów w ścieżce klas, np. me/clip/placeholderapi, zdradzają, który plugin lub mod jest zaangażowany. Następnie porównaj zależności podane na stronie projektu z zainstalowanymi pluginami. Przed każdą przebudową utwórz kopię zapasową. Jeśli utkniesz, otwórz zgłoszenie i podaj godzinę wystąpienia komunikatu.