Gdy plugin lub mod w trakcie działania serwera natrafi na błąd w programie, Java zapisuje w logu komunikat błędu ze stacktrace'em. Stacktrace to lista linii zaczynających się od „at” pod linią z błędem. Pokazuje, która część programu była właśnie wykonywana, i dzięki temu zwykle zdradza, który plugin lub mod jest odpowiedzialny. Większość tych błędów nie zatrzymuje serwera, ale jakaś funkcja przestaje działać, a powtarzające się błędy zapełniają konsolę.
Każda sekcja poniżej dotyczy jednego komunikatu: jak wygląda, co się za nim kryje i co możesz zrobić. Pełny komunikat znajdziesz w Konsola lub w Pliki w logs/latest.log. Przeczytaj tam też linie bezpośrednio przed nim i po nim. Zanim zmienisz pliki konfiguracyjne lub pliki świata albo wymienisz pluginy, utwórz kopię zapasową w Kopie zapasowe. Pliki pluginów najlepiej wymieniaj przy zatrzymanym serwerze.
NullPointerException: plugin lub mod odwołuje się do brakującej wartości
Tak wygląda komunikat:
[GrimAC] Failed to start PacketManager: java.lang.NullPointerException: Cannot invoke "<Metoda>" because "<Zmienna>" is null
Error white registering dispenser behavior for item <Mod>:<Przedmiot>: java.lang.NullPointerException: … is null
[UnlimitedNameTags] Async task … generated an exception: java.lang.NullPointerException: Cannot invoke "<Metoda>" because "<Zmienna>" is null
Co się za tym kryje: Plugin lub mod odwołuje się do brakującego obiektu; Java nazywa taką wartość „null”. Po „Cannot invoke” znajduje się nazwa metody, a po „because” brakująca wartość. Może się to zdarzyć podczas startu, przy rejestrowaniu zachowania dozownika dla przedmiotów albo w zadaniu działającym w tle („Async task”). Dana funkcja przestaje działać; jeśli błąd wystąpi podczas startu, może też przerwać uruchamianie serwera.
Jak to naprawić:
- Otwórz pełny komunikat w Konsola lub w
logs/latest.log. Przeczytaj też, co znajduje się wcześniej: nazwa pluginu lub wspomniany plik pomogą ustalić źródło problemu. - Linie zaczynające się od „at” to tzw. stacktrace, czyli łańcuch wywołań prowadzący do błędu. Czytaj od pierwszej linii, aż dojdziesz do pluginu lub moda, którego dotyczy błąd.
- Zaktualizuj ten plugin w Pluginy lub mod w Mody do wersji pasującej do wersji serwera. Przed podmianą plików zatrzymaj serwer, a potem uruchom go ponownie.
- Jeśli w komunikacie wymieniona jest konfiguracja, zrób jej kopię i porównaj ustawienia z zaleceniami autora. Jeśli błąd nie znika, zgłoś autorowi pełny komunikat i czynność, która go wywołuje.
„Could not pass event”: plugin się wysypuje przy zdarzeniu w grze
Tak wygląda komunikat:
Could not pass event PlayerTeleportEvent to WorldGuard v<Wersja>: java.lang.NullPointerException: … is null
Could not pass event PlayerJoinEvent to ScoreboardPL v<Wersja>: java.lang.NoSuchFieldError: … ARMOR
Could not pass event PlayerJoinEvent to ArmorAbilities v<Wersja>: java.lang.NoSuchFieldError: … MAX_HEALTH
Co się za tym kryje: Plugin przerywa obsługę zdarzenia w grze. Po „to” podane są nazwa pluginu i jego wersja. „NoSuchMethodError” lub „NoSuchFieldError” wskazuje na niepasującą wersję serwera. Przy „NullPointerException” brakuje jakiejś wartości; wskazuje ją linia błędu. „IllegalArgumentException” może oznaczać nieprawidłową wartość koloru lub typ danych. „bind(..) failed” z „Cannot assign requested address” oznacza, że plugin nie może zająć wpisanego adresu sieciowego. Serwer działa dalej, ale dana funkcja pluginu nie zadziała przy tym zdarzeniu.
Jak to naprawić:
- W Konsola odczytaj nazwę pluginu i linię błędu pod nią.
- W Wersja sprawdź wersję serwera i poszukaj pasującego do niej wydania pluginu.
- Zatrzymaj serwer, wgraj to wydanie w Pluginy i uruchom serwer ponownie.
- Przy „bind(..) failed” sprawdź adres i port w konfiguracji pluginu w Pliki. Adres musi należeć do serwera.
- Jeśli log wskazuje nieudane połączenie z bazą danych, porównaj dane dostępowe i adres z tymi w Bazy danych.
- Jeśli błąd nie znika, zgłoś go autorowi pluginu, podając czynność, która go wywołuje, i pełny komunikat.
Dobrze wiedzieć: Więcej o błędach wersji: Plugin nie pasuje do wersji serwera.
„Task … generated an exception”: zadanie pluginu kończy się błędem w tle
Tak wygląda komunikat:
[<Plugin>] Task #<Numer> for <Plugin> v<Wersja> generated an exception
java.lang.NullPointerException: Cannot invoke "…" because "…" is null
java.lang.IncompatibleClassChangeError: …
Co się za tym kryje: Zaplanowane zadanie pluginu (task), na przykład od cząsteczek lub hologramów, zostało przerwane przez błąd Javy, czyli wyjątek. Powtarzające się błędy często wskazują na niezgodność z wersją serwera, na przykład po aktualizacji. Mogą je też wywołać nieprawidłowe wartości lub próby zmiany wyników tylko do odczytu. Serwer działa dalej, ale jedna z funkcji pluginu przestaje działać, a powtarzające się błędy zapychają konsolę.
Jak to naprawić:
- Odczytaj nazwę pluginu po „for” oraz linię błędu poniżej.
- W zakładce Pluginy sprawdź, czy istnieje nowsze wydanie pasujące do Twojej wersji serwera. Zatrzymaj serwer, wgraj je i uruchom serwer ponownie.
- Jeśli pasującego wydania nie ma, zatrzymaj serwer i w zakładce Pliki przenieś plik
.jarzplugins/do osobnego folderu. Następnie uruchom serwer ponownie. Ciągłe błędy mogą spowalniać serwer. - Sprawdź w Konsola, czy komunikat przestał się pojawiać. Jeśli występuje nadal przy aktualnym wydaniu, zgłoś go autorowi.
Warto wiedzieć: „missing required data class” oznacza brakujące dane cząsteczek. „Cannot modify read-only score” dotyczy wyniku tylko do odczytu; plugin musi poprawić ten dostęp. „NoSuchMethodError”, „NoSuchFieldError” lub „IncompatibleClassChangeError” wskazują na niezgodność wersji.
„Error executing task” / „Command … failed”: zadanie lub polecenie zostaje przerwane
Tak wygląda komunikat:
[<Plugin>] Command <Polecenie> failed:
[<Plugin>] Plugin <Plugin> v<Wersja> generated an exception while executing task <Numer>
[<Plugin>] [SCHEDULER] Exception thrown whilst executing task
Co się za tym kryje: Polecenie lub zaplanowane zadanie zostało przerwane przez wyjątek, czyli błąd Javy. Przy błędzie pluginu serwer działa dalej, a przestaje działać tylko dana funkcja; „Error executing task on Server” pojawia się także przy zadaniach samego serwera. MissingResourceException wskazuje brakujący zasób lub wpis językowy, sectionPos out of bounds nieprawidłową pozycję sekcji. Przyczyna znajduje się poniżej, a przy zagnieżdżonych błędach po „Caused by”.
Jak to naprawić:
- Przeczytaj linię „Caused by” albo pierwszą linię błędu bezpośrednio pod komunikatem.
- Ustal plugin na podstawie komunikatu lub linii
at …, czyli łańcucha wywołań prowadzącego do błędu. Mogą tam być też wymienione wymagane dodatkowe pluginy. - Zaktualizuj w zakładce Pluginy plugin i powiązane zależności do wydań zgodnych ze sobą i z Twoją wersją serwera. Przed podmianą plików zatrzymaj serwer, a potem uruchom go ponownie.
- Powtórz akcję. Jeśli błąd nie znika, zgłoś go autorowi pluginu z pełnym komunikatem. Jeśli łańcuch wywołań zawiera tylko klasy Minecraft, otwórz zgłoszenie i podaj akcję oraz godzinę.
Warto wiedzieć: zip file closed pojawia się zwykle wtedy, gdy plik pluginu został podmieniony lub przeładowany podczas działania serwera; pełny restart rozwiązuje problem. NoSuchMethodError lub NoSuchFieldError wskazuje na brakujące metody lub pola: sprawdź obsługiwaną wersję serwera i zależności.
ClassCastException: mod lub plugin oczekuje innego typu danych
Tak wygląda komunikat:
java.lang.ClassCastException: Cannot cast <PakietA>.<KlasaA> to <PakietB>.<KlasaB>
java.lang.ClassCastException: class net.minecraft.world.level.block.AirBlock cannot be cast to class net.minecraft.world.level.block.AbstractBannerBlock
java.lang.ClassCastException: class org.bukkit.craftbukkit.inventory.CraftMetaItem cannot be cast to class org.bukkit.inventory.meta.ArmorMeta
Co się za tym kryje: Mod lub plugin oczekuje innego typu danych, niż dostarcza inny zaangażowany komponent. Dzieje się tak na przykład wtedy, gdy jeden mod został zaktualizowany, a zależny od niego mod nie. Błąd może też wystąpić podczas wczytywania konfiguracji moda. Często przestaje działać tylko dana funkcja, na przykład wczytywanie danych bloków, polecenie pluginu albo porządkowanie wczytanych plików modów.
Jak to naprawić:
- Przeczytaj pełny komunikat w
logs/latest.logw zakładce Pliki. Nazwy pakietów przed nazwami klas pomagają rozpoznać zaangażowane mody lub pluginy;java.lang.Stringoznacza natomiast typ danych Javy dla tekstu. - Sprawdź, który komponent był ostatnio aktualizowany. Doprowadź zaangażowane mody lub pluginy do zgodnych ze sobą wersji: zaktualizuj je razem albo przywróć poprzedni stan.
- Jeśli działa Modpack, aktualizuj cały modpack zamiast pojedynczych modów.
- Jeśli wymieniony jest wpis konfiguracji, sprawdź go w dokumentacji zainstalowanej wersji moda.
- Uruchom serwer ponownie i powtórz czynność.
Więcej o konfliktach modów: Błędy modów na Forge, NeoForge i Fabric.
ArrayIndexOutOfBoundsException: odwołanie do nieistniejącego elementu listy
Tak wygląda komunikat:
java.lang.ArrayIndexOutOfBoundsException: Index 3 out of bounds for length 3
[DonateCase] Error occurred while loading item: <Wpis>
java.lang.ArrayIndexOutOfBoundsException: Index 45 out of bounds for length 45
Co się za tym kryje: Plugin lub mod odwołuje się do nieprawidłowej pozycji w tablicy, czyli liście o stałej długości. Java liczy od 0: przy długości 3 istnieją tylko pozycje od 0 do 2; pozycje ujemne również są nieprawidłowe. Często brakuje argumentów komendy lub wartości konfiguracji, starszy plugin błędnie odczytuje wersję serwera albo element menu leży poza rozmiarem menu, jak w przypadku DonateCase. W zależności od miejsca przestaje działać jakaś funkcja lub serwer nie startuje.
Jak to naprawić:
- Przeczytaj linie błędu w Konsola lub w
logs/latest.logw Pliki. Linie „at” pod spodem pokazują łańcuch wywołań, zwany też stacktrace; znajdź w nim dany plugin lub mod. - Przy komendzie sprawdź wymagane argumenty. Porównaj wartości konfiguracji z szablonem lub kopią zapasową. Przy błędach menu sprawdź, czy ustawione pozycje mieszczą się w rozmiarze menu.
- Zaktualizuj dany plugin w Pluginy lub mod w Mody do wydania pasującego do serwera i loadera. Loader to komponent, który wczytuje mody. Uruchom serwer ponownie.
- Jeśli błąd nie znika, zgłoś autorowi komunikat błędu wraz z łańcuchem wywołań i przyczyną, która go wywołała.
Plik konfiguracyjny pluginu zawiera błędy.
NumberFormatException: tekst miał być liczbą
Tak wygląda komunikat:
[DeluxeMenus-Modern] Input for comparison requirement is an invalid number: %statistic_hours_played%
java.lang.NumberFormatException: For input string: "%statistic_hours_played%"
java.lang.NumberFormatException: For input string: "craftbukkit"
Co się za tym kryje: Gra, mod lub plugin próbowały odczytać wartość tekstową jako liczbę, ale ten tekst nie był liczbą. Cudzysłowy pokazują tę wartość. Przyczyną może być konfiguracja, nieoczekiwana wartość danych albo błąd wersji lub programu. Placeholder ze znakami procenta nie został zastąpiony wartością, np. przy sprawdzaniu liczby w DeluxeMenus. Często brakuje odpowiedniego rozszerzenia do PlaceholderAPI, czyli pluginu, który wypełnia takie placeholdery, albo pluginu, który dostarcza wartość. Słowo takie jak craftbukkit może wskazywać, że starszy plugin błędnie odczytuje wersję serwera.
Jak to naprawić:
- Sprawdź pełny stacktrace, czyli łańcuch wywołań pod komunikatem błędu, i zaktualizuj wymieniony w nim komponent.
- Jeśli chodzi o placeholder: sprawdź w grze poleceniem
/papi parse me <Zmienna>, czy zwraca on wartość. Jeśli nie, sprawdź plugin, który go dostarcza, i zainstaluj pasujące rozszerzenie PlaceholderAPI poleceniem/papi ecloud download <Nazwa>. Załaduj je poleceniem/papi reload. - Jeśli komunikat wymienia plik lub ustawienie, porównaj wartość z domyślną konfiguracją pluginu.
- Uruchom serwer ponownie i jeszcze raz wywołaj tę akcję.
ArrayIndexOutOfBoundsException bez dodatkowych informacji
Tak wygląda komunikat:
[<Plugin>] Error occurred while loading item: 2
java.lang.ArrayIndexOutOfBoundsException
Co się za tym kryje: Plugin lub mod użył nieprawidłowego indeksu listy, tak jak w poprzedniej sekcji. Tutaj jednak brakuje indeksu i długości. Dzieje się tak, gdy ten sam błąd występuje bardzo często: Java pomija wtedy szczegóły ze względu na wydajność. Linia przed komunikatem często zdradza, który plugin i co próbował właśnie zrobić, w przykładzie wczytać wpis. Pierwsza linia stacktrace'a pod spodem, jeśli istnieje, wskazuje winowajcę.
Jak to naprawić:
- Przeczytaj linię bezpośrednio przed komunikatem. Często w nawiasach kwadratowych jest tam nazwa pluginu.
- Przeczytaj pierwszą linię stacktrace'a pod komunikatem.
- Jeśli brakuje obu, poszukaj wyżej w
logs/latest.logpierwszego wystąpienia błędu. Tam zwykle jest on jeszcze zapisany w całości. Starsze logi znajdziesz spakowane w folderzelogs/. - Zaktualizuj plugin lub mod wymieniony jako pierwszy. Jeśli linia przed komunikatem wskazuje konkretny wpis, sprawdź go w konfiguracji pluginu.
- Jeśli błąd nie znika, zgłoś go autorowi.
ExceptionInInitializerError: nie można zainicjować klasy pluginu lub moda
Tak wygląda komunikat:
[<Plugin>] java.lang.ExceptionInInitializerError
Exception in thread "ForkJoinPool-3-worker-1" java.lang.ExceptionInInitializerError
Caused by: <Rodzaj błędu>: <Komunikat>
Co się za tym kryje: Java inicjuje każdą klasę, czyli każdy element składowy programu, jeden raz przy jej pierwszym użyciu. Właśnie wtedy klasa pluginu lub moda uległa awarii. Potem pozostaje bezużyteczna aż do końca tego uruchomienia serwera, dlatego często pojawiają się kolejne błędy, takie jak „NoClassDefFoundError” z tą samą nazwą klasy. Właściwą przyczynę, a zwykle też dany plugin lub mod, wskazuje łańcuch „Caused by” poniżej. Jeśli przed komunikatem w nawiasach kwadratowych stoi nazwa pluginu, błąd wystąpił podczas włączania tego pluginu. W zależności od miejsca wystąpienia przestaje działać jedna funkcja albo plugin lub mod w ogóle się nie wczytuje.
Jak to naprawić:
- W Konsola lub w
logs/latest.logprzeczytaj pierwszą linię „Caused by” pod komunikatem. - Na podstawie linii „at” poniżej ustal plugin lub mod, na przykład po nazwie pliku z
.jar. - Zaktualizuj go lub zastąp wydaniem pasującym do Twojej wersji serwera i oprogramowania serwera.
- Uruchom serwer ponownie. Klasa zostanie zainicjowana od nowa dopiero przy następnym starcie.
Przy pytaniach o wersje pomoże: Plugin nie pasuje do wersji serwera.
„location-candidate error” / „Failed to save a model”: zadanie pluginu kończy się błędem
Tak wygląda komunikat:
[OlEncounters] First unexpected location-candidate error during this search
com.olencounters.location.LocationFinder$UngeneratedChunkException: Location search refused to generate a chunk
[OpenAudioMc] WARNING: Failed to save a model. This is a error. (ClientDataStore) (IllegalArgumentException/java.lang.ArithmeticException: long overflow)
Co się za tym kryje: Plugin natrafił na błąd podczas wykonywania własnego zadania, np. przy zapisywaniu, przetwarzaniu wiadomości, uruchamianiu lub szukaniu miejsca. OlEncounters trafia tu na jeszcze niewygenerowany chunk, czyli fragment świata, i odmawia jego wygenerowania podczas wyszukiwania. OpenAudioMc nie może zapisać danych z powodu przepełnienia liczby: wynik obliczenia nie mieści się w użytym typie liczbowym. W zależności od błędu przestaje działać tylko ta akcja albo plugin się wyłącza. Błędami zapisu zajmij się szybko, żeby nie stracić danych.
Jak to naprawić:
- Przeczytaj w zakładce Konsola nazwę pluginu i linie bezpośrednio pod komunikatem.
- Zaktualizuj plugin w zakładce Pluginy i uruchom serwer ponownie.
- Jeśli błąd nie znika, utwórz kopię zapasową, przy zatrzymanym serwerze testowo usuń plugin i po starcie sprawdź, czy komunikat zniknął.
- Zgłoś błąd autorowi pluginu, podając linie z konsoli i akcję, przy której występuje.
Jeśli zapisywanie wielokrotnie się nie udaje: Plugin nie może zapisać bazy danych ani plików.
Raport błędu Skript z #!#!: skrypt się nie ładuje
Tak wygląda komunikat:
#!#! Current node: <Linia z pliku .sk>
#!#! End of Error.
Co się za tym kryje: Skript to plugin, za pomocą którego piszesz funkcje serwera w prostych plikach tekstowych z rozszerzeniem .sk. Jeśli podczas ładowania skryptu lub addonu wykryje poważny błąd, tworzy raport, którego wszystkie linie zaczynają się od #!#!. Częste przyczyny: addon taki jak skript-reflect lub SkBee nie pasuje do zainstalowanej wersji Skript albo plik pluginu został podmieniony przy działającym serwerze. Wtedy w raporcie pojawia się „zip file closed”. Dany skrypt nie działa, ale serwer działa dalej.
Jak to naprawić:
- Przeczytaj w raporcie linię „Current node” (wskazuje dany plik .sk) oraz linię „Caused by”.
- Sprawdź na stronach projektów, które wersje addonów pasują do Twojej wersji Skript, i doprowadź Skript oraz addony do wzajemnie zgodnych wersji.
- Podmieniaj pliki pluginów tylko przy zatrzymanym serwerze, a potem uruchom go ponownie.
- Załaduj skrypt poleceniem
/sk reload <plik>i przeczytaj wynik w zakładce Konsola.
Dobrze wiedzieć: Skrypty znajdziesz w zakładce Pliki w folderze plugins/Skript/scripts/. Zanim zmienisz plik, zrób jego kopię.
IndexOutOfBoundsException: „must be less than size”
Tak wygląda komunikat:
Caused by: java.lang.IndexOutOfBoundsException: index (1) must be less than size (1)
Co się za tym kryje: Gra, mod lub plugin odwołały się do elementu listy, który nie istnieje. „index (1) must be less than size (1)” oznacza: lista ma dokładnie jeden element o numerze 0, a zażądano numeru 1. Może mieć z tym związek konfiguracja, ale sam komunikat tego nie dowodzi. Jeśli poprzedza go „Caused by:”, jest on przyczyną błędu zgłoszonego wyżej. To, co przestaje działać, pokazuje ten wyższy komunikat.
Jak to naprawić:
- Przeczytaj pełny stacktrace w
logs/latest.log, także komunikat błędu nad nim. - Znajdź pierwszą linię „at”, która wskazuje zewnętrzny komponent, czyli plugin lub mod, a nie Javę ani bibliotekę taką jak
java.baseczycom.google.common. - Zaktualizuj ten komponent i uruchom serwer ponownie.
- Tylko jeśli kontekst wskazuje konkretną listę, np. pozycje menu lub nagrody, sprawdź jej konfigurację pod kątem brakujących lub pustych wpisów.
„Asynchronous Save Players”: Paper czeka na zapisanie danych graczy
Tak wygląda komunikat:
Asynchronous Save Players! Blocking thread until it returns
java.lang.IllegalStateException: null
at org.bukkit.craftbukkit.util.ServerShutdownThread.run(ServerShutdownThread.java:<Wiersz>)
Co się za tym kryje: Plugin może zlecić zapisanie danych wszystkich graczy z wątku w tle, czyli z równoległego toku pracy obok wątku głównego, który oblicza świat. Paper blokuje ten wątek, dopóki zapis się nie zakończy; mogą przy tym wystąpić krótkie przycięcia. Wariant z ServerShutdownThread pojawia się podczas wyłączania. W trakcie działania serwer po zapisie pracuje dalej; przy wyłączaniu komunikat jest częścią już trwającego procesu zamykania.
Jak to naprawić:
- Przeczytaj pełne wiersze „at” pod komunikatem. Pokazują one zaangażowane części programu; pierwsze z nich często należą do Paper lub Minecraft.
- Jeśli któryś z tych wierszy wskazuje plugin, zaktualizuj go w zakładce Pluginy i uruchom serwer ponownie. Jeśli ostrzeżenie nie znika, zgłoś je autorowi pluginu wraz z pełną listą wywołań.
- Jeśli lista pokazuje tylko części serwera i
ServerShutdownThread, przeczytaj w Konsola także wiersze sprzed wyłączenia. Sprawdź, czy serwer został właśnie zatrzymany zgodnie z planem. - Jeśli ostrzeżenie się powtarza bez rozpoznawalnego pluginu albo pojawiają się problemy z zapisem, otwórz zgłoszenie i podaj godzinę wystąpienia komunikatu.
„Unhandled exception executing command”: komenda pluginu się przerywa
Tak wygląda komunikat:
org.bukkit.command.CommandException: Unhandled exception executing command '<komenda>' in plugin <Plugin> v<Wersja>
Caused by: <Rodzaj błędu>: <Komunikat>
Co się za tym kryje: Plugin zgłosił błąd podczas wykonywania jednej ze swoich komend. Komenda i plugin są podane w komunikacie. Najczęściej plugin nie pasuje do wersji serwera albo do innego pluginu, od którego zależy. Osoba, która wpisała komendę, widzi na czacie zwykle tylko ogólną informację o błędzie wewnętrznym. Komenda nie została wykonana, serwer działa dalej.
Jak to naprawić:
- Przeczytaj wiersz „Caused by” pod komunikatem.
- Sprawdź w zakładce Wersja wersję swojego serwera i zaktualizuj plugin w zakładce Pluginy do wydania przeznaczonego dla niej.
- Jeśli wiersz błędu wskazuje inny plugin, od którego zależy ten plugin, również zaktualizuj go do pasującej wersji.
- Uruchom serwer ponownie i przetestuj komendę. Jeśli błąd nadal występuje, zgłoś go autorowi pluginu, podając ten wiersz.
Więcej o zależnościach: Plugin wymaga innego pluginu.
Błąd komendy z „[ACF]” w logu
Tak wygląda komunikat:
[<Plugin>] [ACF] Exception in command: <komenda>
[<Plugin>] [ACF] java.lang.NoSuchMethodError: <Metoda>
Co się za tym kryje: Wiele pluginów tworzy swoje komendy za pomocą gotowej biblioteki, Aikar Command Framework (ACF). Gdy komenda przerwie się z wyjątkiem, ACF wypisuje błąd wraz ze stacktrace'em, a przed każdym wierszem stoi nazwa pluginu. Nazwa w pierwszym nawiasie to więc plugin, którego dotyczy problem, a nie ACF. Jeśli w wyniku pojawia się „IncompatibleClassChangeError” lub „NoSuchMethod”, plugin nie pasuje do wersji serwera. Komenda nie została wykonana, serwer działa dalej.
Jak to naprawić:
- Odczytaj nazwę pluginu w pierwszym nawiasie kwadratowym oraz pierwszy wiersz błędu zawierający „Exception” lub „Error”.
- Zaktualizuj plugin w zakładce Pluginy do wersji przeznaczonej dla wersji twojego serwera.
- Uruchom serwer ponownie i przetestuj komendę.
- Jeśli błąd nie znika, zgłoś go autorowi pluginu, podając pierwszy wiersz błędu.
Warto wiedzieć: Nie musisz samodzielnie instalować ani aktualizować ACF. Jest on częścią danego pluginu.
GravesX: błąd w zadaniu w tle
Tak wygląda komunikat:
[GravesX] Async task for GravesX v<Wersja> generated an exception
java.lang.NullPointerException: Cannot invoke "<Metoda>" because "version2" is null
Co się za tym kryje: GravesX tworzy po śmierci gracza grób z jego przedmiotami. Plugin zgłasza w zadaniu w tle NullPointerException, na przykład przy porównywaniu dwóch numerów wersji, gdy brakuje jednej wartości („version2”). To błąd w samym pluginie, a nie problem serwera czy hostingu. Serwer działa normalnie dalej.
Jak to naprawić:
- Zaktualizuj GravesX w zakładce Pluginy do najnowszej wersji i uruchom serwer ponownie.
- Sprawdź w Konsola, czy komunikat się powtarza.
- Jeśli błąd nadal występuje, zgłoś go w projekcie GravesX, podając pełny komunikat.
- Jeśli do czasu poprawki chcesz testowo wyłączyć plugin, najpierw opróżnij otwarte groby. Bez pluginu nie da się ich otworzyć w zwykły sposób.
FastAsyncWorldEdit: komenda zakończyła się błędem wewnętrznym
Tak wygląda komunikat:
An unexpected error while handling a FastAsyncWorldEdit command
java.lang.NullPointerException
Co się za tym kryje: FastAsyncWorldEdit (FAWE) to szybka odmiana WorldEdit, za pomocą której edytujesz duże obszary naraz. Podczas wykonywania komendy FAWE natrafił na brakującą wartość. Operacja nie została wykonana w całości, więc zmiana mogła trafić do świata tylko częściowo. Serwer działa dalej.
Jak to naprawić:
- Sprawdź w grze, co zmieniła komenda. W razie potrzeby cofniesz ostatni krok za pomocą
//undo. - Zaktualizuj FAWE w zakładce Pluginy do wydania przeznaczonego dla wersji twojego serwera i uruchom serwer ponownie.
- Wykonaj komendę jeszcze raz.
- Jeśli błąd nie znika, zgłoś twórcom FAWE pełny stacktrace wraz z dokładną komendą.
Podstawy cofania zmian: WorldEdit: budowanie i cofanie zmian.
Warto wiedzieć: Nie instaluj FAWE równolegle ze zwykłym WorldEdit. Oba razem się nie dogadują; używaj tylko jednego z nich.
„An unexpected exception occurred while performing command”: komenda LibreLogin kończy się błędem
Tak wygląda komunikat:
[LibreLogin] An unexpected exception occurred while performing command …
Co się za tym kryje: LibreLogin to plugin do logowania: gracze logują się hasłem, często na serwerach w trybie offline. Podczas wykonywania jednej z jego komend, na przykład logowania lub rejestracji, przerwał działanie z nieoczekiwanym wyjątkiem. Dla gracza komenda kończy się niepowodzeniem. Jeśli dotyczy to logowania, gracz nie może przejść dalej, dopóki komenda znów nie zadziała. Sam serwer działa dalej.
Jak to naprawić:
- Przeczytaj w Konsola wyjątek pod komunikatem i zanotuj, której komendy dotyczył.
- Zaktualizuj LibreLogin w zakładce Pluginy i uruchom serwer ponownie.
- Przetestuj komendę ponownie z udziałem gracza.
- Jeśli błąd nie znika, zgłoś autorowi pluginu wyjątek wraz z komendą.
Jeśli wyjątek wskazuje bazę danych: Plugin nie może otworzyć swojej bazy danych.
LibreLogin: handler sieciowy jest zarejestrowany dwukrotnie
Tak wygląda komunikat:
java.lang.IllegalArgumentException: Duplicate handler name: pe-decoder-librelogin
Co się za tym kryje: Każde połączenie gracza przechodzi przez łańcuch kroków przetwarzania, czyli potok sieciowy (pipeline). LibreLogin lub biblioteka PacketEvents próbuje drugi raz wstawić ten sam krok, czyli dekoder danych przychodzących. Nowe połączenia mogą wtedy kończyć się niepowodzeniem. Typowe przyczyny to dwa pliki LibreLogin w folderze pluginów, niepasujące do siebie wersje LibreLogin i PacketEvents albo przeładowanie pluginów podczas działania serwera.
Jak to naprawić:
- Otwórz w zakładce Pliki folder
plugins/i sprawdź, czy LibreLogin występuje tylko raz. Usuń starsze kopie, gdy już utworzysz kopię zapasową. - Zaktualizuj jednocześnie LibreLogin i, jeśli jest zainstalowany, PacketEvents.
- Zatrzymaj serwer i uruchom go całkowicie od nowa. Przeładowanie za pomocą
/reloadlub menedżera pluginów tutaj nie wystarczy. - Przetestuj dołączanie do serwera jednym graczem.
Więcej o zduplikowanych plikach: Plik pluginu jest uszkodzony lub zduplikowany.
LightAntiCheat-Plus: błąd w jednym ze sprawdzeń ruchu
Tak wygląda komunikat:
[LightAntiCheat-Plus] Exception in event bus subscription: <Sprawdzenie>
java.lang.UnsupportedOperationException: remove
Co się za tym kryje: LightAntiCheat-Plus to plugin anty-cheatowy, który sprawdza między innymi ruch graczy. Jedno z jego sprawdzeń próbuje wyczyścić listę, której nie można zmieniać. To błąd w pluginie. Dane sprawdzenie może przestać działać lub zwracać błędne wyniki, czyli przeoczyć cheaty albo niesłusznie podejrzewać uczciwych graczy. Serwer działa dalej.
Jak to naprawić:
- Zaktualizuj LightAntiCheat-Plus w zakładce Pluginy i uruchom serwer ponownie.
- Jeśli komunikat nadal się pojawia, do czasu poprawki wyłącz problematyczne sprawdzenie SpeedD w konfiguracji pluginu. Znajdziesz ją w zakładce Pliki w folderze pluginu w
plugins/. Wcześniej zrób kopię pliku. - Uruchom serwer ponownie i sprawdź w zakładce Konsola, czy komunikat zniknął.
- Włącz sprawdzenie z powrotem, gdy tylko pojawi się poprawiona wersja.
Warto wiedzieć: Dopóki pojawia się ten komunikat, podchodź ostrożnie do podejrzeń dotyczących ruchu.
MagicSpells zgłasza błąd przy zaklęciu
Tak wygląda komunikat:
[MagicSpells] AN EXCEPTION HAS OCCURED:
[MagicSpells] This error has been saved in the errors folder.
Error saving spellbook for player '<Gracz>'
Co się za tym kryje: MagicSpells to plugin do tworzenia własnych zaklęć. Zgłasza błąd podczas rzucania lub zapisywania zaklęć, często z powodu wpisu w konfiguracji, którego ta wersja nie rozumie. Efekty działają przez bibliotekę EffectLib; komunikaty z „Unexpected EffectLib Error” dotyczą tych efektów. Dodatkowo MagicSpells zapisuje raport w folderze plugins/MagicSpells/errors. Jeśli zapis księgi zaklęć (spellbook) się nie powiedzie, stan tego gracza nie zostanie zapisany.
Jak to naprawić:
- Otwórz w zakładce Pliki folder
plugins/MagicSpells/errorsi najnowszy raport. Wskazuje on zaklęcie i ustawienie. - Sprawdź to ustawienie w swoich plikach zaklęć, np. pod kątem literówek lub wartości ze starszej wersji MagicSpells. Wcześniej zrób kopię pliku.
- Dbaj o to, by MagicSpells i EffectLib były aktualne i pasowały do wersji serwera.
- Uruchom serwer ponownie i przetestuj zaklęcie.
SinglePlayerSleep: spanie w łóżku nie działa
Tak wygląda komunikat:
[SinglePlayerSleep] INTERNAL ERROR: Unable to process PlayerBedEnterEvent
Co się za tym kryje: SinglePlayerSleep sprawia, że noc mija, gdy śpi jeden gracz, zamiast wymagać, by wszyscy poszli do łóżka. Plugin uległ awarii przy wchodzeniu do łóżka. Funkcja spania może przy tej próbie nie zadziałać i noc nie zostanie pominięta. Zwykle wersja pluginu nie pasuje do wersji Minecrafta. Serwer działa dalej.
Jak to naprawić:
- Sprawdź w zakładce Wersja, jaka wersja Minecrafta jest uruchomiona.
- Zaktualizuj SinglePlayerSleep w zakładce Pluginy do wersji przeznaczonej dla tej wersji gry i uruchom serwer ponownie.
- Przetestuj w grze: połóż się w nocy do łóżka i sprawdź, czy noc mija.
- Jeśli błąd nie znika, zgłoś autorowi pluginu wyjątek widoczny pod komunikatem.
Więcej na ten temat: Zasady gry w Minecraft – wyjaśnienie.
Warto wiedzieć: Nowsze wersje Minecrafta mają własną zasadę gry określającą, jaki procent graczy musi spać. Może ona zastąpić ten plugin.
PacketEvents nie może podłączyć się do połączenia
Tak wygląda komunikat:
PacketEvents failed to add a decoder to the netty pipeline
Co się za tym kryje: PacketEvents to biblioteka, przez którą inne pluginy, np. anty-cheatowe lub logowania, odczytują pakiety sieciowe. W tym celu wstawia ona własny krok, dekoder, do potoku sieciowego każdego połączenia. Netty to biblioteka sieciowa, za pomocą której serwer obsługuje połączenia. Wstawienie się nie powiodło: inny handler sieciowy lub niekompatybilna wersja PacketEvents blokuje oczekiwaną kolejność. Pluginy oparte na PacketEvents nie działają wtedy prawidłowo dla tego połączenia.
Jak to naprawić:
- Zaktualizuj jednocześnie PacketEvents, Geyser i Floodgate oraz pluginy logowania i anty-cheatowe do wersji przeznaczonych dla Twojej wersji serwera.
- Sprawdź w zakładce Pliki w folderze
plugins/, czy żaden plik nie występuje podwójnie. - Zatrzymaj serwer i uruchom go całkowicie od nowa, bez przeładowywania podczas działania.
- Przetestuj dołączanie z Java Edition oraz, jeśli używasz Geysera, również z Bedrock Edition.
Dla graczy Bedrock: Bedrock i Geyser: komunikaty w logu.
StringIndexOutOfBoundsException: pusta lub zbyt krótka wartość tekstowa
Tak wygląda komunikat:
java.lang.StringIndexOutOfBoundsException: Index 0 out of bounds for length 0
Co się za tym kryje: Plugin lub mod chciał odczytać konkretny znak z tekstu, na przykład pierwszy znak prefiksu. Tekst jest jednak krótszy, a przy „length 0” nawet pusty. Często jakaś oczekiwana wartość konfiguracji jest pusta, na przykład prefiks, kolor albo nazwa wpisana tylko jako ''. Serwer działa dalej; funkcja, która potrzebuje tego tekstu, zawodzi.
Jak to naprawić:
- Odczytaj w śledzeniu stosu pierwszą linię z nazwą pluginu lub moda.
- Zabezpiecz w Plikach konfigurację wskazanego pluginu lub moda. Porównaj puste wartości takie jak
''lub wpisy bez wartości z odpowiednim szablonem; dokumentacja danego komponentu wskazuje miejsce przechowywania. - Uzupełnij brakujące wymagane wartości lub przejmij domyślną wartość z szablonu.
- Zaktualizuj plugin lub moda do wersji odpowiadającej wersji serwera i uruchom go ponownie.
Więcej o błędnych ustawieniach: Plik konfiguracyjny pluginu jest nieprawidłowy.
„NoSuchFieldException: childHandler”: plugin sieciowy nie pasuje do serwera
Tak wygląda komunikat:
java.lang.NoSuchFieldException: childHandler
Co się za tym kryje: Netty to biblioteka sieciowa, za pomocą której serwer przyjmuje połączenia. Niektóre pluginy sięgają bezpośrednio do jej wewnętrznych elementów, aby podpiąć się pod połączenia. Tutaj plugin sieciowy szuka wewnętrznego pola „childHandler”, które nie jest dostępne w zainstalowanej wersji serwera lub Netty. Plugin został więc zbudowany dla innego buildu serwera. Dotyczy to zwykle pluginów sieciowych, proxy lub protokołów; ich funkcje przestają działać.
Jak to naprawić:
- Przeczytaj stacktrace pod komunikatem i znajdź pierwszy plugin sieciowy, proxy lub protokołu, na przykład ViaVersion, ProtocolLib lub Geyser.
- Sprawdź w sekcji Wersja, jaka wersja serwera jest uruchomiona. Dokładne wydanie oprogramowania serwera (build) znajdziesz też w pierwszych liniach pliku
logs/latest.log. - Zaktualizuj znaleziony plugin do wersji przeznaczonej dla tego buildu serwera i uruchom serwer ponownie.
- Jeśli pasująca wersja jeszcze nie istnieje, tymczasowo wyłącz plugin, dopóki autor go nie zaktualizuje.
Więcej szczegółów: Plugin nie pasuje do wersji serwera.
„Unhandled exception during tab completion”: polecenie pluginu nie podpowiada
Tak wygląda komunikat:
Exception when <Gracz> attempted to tab complete
org.bukkit.command.CommandException: Unhandled exception during tab completion for command '<Polecenie>' in plugin <Plugin> v<Wersja>
Co się za tym kryje: Po naciśnięciu klawisza Tab Minecraft pyta odpowiedni plugin o możliwe uzupełnienia. Funkcja podpowiedzi pluginu kończy się przy tym błędem. Pierwsza linia podaje gracza, który nacisnął klawisz Tab. Serwer działa dalej, brakuje tylko podpowiedzi dla danego polecenia. Ślad błędu poniżej, czyli tak zwany stacktrace, pokazuje wywołania programu, które brały w tym udział.
Jak to naprawić:
- Przeczytaj pełny komunikat w Konsola lub w sekcji Pliki w pliku
logs/latest.log. Zanotuj plugin, polecenie i pierwszy konkretny komunikat błędu poniżej. - Sprawdź w sekcji Wersja wersję swojego serwera i zainstaluj w sekcji Pluginy odpowiednie dla niej wydanie wskazanego pluginu.
- Uruchom serwer całkowicie od nowa i ponownie przetestuj to samo polecenie klawiszem Tab.
- Jeśli błąd nie znika, wyślij autorowi pluginu pełny ślad błędu i opisz, w którym miejscu brakuje podpowiedzi.
StackOverflowError podczas przetwarzania reguły wyszukiwania
Tak wygląda komunikat:
Exception in thread "<Zadanie w tle>" java.lang.StackOverflowError
Co się za tym kryje: Wyrażenie regularne to reguła wyszukiwania w tekście, na przykład dla filtrów poleceń. Podczas sprawdzania tej reguły Java potrzebuje zbyt wielu zagnieżdżonych wywołań i zapełnia w ten sposób stos wywołań. Wskazane zadanie w tle zostaje przerwane, a jego praca pozostaje niedokończona; serwer działa dalej. StackOverflowError to inny błąd niż zapełniona pamięć robocza Javy.
Jak to naprawić:
- Otwórz pełny ślad błędu w Konsola lub w sekcji Pliki w pliku
logs/latest.log. Na podstawie nazwy wątku i wywołań pluginów znajdź odpowiedzialny plugin. - Zabezpiecz jego ustawienia i sprawdź konfigurowalne reguły wyszukiwania lub poleceń. Uprość regułę wywołującą błąd, jeśli ustawiłeś ją samodzielnie.
- Zaktualizuj plugin w sekcji Pluginy do pasującego wydania i uruchom serwer całkowicie od nowa.
- Jeśli reguła jest wbudowana na stałe, zgłoś autorowi pełny ślad błędu oraz dane wejściowe, przy których występuje.
Paper blokuje „entity add” z wątku działającego w tle
Tak wygląda komunikat:
Thread <Wątek> failed main thread check: entity add
Co się za tym kryje: Paper sprawdza, czy zmiany w świecie gry są wykonywane we właściwym wątku. Wątek to osobna ścieżka wykonywania programu. Tutaj zadanie w tle próbuje dodać istotę do świata i zostaje zatrzymane przez mechanizm ochronny. Dana akcja kończy się niepowodzeniem; serwer działa dalej.
Jak to naprawić:
- Otwórz w Konsola lub w sekcji Pliki pełny ślad błędu w pliku
logs/latest.log. Skrócony komunikat często pokazuje tylko wywołania serwera. - Czytaj dalej aż do pierwszego wywołania pluginu i zanotuj, jaka akcja wywołała błąd.
- Zainstaluj w sekcji Pluginy wydanie tego pluginu pasujące do wersji twojego serwera i uruchom serwer całkowicie od nowa.
- Jeśli błąd nadal występuje, zgłoś go autorowi pluginu wraz z pełnym śladem błędu. Wywołanie pluginu musi zostać przeniesione do właściwego wątku.
Dobrze wiedzieć: Pozostaw mechanizm ochronny włączony. Jego wyłączenie nie naprawi błędnego dostępu do świata.
„Missing required parameters”: brakuje wymaganych wartości dla łupu
Tak wygląda komunikat:
java.lang.IllegalArgumentException: Missing required parameters: [<Parametr>]
Co się za tym kryje: Minecraft potrzebuje do generowania łupu i przedmiotów informacji o danej sytuacji. Wywołująca funkcja nie dostarcza tu wszystkich wymaganych wartości. Dlatego to obliczenie zostaje przerwane. Której akcji to dotyczy, rozpoznasz po pełnym raporcie błędu i momencie pojawienia się komunikatu.
Jak to naprawić:
- Otwórz komunikat w Konsola lub w Pliki w
logs/latest.log, łącznie z następującą po nim listą wywołań. Ta lista nazywa się stacktrace. - Znajdź w niej pierwszy wywołujący plugin lub element serwera i zanotuj akcję, która wywołała błąd.
- Jeśli zaangażowany jest plugin, zaktualizuj go w Pluginy. Zaktualizuj też oprogramowanie serwera w Wersja do pasującej wersji.
- Przetestuj ponownie tę samą akcję. Jeśli błąd nadal występuje, przekaż odpowiedniemu projektowi pełny raport i akcję, która go wywołuje.
„NoSuchElementException” w Oritech: akcja przedmiotu na bloku zostaje przerwana
Tak wygląda komunikat:
Failed to handle packet <Pakiet>, suppressing error
java.util.NoSuchElementException: null
at <Pakiet>.ItemFluidApi.tryFluidBlockItemInteraction(<Plik>:<Linia>)
Co się za tym kryje: Mod Oritech przetwarza akcję, w której przedmiot zostaje użyty na bloku. Jego obsługa płynów próbuje przy tym odczytać pierwszy wpis z pustej listy. Java zgłasza wtedy NoSuchElementException, czyli próbę dostępu do nieistniejącego wpisu. Akcja zostaje przerwana; serwer dalej wykonuje inne zadania.
Jak to naprawić:
- Zanotuj użyty przedmiot, blok i godzinę. Przed wprowadzeniem zmian utwórz kopię zapasową w sekcji Kopie zapasowe.
- Sprawdź w sekcji Mody, czy dostępna jest pasująca aktualizacja Oritech. Wersja Minecraft, loader oraz – w przypadku Modpack – przewidziane w nim wersje modów muszą do siebie pasować.
- Jeśli błąd nadal występuje, na razie unikaj akcji, która go wywołuje. Zgłoś ją autorowi Oritech wraz z pełnym śladem błędu z pliku
logs/latest.log.
BeautyQuests: postęp zadania nie aktualizuje się na tablicy bocznej
Tak wygląda komunikat:
[BeautyQuests.ScoreboardManager] Failed to refresh line {quest_advancement} for player <Gracz>
java.util.NoSuchElementException: No value present
Co się za tym kryje: BeautyQuests wstawia na tablicy bocznej placeholder z postępem zadania. Brakuje przy tym wartości liczbowej, której oczekuje plugin. Dana linia tablicy nie jest aktualizowana, ale serwer działa dalej.
Jak to naprawić:
- Sprawdź w Konsola lub w Pliki w
logs/latest.log, przy którym zadaniu pojawia się komunikat. Ślad błędu poniżej pokazuje zaangażowane wywołania pluginu. - Zabezpiecz konfigurację pluginu i zaktualizuj BeautyQuests w Pluginy do wydania pasującego do wersji twojego serwera. Uruchom serwer w pełni ponownie.
- Jeśli błąd nadal występuje, tymczasowo usuń w Pliki linię tablicy z
{quest_advancement}z konfiguracji BeautyQuests. - Zgłoś autorowi pluginu pełny, oczyszczony ślad błędu oraz konfigurację danego zadania. Przed przekazaniem usuń dane osobowe.
TAB po przeładowaniu używa odrzuconego obiektu
Tak wygląda komunikat:
[TAB] java.lang.IllegalStateException: This instance got discarded because plugin was reloaded. Obtain a new instance.
Co się za tym kryje: TAB podczas przeładowania zastąpił wewnętrzne obiekty. Inna operacja wciąż odwołuje się do starego obiektu, który TAB już odrzucił. W efekcie rejestracja danego placeholdera zostaje przerwana i może brakować części wyświetlanych informacji. Serwer działa dalej.
Jak to naprawić:
- Uruchom serwer w pełni ponownie, a następnie sprawdź Konsola. Pełny restart ładuje wszystkie zaangażowane komponenty ponownie razem.
- Jeśli komunikat wraca, zabezpiecz konfigurację i zaktualizuj TAB oraz jego rozszerzenia do zgodnych ze sobą wersji. Na Fabric używasz Mody, a dla samodzielnie wgranych plików Pliki.
- Na razie korzystaj z pełnych restartów. Zanotuj, która operacja ponownie wywołuje komunikat.
- Przy utrzymujących się błędach przekaż autorowi TAB oczyszczony ślad błędu i zainstalowane wersje.
Plugin pozostawia działające zadania w tle przy przeładowaniu lub zatrzymaniu
Tak wygląda komunikat:
Nag author: '<Author>' of '<Plugin>' about the following: This plugin is not properly shutting down its async tasks when it is being shut down.
Co się za tym kryje: Wskazany plugin nie kończy poprawnie swoich zadań asynchronicznych. Są to prace wykonywane obok głównej pętli serwera. Po przeładowaniu stare i nowe zadania pluginu mogą wchodzić ze sobą w konflikt; przy zwykłym zatrzymaniu mogą jeszcze pojawić się komunikaty o błędach.
Jak to naprawić:
- Sprawdź w Konsola, który plugin jest wymieniony i czy komunikat pojawia się przy przeładowaniu, czy przy normalnym zatrzymaniu.
- Jeśli wystąpił po przeładowaniu, uruchom serwer w pełni ponownie. Przy zmianach pluginów korzystaj od tej pory z pełnych restartów.
- Zabezpiecz konfigurację pluginu i zaktualizuj dany plugin w Pluginy do pasującej wersji.
- Jeśli komunikat nadal pojawia się przy zwykłych zatrzymaniach, zgłoś go autorowi pluginu wraz z odpowiednimi liniami logu i wersją swojego serwera.
Paper blokuje dostęp do POI z wątku w tle
Tak wygląda komunikat:
[ca.spottedleaf.moonrise.common.util.TickThread] Thread failed main thread check: Accessing poi chunk off-main, context=<Kontekst wątku>
Co się za tym kryje: POI oznacza „Point of Interest” i opisuje ważne miejsca, na przykład stanowiska pracy osadników. Wątek w tle próbuje tutaj uzyskać dostęp do powiązanych danych fragmentu świata. Paper dopuszcza taki dostęp tylko w odpowiedzialnym wątku gry i przerywa daną operację.
Jak to naprawić:
- Otwórz w Konsola lub w Pliki w
logs/latest.logpełny ślad błędu. To linie wywołań pod komunikatem; sprawdź, czy wymieniony jest w nich jakiś plugin. - Utwórz kopię zapasową w Kopie zapasowe. Zaktualizuj Paper w Wersja oraz zaangażowane pluginy w Pluginy do zgodnych ze sobą wydań.
- Uruchom serwer w pełni ponownie i obserwuj, czy ta sama operacja znów wywołuje błąd.
- Jeśli komunikat utrzymuje się bez związku z pluginem, przekaż zespołowi Paper oczyszczony ślad błędu, wersję serwera i kroki prowadzące do jego wywołania. Jeśli wymieniony jest plugin, zgłoś to jego autorowi.
Dane gracza LuckPerms nie są jeszcze gotowe podczas dołączania
Tak wygląda komunikat:
Couldn't place player in world
java.lang.IllegalStateException: Capability has not been initialised
Co się za tym kryje: Dołączenie kończy się niepowodzeniem przy sprawdzaniu uprawnień. Ślad błędu prowadzi przez LuckPerms; jego magazyn danych powiązany z graczem, tzw. Capability, nie jest w tym momencie jeszcze gotowy. W rezultacie dany gracz nie zostaje poprawnie umieszczony w świecie.
Jak to naprawić:
- Przeczytaj w Konsola lub w
logs/latest.logkomunikaty LuckPerms przed błędem i zanotuj zaangażowane mody. - Sprawdź w Mody, czy LuckPerms i mod wykonujący zapytanie pasują do twojej wersji NeoForge i Minecraft. Używaj wydań, które są obsługiwane przez oba.
- Uruchom serwer w pełni ponownie i przetestuj dołączanie jeszcze raz. Jeśli błąd się utrzymuje, zgłoś go autorom zaangażowanych modów wraz z pełnym śladem błędu i informacjami o wersjach.
Zapytanie o ciecz nie znajduje oczekiwanego kotła
Tak wygląda komunikat:
java.lang.IllegalStateException: Unexpected error: no cauldron at location BlockPos{<Pozycja>}
Co się za tym kryje: Interfejs cieczy oczekuje w sprawdzanym miejscu kotła, ale napotyka inny stan bloku. W śladzie błędu Jade odpytuje ten interfejs, aby odczytać informacje o cieczy. Dane zapytanie zostaje przerwane; w efekcie może brakować informacji o tym bloku.
Jak to naprawić:
- Przeczytaj pełny ślad błędu w
logs/latest.logi sprawdź, przy jakiej akcji na bloku komunikat się powtarza. - Utwórz kopię zapasową w Kopie zapasowe. Dopasuj w Mody Jade, zaangażowane mody cieczy oraz wersję NeoForge do wspólnie obsługiwanych wydań.
- Uruchom serwer w pełni ponownie i powtórz akcję. Jeśli błąd się utrzymuje, zgłoś dokładną akcję i ślad błędu zaangażowanym autorom.
MoreRelics oblicza nieprawidłową wartość liczbową podczas akcji bojowej
Tak wygląda komunikat:
Exception caught during firing event: max is NaN
Co się za tym kryje: NaN oznacza „Not a Number”, czyli nieprawidłową wartość obliczeniową. Podczas akcji bojowej MoreRelics przekazuje tę wartość jako górną granicę do sprawdzenia liczbowego. Sprawdzenie ją odrzuca, a obsługa danego zdarzenia zostaje przerwana; serwer przetwarza potem kolejne zdarzenia.
Jak to naprawić:
- Przeczytaj w Konsola lub w
logs/latest.logpełny ślad błędu i zanotuj akcję, która go wywołała. - Utwórz kopię zapasową w zakładce Kopie zapasowe. Sprawdź w zakładce Mody wydanie MoreRelics dopasowane do Twojego Modpack i NeoForge.
- Uruchom serwer całkowicie od nowa i przetestuj tę samą akcję. Jeśli błąd nie znika, zgłoś go autorowi, podając ślad błędu, listę modów oraz użyte przedmioty lub efekty.
Citizens zawodzi przy wysyłaniu danych pakietów z powodu pustej wartości
Tak wygląda komunikat:
java.lang.NullPointerException
at Citizens-<Wersja>.jar//net.citizensnpcs.PacketEventsHook.<Metoda>(<Plik>:<Linia>)
Co się za tym kryje: Podczas wysyłania danych pakietów Citizens odwołuje się przez swoje połączenie z PacketEvents do brakującej wartości. Java nazywa taką pustą wartość null i przerywa działanie z wyjątkiem NullPointerException. Obsługa danego pakietu kończy się niepowodzeniem; aktualizacje NPC, czyli postaci sterowanych przez komputer, mogą być przez to niekompletne.
Jak to naprawić:
- Przeczytaj pełny ślad błędu w
logs/latest.logi zanotuj, przy jakiej akcji NPC występuje błąd. - Zabezpiecz bieżący stan w zakładce Kopie zapasowe. Sprawdź w zakładce Pluginy wspólnie obsługiwane wydania Citizens, PacketEvents i Twojego oprogramowania serwera.
- W razie potrzeby podmień pliki w zakładce Pliki, uruchom serwer całkowicie od nowa i przetestuj tę samą akcję. Jeśli błąd nie znika, zgłoś autorowi ślad błędu i informacje o wersjach.
NovaSync nie znajduje pomocnika do aktualizacji systemu operacyjnego
Tak wygląda komunikat:
[NovaSyncPlugin] [os-updates] helper start failed subcmd=status err=IOException:Cannot run program "sudo": Exec failed, error: 2 (No such file or directory)
Co się za tym kryje: NovaSync próbuje uruchomić zewnętrzny program pomocniczy do aktualizacji systemu operacyjnego. W tym celu plugin wywołuje sudo, czyli program do wykonywania poleceń z uprawnieniami innego użytkownika. Środowisko serwera nie znajduje tego programu, dlatego przygotowanie lub sprawdzenie statusu funkcji aktualizacji kończy się niepowodzeniem. Serwer gry działa dalej.
Jak to naprawić:
- Przeczytaj w Konsola lub w zakładce Pliki w
logs/latest.logpełny komunikat i zanotuj godzinę. - Sprawdź w dokumentacji zainstalowanej wersji NovaSync wymagania dla os-updates i potrzebnego pomocnika.
- Otwórz zgłoszenie i podaj godzinę komunikatu oraz wersję pluginu, aby wyjaśnić dostępność pomocnika w Twoim środowisku serwera.
Dobrze wiedzieć: Komunikat dotyczy funkcji aktualizacji systemu operacyjnego w NovaSync, a nie aktualizacji Twoich pluginów Minecraft.
ProtocolLib nie może przyporządkować raportu o błędzie
Tak wygląda komunikat:
[ProtocolLib] Error filtering reports: java.lang.IllegalArgumentException: Cannot find report name for Plugin %s tried to register listener for unknown packet %s
Co się za tym kryje: ProtocolLib pomaga innym pluginom w obsłudze pakietów sieciowych, czyli wiadomości przesyłanych między serwerem a klientem gry. W tym przypadku dodatkowo nie udaje się przyporządkować raportu diagnostycznego. Raport dotyczy rejestracji nieznanego typu pakietu. Serwer działa dalej; należy sprawdzić daną funkcję pakietów i jej diagnostykę.
Jak to naprawić:
- Przeczytaj w Konsola lub w
logs/latest.loglinie bezpośrednio przed komunikatem i po nim. Poszukaj tam zaangażowanego pluginu i typu pakietu. - Sprawdź obsługiwane wersje serwera dla ProtocolLib i tego pluginu. Zaktualizuj oba w zakładce Pluginy do pasujących wydań.
- Zatrzymaj serwer przed podmianą plików, a następnie uruchom go całkowicie od nowa. Ponownie sprawdź funkcję, której dotyczył problem.
- Jeśli komunikat nie znika, przekaż autorowi pluginu pełny blok błędu i używane wersje.
EliteMobs nie może włączyć swojej funkcji amunicji
Tak wygląda komunikat:
[EliteMobs] Cannot enable native ammunition for <Połączenie>: java.util.NoSuchElementException: packet_handler
Co się za tym kryje: EliteMobs próbuje skonfigurować swoją natywną funkcję amunicji dla połączenia. Handler to wewnętrzny etap przetwarzania danych sieciowych. Oczekiwanego etapu o nazwie packet_handler brakuje w sprawdzanym miejscu. Przez to ta część funkcji nie zostaje włączona; serwer działa dalej.
Jak to naprawić:
- Przeczytaj w Konsola lub w
logs/latest.logsąsiednie komunikaty. Zwróć uwagę na wcześniejsze błędy podczas nawiązywania połączenia. - Porównaj wersje serwera obsługiwane przez EliteMobs ze swoją Wersja. Sprawdź też zależności wskazane przez autora.
- Zatrzymaj serwer i zaktualizuj EliteMobs w zakładce Pluginy do pasującego wydania. Następnie uruchom serwer całkowicie od nowa i przetestuj daną funkcję.
- Jeśli błąd nie znika, zgłoś go autorowi EliteMobs, podając pełny blok błędu, wersję serwera i listę pluginów. Te informacje pomogą zawęzić brakujący etap przetwarzania.
LuckPerms blokuje sprzecznie dopuszczone logowanie
Tak wygląda komunikat:
[LuckPerms] Player connection was re-allowed for <ID-gracza>
Co się za tym kryje: Podczas dołączania gracza pluginy podjęły sprzeczne decyzje. LuckPerms blokuje ponownie dopuszczone połączenie, aby zabezpieczyć obsługę uprawnień. Dane dołączenie kończy się niepowodzeniem; serwer działa dalej.
Jak to naprawić:
- Przeczytaj w Konsola lub w
logs/latest.logkomunikaty bezpośrednio przed nieudanym dołączeniem. Poszukaj błędów wczytywania danych i komunikatów pluginów logowania. - Jeśli pojawia się błąd bazy danych lub wczytywania danych, najpierw usuń ten błąd. Następnie sprawdź, który plugin logowania cofa wcześniejszą odmowę.
- Zaktualizuj dane komponenty w zakładce Pluginy do wydań zgodnych ze sobą i z wersją serwera. Zatrzymaj serwer przed podmianą, a potem uruchom go ponownie.
- Przetestuj ponownie dołączanie. Jeśli konflikt nie znika, przekaż autorom zaangażowanych pluginów pełny blok błędu i listę pluginów.
Dobrze wiedzieć: Nie wyłączaj weryfikacji logowania, aby obejść konflikt.
Apotheosis: akcja na bloku kończy się błędem przez pusty przedmiot
Tak wygląda komunikat:
Failed to handle packet <Pakiet>, suppressing error
java.lang.IllegalArgumentException: Expected resource to be non-empty: minecraft:air [0]
at <Loader>/dev.shadowsoffire.apotheosis.affix.salvaging.<Wywołanie>
Co się za tym kryje: Podczas akcji na bloku Apotheosis wywołuje swoją funkcję rozbierania przedmiotów. Przekazuje przy tym pusty stos przedmiotów do interfejsu transferu NeoForge, który wymaga istniejącego przedmiotu. Dlatego interakcja zostaje przerwana, a serwer działa dalej. Stacktrace, czyli łańcuch wywołań pod komunikatem błędu, prowadzi tu przez Apotheosis i NeoForge.
Jak to naprawić:
- Zabezpiecz aktualny stan w sekcji Kopie zapasowe. Zanotuj, która akcja na bloku wywołuje komunikat, i na razie jej unikaj.
- Otwórz pełny komunikat w Konsola lub przez Pliki w
logs/latest.log. Zapisz także wiersze poprzedzające błąd. - Sprawdź w sekcji Mody, czy Apotheosis i wymagane przez niego mody pasują do Twojej wersji Minecraft i NeoForge. W przypadku Modpack używaj spójnej wersji paczki. Zatrzymaj serwer przed wymianą plików, a potem uruchom go ponownie.
- Jeśli komunikat nadal się pojawia, przekaż autorowi moda pełny ślad błędu, zainstalowane wersje i akcję, która go wywołuje.
ProtocolLib: plugin pyta o UUID tymczasowego gracza
Tak wygląda komunikat:
[<Plugin>] Unhandled exception occurred in onPacketSending(PacketEvent) for <Plugin>
java.lang.UnsupportedOperationException: The method getUniqueId is not supported for temporary players.
Co się za tym kryje: Podczas nawiązywania połączenia ProtocolLib udostępnia tymczasowe obiekty graczy. Unikalnego identyfikatora konta UUID nie da się jeszcze z takiego obiektu odczytać. Mimo to pewien plugin próbuje to zrobić podczas wysyłania pakietu. Jego handler pakietów, czyli odpowiedzialna za to funkcja przetwarzająca, zostaje przez to przerwany; serwer działa dalej.
Jak to naprawić:
- Sprawdź w Konsola, który plugin jest wymieniony po „for”. Zapisz pełny ślad błędu z
logs/latest.log. - Sprawdź w sekcji Pluginy, czy ten plugin i ProtocolLib obsługują wersję Twojego serwera widoczną w Wersja. Używaj wydań, które do siebie pasują.
- Zatrzymaj serwer przed wymianą plików. Następnie uruchom go w pełni ponownie i jeszcze raz przetestuj dołączanie.
- Jeśli błąd nie znika, zgłoś go autorowi danego pluginu, dołączając pełny ślad błędu, zainstalowane wersje i akcję, która go wywołuje.
GodWand: nieprawidłowy pakiet czasu odnowienia
Tak wygląda komunikat:
java.lang.IllegalArgumentException: Invalid skill cooldown packet
at net.godwand.network.SkillCooldownPayload.<init>(<Plik>:<Wiersz>)
Co się za tym kryje: Podczas używania różdżki GodWand odrzuca pakiet z czasem odnowienia umiejętności. Ten czas określa, kiedy można ponownie użyć umiejętności. Akcja przedmiotu kończy się niepowodzeniem, a serwer działa dalej.
Jak to naprawić:
- Otwórz Konsola lub
logs/latest.logi przeczytaj pełny komunikat. Następujący po nim ślad błędu, zwany też stacktrace, wskazuje zaangażowaną klasę GodWand. - Porównaj wersje GodWand na serwerze i u klientów. Sprawdź w sekcji Mody także obsługiwane wersje Minecraft i NeoForge.
- Zatrzymaj serwer, zainstaluj pasujące wydanie i uruchom go w pełni ponownie. Ponownie przetestuj akcję przedmiotu.
- Jeśli błąd nie znika, zgłoś autorowi moda ślad błędu i akcję, która go wywołuje. Usuń z raportu dane osobowe.
ModelEngine: brak adresu skina dla modelu gracza
Tak wygląda komunikat:
java.lang.RuntimeException: Skin URL is null
at com.ticxo.modelengine.api.model.limb.UserLimbRegistry.generate(<Plik>:<Wiersz>)
Co się za tym kryje: Przy dołączaniu gracza ModelEngine próbuje utworzyć części modelu na podstawie jego skina. Brakuje jednak potrzebnego adresu obrazu; „null” oznacza tutaj, że nie ma żadnej wartości. Dana funkcja modelu kończy się niepowodzeniem, a serwer działa dalej.
Jak to naprawić:
- Sprawdź w Konsola lub
logs/latest.log, czy po ponownym dołączeniu pojawia się ten sam komunikat. - Poproś gracza z danym klientem, aby sprawdził swojego skina i dołączył ponownie. W razie potrzeby sprawdź też używane rozszerzenie do skinów.
- Porównaj ModelEngine i powiązane rozszerzenia z wersją serwera. Zatrzymaj serwer, zanim wymienisz pliki pluginów w sekcji Pluginy, a potem uruchom go ponownie.
- Jeśli błąd nie znika, przekaż autorowi ModelEngine pełny ślad błędu, czyli łańcuch wywołań pod komunikatem błędu. Usuń dane osobowe.
Mod ustawia nieprawidłowy stan bloku
Tak wygląda komunikat:
Cannot set property <Właściwość> to <Wartość> on Block{<Blok>}, it is not an allowed value
Co się za tym kryje: Podczas interakcji z blokiem mod ustawia wartość właściwości spoza dozwolonego zakresu. Minecraft odrzuca przetwarzanie danego pakietu, a akcja na bloku się nie udaje. Ślad błędu opisuje łańcuch wywołań w programie; pierwsza wymieniona klasa moda jest dobrym punktem wyjścia do sprawdzenia.
Jak to naprawić:
- Otwórz w sekcji Pliki logs/latest.log i ustal na podstawie śladu błędu, którego moda i której właściwości bloku to dotyczy.
- Sprawdź w sekcji Mody, czy jest poprawka moda zgodna z Twoją wersją Minecraft, a wcześniej zabezpiecz świat w sekcji Kopie zapasowe.
- Po aktualizacji uruchom serwer w pełni ponownie i przetestuj tę samą akcję na bloku; do czasu naprawy unikaj jej.
Minecraft pomija zbyt wiele połączonych aktualizacji bloków
Tak wygląda komunikat:
Too many chained neighbor updates. Skipping the rest. First skipped position: <Pozycja>
Co się za tym kryje: Łańcuch aktualizacji bloków osiąga limit ochronny Minecraft. Kolejne aktualizacje w tym łańcuchu są pomijane, przez co na przykład układy redstone chwilowo nie reagują zgodnie z oczekiwaniami. Serwer działa dalej, ale niektóre reakcje bloków w danym łańcuchu nie następują. Samo podniesienie limitu ochronnego nie usuwa łańcucha, który wywołuje problem.
Jak to naprawić:
- Przypisz pozycję podaną w Konsola do danego układu lub maszyny z moda i zatrzymaj to, co ją uruchamia.
- Zabezpiecz świat w sekcji Kopie zapasowe i zmniejsz łańcuch wyzwalany jednocześnie, na przykład dzieląc układ na części.
- Przetestuj zmianę po pełnym restarcie, a w przypadku bloków z modów sprawdź w sekcji Mody, czy jest odpowiednia poprawka błędu.
UnstableFarlandsExpansion nie znajduje odpowiedniego lasu do naprawy
Tak wygląda komunikat:
[UnstableFarlandsExpansion] Forest repair stopped; backup retained if editing began
No verified old-generator forest found; nothing changed
Co się za tym kryje: Naprawa lasu w UnstableFarlandsExpansion nie znajduje potwierdzonego lasu ze starego generatora i zostaje przerwana. Przy tym przerwaniu świat pozostaje niezmieniony; żądana naprawa nie zostaje wykonana. Serwer działa dalej. Plugin celowo kończy tu naprawę, ponieważ jego weryfikacja nie rozpoznaje odpowiedniego stanu wyjściowego.
Jak to naprawić:
- Sprawdź w Konsoli pełny komunikat i to, czy jako przyczyna rzeczywiście pojawia się No verified old-generator forest found.
- Przeczytaj instrukcję zainstalowanej wersji pluginu i sprawdź, czy wybrany obszar pochodzi z obsługiwanego starego generatora.
- Przed kolejną próbą naprawy utwórz kopię zapasową w sekcji Kopie zapasowe i wybierz tylko obszar odpowiedni według instrukcji.
Mod dodaje istotę z wątku w tle
Tak wygląda komunikat:
A mod is trying to add an entity from offthread, this should be avoided. Printing trace:
Co się za tym kryje: Mod dodaje istotę do świata poza przewidzianym do tego wątkiem gry. Taki równoczesny dostęp jest niebezpieczny i może zakłócić przetwarzanie istot; następujący po komunikacie ślad błędu wskazuje zaangażowane mody. Wątek to ścieżka wykonywania programu. Wyjątek diagnostyczny pokazuje ścieżkę wywołań; służy tu do odnalezienia niebezpiecznego dostępu.
Jak to naprawić:
- W sekcji Pliki przeczytaj ślad błędu w logs/latest.log i poszukaj moda, który wykonuje wywołanie dodające istotę.
- Utwórz kopię zapasową w sekcji Kopie zapasowe i sprawdź w sekcji Mody, czy jest dostępna odpowiednia poprawka dla tego moda i jego zależności.
- Po aktualizacji uruchom serwer całkowicie od nowa i ponownie przetestuj wyzwalacz; jeśli problem się powtarza, wyślij pełny ślad błędu twórcom moda.
Paper nie może zalogować gracza z powodu nieprawidłowego rozmiaru listy
Tak wygląda komunikat:
Couldn't place player in world
IllegalArgumentException: arraySize cannot be negative but was: <wartość ujemna>
Co się za tym kryje: Podczas umieszczania gracza w świecie żądana jest lista o ujemnym rozmiarze. Logowanie tego gracza kończy się niepowodzeniem z powodu błędu wewnętrznego; serwer nadal przetwarza inne zadania. Komunikat dotyczy obliczania rozmiaru wewnętrznej listy. Plan z większą ilością pamięci RAM nie skoryguje tej ujemnej wartości.
Jak to naprawić:
- W sekcji Pliki sprawdź w logs/latest.log pełny ślad błędu oraz komunikaty o dołączaniu bezpośrednio go poprzedzające.
- Utwórz kopię zapasową w sekcji Kopie zapasowe i sprawdź w sekcji Wersja, czy jest dostępny nowszy pasujący build Paper oraz kompatybilne wersje zaangażowanych pluginów.
- Po aktualizacji uruchom serwer całkowicie od nowa i przetestuj dołączanie; jeśli błąd nadal występuje, zgłoś go wraz z pełnym logiem.
LibreLogin wykonuje blokującą operację w wątku gry
Tak wygląda komunikat:
[LibreLogin] AN IO OPERATION IS BEING PERFORMED ON THE MAIN THREAD! THIS IS A SERIOUS BUG!
Co się za tym kryje: LibreLogin wykrywa operację wejścia/wyjścia w głównym wątku serwera. Podczas oczekiwania na tę operację przetwarzanie gry może się zacinać; następujący ślad błędu pokazuje wywołanie pluginu, które ją wywołało. Operacje wejścia/wyjścia odczytują lub zapisują na przykład pliki albo dane w bazie danych. W wątku gry ich czas oczekiwania konkuruje z bieżącymi zadaniami gry.
Jak to naprawić:
- W sekcji Pliki przeczytaj w logs/latest.log pełny ślad błędu bezpośrednio pod ostrzeżeniem LibreLogin i zanotuj jego przyczynę.
- Utwórz kopię zapasową w sekcji Kopie zapasowe i sprawdź w sekcji Pluginy, czy jest dostępna poprawka LibreLogin i zaangażowanych rozszerzeń pasująca do wersji serwera.
- Po aktualizacji uruchom serwer całkowicie od nowa, a powtarzające się ostrzeżenie zgłoś wraz ze śladem błędu twórcom pluginu.
Paper blokuje wyrzucenie gracza z wątku w tle
Tak wygląda komunikat:
Thread <wątek pluginu> failed main thread check: player kick
java.lang.IllegalStateException: Asynchronous player kick!
Co się za tym kryje: Wątek to ścieżka wykonywania programu. Działania dotyczące graczy muszą tu odbywać się w głównym wątku gry. Plugin wywołuje wyrzucenie zamiast tego z zadania w tle, a Paper blokuje ten dostęp. To pojedyncze wyrzucenie się nie udaje; serwer działa dalej.
Jak to naprawić:
- Otwórz pełny ślad błędu w Konsoli lub w sekcji Pliki w
logs/latest.log. Kolejne wiersze wywołań, czyli stacktrace, wskazują zaangażowany plugin. - Sprawdź w sekcji Pluginy, czy jest dostępna aktualizacja pasująca do Twojej Wersji. Zatrzymaj serwer na czas wymiany plików, a następnie uruchom go ponownie.
- Ponownie sprawdź działanie, które miało spowodować wyrzucenie. Jeśli błąd nie znika, wyślij autorowi pluginu pełny ślad błędu i opisz to działanie.
AntiRelog nie może odczytać pakietu dla czasów odnowienia
Tak wygląda komunikat:
[AntiRelog] Unhandled exception occurred in onPacketSending(PacketEvent) for AntiRelog
com.comphenix.protocol.reflect.FieldAccessException: Field index 0 is out of bounds for length 0
Co się za tym kryje: AntiRelog obsługuje za pomocą ProtocolLib czasy odnowienia przedmiotów. W tym celu odczytuje pole z pakietu sieciowego, czyli wiadomości przesyłanej do gry. Oczekiwane pole nie występuje w tej postaci, więc obsługa tego czasu odnowienia zostaje przerwana. Serwer działa dalej.
Jak to naprawić:
- Otwórz pełny komunikat w Konsoli lub w sekcji Pliki w
logs/latest.log. Zanotuj wersje serwera, AntiRelog i ProtocolLib. - Sprawdź na stronach pluginów, które wydania działają ze sobą i z Twoją wersją serwera. Zaktualizuj odpowiednio AntiRelog i ProtocolLib w sekcji Pluginy.
- Zatrzymaj serwer przed wymianą plików, a następnie uruchom go całkowicie od nowa.
- Jeśli błąd wystąpi ponownie, wyślij autorowi AntiRelog pełny komunikat wraz z wersjami i działaniem w grze, które go wywołało.
Gracz nie może dołączyć z powodu brakującej wartości
Tak wygląda komunikat:
Couldn't place player in world
java.lang.NullPointerException
Co się za tym kryje: Serwer nie może umieścić gracza w świecie podczas dołączania. Jakaś część programu odwołuje się przy tym do brakującej wartości, którą Java nazywa „null”. Logowanie tego gracza zostaje przerwane, ale serwer działa dalej. Kolejne linie błędu pomagają ustalić, która część programu jest za to odpowiedzialna.
Jak to naprawić:
- Poproś gracza, aby spróbował dołączyć ponownie, i sprawdź, czy błąd się powtarza.
- Otwórz pełny komunikat w Konsola albo w Pliki w
logs/latest.log. Przeczytaj też linie znajdujące się przed nim. Następujące po nim linie zaczynające się od „at” tworzą stacktrace, czyli łańcuch wywołań prowadzący do błędu. - Jeśli w tym łańcuchu wywołań pojawia się jakiś plugin, sprawdź w Pluginy oraz na stronie pluginu, czy obsługuje on Twoją wersję serwera. Zatrzymaj serwer przed podmianą plików, a następnie uruchom go ponownie.
- Jeśli dołączanie nadal nie działa lub nie da się ustalić, którego komponentu dotyczy problem, otwórz zgłoszenie i podaj godzinę wystąpienia komunikatu.
NameTag nie może wyłączyć swojego wyświetlania nazw
Tak wygląda komunikat:
[NameTag] Failed to disable Name Tag implementation: Plugin attempted to register task while disabled
Co się za tym kryje: Podczas wyłączania swojego wyświetlania nazw NameTag próbuje jeszcze zarejestrować zadanie na serwerze. W tym momencie plugin jest już jednak dezaktywowany. Dlatego serwer odrzuca to zadanie, a NameTag kończy procedurę wyłączania błędem. Problem dotyczy porządkowania funkcji pluginu.
Jak to naprawić:
- Sprawdź w Konsola albo w Pliki w
logs/latest.log, czy komunikat pojawia się przy zwykłym zatrzymywaniu serwera, czy po ponownym załadowaniu pluginu. - Uruchom serwer w pełni od nowa. Nie używaj narzędzia do przeładowywania pluginów dla NameTag i sprawdź w Pluginy, czy dostępne jest wydanie pasujące do Wersja serwera.
- Jeśli błąd powtarza się przy zwykłym zatrzymywaniu, zgłoś autorowi NameTag pełny, oczyszczony ślad błędu oraz używane wersje. Zabezpiecz ustawienia przed podmianą plików.
„This block cannot be stored”: polecenie WorldEdit przerwane w trybie ekwipunku
Tak wygląda komunikat:
An unexpected error while handling a WorldEdit command
java.lang.IllegalArgumentException: This block cannot be stored
Co się za tym kryje: WorldEdit można skonfigurować tak, by gracze budowali z bloków ze swojego ekwipunku i otrzymywali z powrotem usunięte bloki. W tym trybie ekwipunku polecenie natrafia na blok, który nie ma postaci przedmiotu i dlatego nie mieści się w ekwipunku. Polecenie zostaje przerwane, a część zmian może być już wykonana. Serwer działa dalej.
Jak to naprawić:
- W zakładce Pliki otwórz plik
plugins/WorldEdit/config.yml. - Znajdź sekcję
use-inventory. Jeśli chcesz budować bez powiązania z ekwipunkiem, ustaw tamenablenafalse. - Uruchom serwer ponownie.
- Jeśli chcesz zachować ten tryb, wybieraj obszary bez takich bloków i aktualizuj WorldEdit w zakładce Pluginy.
Warto wiedzieć: Za pomocą //undo zwykle możesz cofnąć częściowo wykonane polecenie.
„Cannot get property … as it does not exist in Block”: mod odczytuje brakującą właściwość bloku
Tak wygląda komunikat:
java.lang.IllegalArgumentException: Cannot get property EnumProperty{name=direction, …} as it does not exist in Block{minecraft:air}
Co się za tym kryje: Bloki mają właściwości, takie jak ich orientacja. Mod odpytuje taką właściwość, ale w tym miejscu znajduje się inny blok, często powietrze, na przykład dlatego, że właściwy blok został właśnie wykopany. Akcja moda zostaje przerwana z błędem.
Jak to naprawić:
- Otwórz pełny komunikat w
logs/latest.log. Linie „at” to tzw. stacktrace, czyli łańcuch wywołań prowadzący do błędu; wskazują one moda, którego to dotyczy. - Zaktualizuj tego moda w zakładce Mody do wersji pasującej do twojej wersji serwera. Zatrzymaj serwer przed podmianą, a potem uruchom go ponownie.
- Jeśli błąd nie znika, zgłoś autorowi moda pełny komunikat oraz to, co w tym momencie działo się z blokiem.
„onTrackingStart called during navigation iteration”: mod dodaje istotę w niewłaściwym momencie
Tak wygląda komunikat:
onTrackingStart called during navigation iteration
java.lang.IllegalStateException: onTrackingStart called during navigation iteration
at net.minecraft.server.world.ServerWorld$ServerEntityHandler.startTracking(<Plik>)
Co się za tym kryje: Po zmianie bloku Minecraft aktualizuje ścieżki ruchu wszystkich mobów. Właśnie w tym momencie mod umieścił w świecie nową istotę. Minecraft zgłasza błąd, ale mimo to dodaje istotę i działa dalej. Komunikat wskazuje na moda, który tworzy istoty w niewłaściwym momencie.
Jak to naprawić:
- Otwórz pełny komunikat w Konsola lub w
logs/latest.log. Linie „at” to tzw. stacktrace, czyli łańcuch wywołań prowadzący do błędu. - Czytaj stacktrace w dół, aż w nazwie pakietu pojawi się mod. Pierwsze linie zwykle wskazują sam Minecraft.
- Zaktualizuj tego moda w zakładce Mody do wersji pasującej do wersji serwera. Zatrzymaj serwer przed podmianą, a potem uruchom go ponownie.
- Jeśli komunikat nadal się pojawia, zgłoś autorowi moda pełny stacktrace oraz to, co akurat działo się w grze.
Dobrze wiedzieć: Jeśli komunikat pojawia się tylko sporadycznie, możesz normalnie dalej korzystać z serwera.
BlueMap: ładowanie przerwane z powodu przerwania lub dezaktywacji
Tak wygląda komunikat:
[BlueMap] Failed to load!
org.bukkit.plugin.IllegalPluginAccessException: Plugin attempted to register task while disabled
Co się za tym kryje: BlueMap nie mógł dokończyć procesu ładowania. Albo dostęp do pliku został przerwany (ClosedByInterruptException), albo BlueMap próbował jeszcze utworzyć zadanie w tle po swojej dezaktywacji. Może się to zdarzyć podczas zatrzymywania lub przeładowywania serwera. Po nieudanym ładowaniu BlueMap nie jest gotowy do działania.
Jak to naprawić:
- Przeczytaj w Konsola linie poprzedzające komunikat. Sprawdź, czy właśnie zatrzymałeś serwer lub przeładowałeś pluginy.
- Uruchom serwer całkowicie od nowa i sprawdź, czy tym razem BlueMap ładuje się poprawnie.
- Jeśli błąd powtarza się przy normalnym starcie, sprawdź obsługiwane wersje serwera na stronie projektu BlueMap. Przed wymianą zrób kopię konfiguracji pluginu w Pliki.
- Jeśli błąd nie znika mimo pasującej wersji, zgłoś autorowi BlueMap oczyszczony, pełny komunikat błędu oraz przebieg startu serwera.
RegisterAndLoginPlugin: nie można obliczyć hasha hasła
Tak wygląda komunikat:
[RegisterAndLoginPlugin] Hash encrypt failed
Co się za tym kryje: Plugin logowania nie może obliczyć hasha hasła. Hash to wartość kontrolna, za pomocą której plugin weryfikuje wpisane hasło. Przez to dana rejestracja, logowanie lub zmiana hasła nie może zostać poprawnie przetworzona. Serwer Minecraft działa dalej.
Jak to naprawić:
- Otwórz Konsola lub
logs/latest.logi przeczytaj pełny komunikat błędu wraz z poprzedzającymi go liniami. Zanotuj, przy której z trzech czynności występuje. - Przed wprowadzeniem zmian zrób kopię istniejących danych kont i konfiguracji pluginu w Pliki. Nie usuwaj danych kont w celu naprawy błędu.
- Sprawdź u autora pluginu, które wydanie pasuje do Twojej wersji serwera. Przed wymianą plików zatrzymaj serwer, a potem uruchom go całkowicie od nowa.
- Jeśli błąd nie znika, zgłoś autorowi oczyszczony komunikat błędu i używane wersje. Nie udostępniaj przy tym haseł ani plików kont.
LuckPerms blokuje zablokowujące zapytanie o uprawnienia przez Vault
Tak wygląda komunikat:
me.lucko.luckperms.bukkit.vault.ServerThreadLookupException: A Vault API request has been made on the main server thread that LuckPerms cannot safely respond to.
Co się za tym kryje: Plugin odpytuje przez wspólny interfejs Vault dane gracza, które LuckPerms musiałby najpierw wczytać. Robi to w głównym wątku, który obsługuje także rozgrywkę. LuckPerms odmawia wykonania zapytania, aby doładowanie danych nie zablokowało działania gry. Dana akcja pluginu kończy się niepowodzeniem, serwer działa dalej.
Jak to naprawić:
- Otwórz pełny komunikat w Konsoli lub w
logs/latest.log. Kolejne linie zaczynające się od „at” to śledzenie stosu, czyli łańcuch wywołań prowadzący do błędu; znajdź w nim plugin wysyłający zapytanie. - Sprawdź w Pluginach, czy dostępna jest odpowiednia aktualizacja tego pluginu oraz jego zgodność z LuckPerms i Vault. Przed wymianą zatrzymaj serwer, a potem uruchom go ponownie.
- Jeśli błąd nie ustąpi, wyślij autorowi pluginu oczyszczony komunikat oraz informację, jaka akcja go wywołała. Zapytanie o dane musi odbywać się poza głównym wątkiem.
Dobrze wiedzieć: Nie wyłączaj ochrony przed niebezpiecznymi zapytaniami Vault; jej wyłączenie może powodować zauważalne zacinanie się gry.
PhoenixCrates: przydzielanie skrzynki nie powiodło się z powodu niedostępnych danych gracza
Tak wygląda komunikat:
[PhoenixCratesLite] An error occurred while processing an action
java.lang.IllegalStateException: Player Data is not available
Co się za tym kryje: PhoenixCrates chce podczas przydzielania skrzynki uzyskać dostęp do swoich zapisanych danych gracza. Te dane nie są w tym momencie dostępne dla pluginu. Przydzielanie zostaje przerwane, serwer działa dalej.
Jak to naprawić:
- Sprawdź, czy docelowy gracz w pełni dołączył do serwera. Przeczytaj w Konsoli lub w
logs/latest.logtakże wcześniejsze komunikaty PhoenixCrates dotyczące wczytywania danych. - Najpierw usuń zgłoszone tam błędy wczytywania lub zapisu. Następnie sprawdź stan skrzynek, zanim ponownie wykonasz przydzielanie.
- Jeśli błąd nie ustąpi, sprawdź w Pluginach, czy dostępna jest aktualizacja odpowiadająca wersji serwera. Zabezpiecz serwer w Kopiach zapasowych i zatrzymaj go przed wymianą.
- Zgłoś autorowi pluginu oczyszczony ślad błędu oraz informację, czy docelowy gracz był już online. Linie zaczynające się od „at” to śledzenie stosu, czyli łańcuch wywołań prowadzący do błędu.
GrimAC nie może skonfigurować wyjątków dla graczy
Tak wygląda komunikat:
[GrimAC] Failed to start ExemptOnlinePlayersOnReload: java.lang.NullPointerException
Co się za tym kryje: Podczas startu pluginu GrimAC konfiguruje wyjątki dla graczy, którzy są już połączeni. Brakuje potrzebnego do tego obiektu gracza; Java nazywa taką brakującą wartość „null”. Ta część inicjalizacji kończy się niepowodzeniem. Serwer Minecraft działa dalej, ale wyjątki nie zostają w pełni skonfigurowane.
Jak to naprawić:
- Całkowicie zatrzymaj serwer i uruchom go ponownie. Nie przeładowuj GrimAC ani wszystkich pluginów w trakcie działania serwera.
- Następnie sprawdź w Konsola, czy pojawiają się kolejne błędy GrimAC i PacketEvents, czyli biblioteki do obsługi pakietów sieciowych.
- Porównaj zainstalowane wydania z informacjami o kompatybilności od GrimAC. Zanim podmienisz pliki pluginu przy zatrzymanym serwerze, zrób ich kopię w Pliki.
- Jeśli błąd nie znika po pełnym restarcie, zgłoś autorowi GrimAC oczyszczony ślad błędu i opisz, kiedy występuje.
AxTrade otrzymuje nieprawidłową odpowiedź przy kontroli bezpieczeństwa
Tak wygląda komunikat:
com.google.gson.JsonSyntaxException: Expected a com.google.gson.JsonArray but was com.google.gson.JsonPrimitive; at path $
at com.artillexstudios.axtrade.safety.SafetyManager.check(<Plik>:<Linia>)
Co się za tym kryje: AxTrade wysyła zapytanie do zewnętrznej usługi bezpieczeństwa. Odpowiedź powinna być listą JSON, czyli kilkoma wartościami w nawiasach kwadratowych, ale zawiera tylko pojedynczą wartość. Przez to przetworzenie tego zapytania kończy się niepowodzeniem. Serwer Minecraft działa dalej.
Jak to naprawić:
- Przeczytaj pełny komunikat w Konsola lub w
logs/latest.log. Kluczowa jest tu linia zSafetyManager.check. - Sprawdź, czy aktualne wydanie AxTrade pasuje do wersji Twojego serwera w Wersja. Przed podmianą zrób kopię plików i ustawień pluginu w Pliki.
- Zatrzymaj serwer, zainstaluj pasujące wydanie i uruchom serwer całkowicie od nowa.
- Jeśli komunikat pojawi się ponownie, zgłoś autorowi AxTrade oczyszczony ślad błędu i czas jego wystąpienia. Nie wyłączaj kontroli bezpieczeństwa tylko po to, żeby pozbyć się komunikatu.
Sable: akcja na bloku kończy się niepowodzeniem z powodu brakującego plot holdera
Tak wygląda komunikat:
Failed to handle packet net.minecraft.network.protocol.game.ServerboundUseItemOnPacket@<Identyfikator>, suppressing error
java.lang.UnsupportedOperationException: Cannot change blocks in nonexistent plot holder
Co się za tym kryje: Sable zarządza ruchomymi obszarami bloków za pomocą tak zwanych plot holderów. Przy tej aktualizacji bloku brakuje odpowiedzialnego za nią zarządcy. Minecraft przechwytuje błąd podczas przetwarzania akcji przedmiotu i porzuca dalsze przetwarzanie tej akcji. Serwer działa dalej.
Jak to naprawić:
- Zanotuj akcję na bloku, która wywołuje błąd, i przeczytaj pełny ślad błędu w Konsola lub w
logs/latest.log. - Zatrzymaj daną maszynę lub akcję, jeśli wielokrotnie wywołuje ten komunikat.
- Utwórz kopię zapasową w Kopie zapasowe. Zatrzymaj serwer i sprawdź w Mody, czy wersje Sable i zaangażowanych modów do siebie pasują.
- Po zmianach uruchom serwer całkowicie od nowa. Jeśli błąd nadal występuje, zgłoś projektowi Sable oczyszczony ślad błędu wraz z informacjami o wersjach i krokami prowadzącymi do jego wywołania.
Nie ma tu Twojego komunikatu?
Przeczytaj cały komunikat, łącznie z liniami przed nim. Często jest tam napisane, co plugin właśnie próbował zrobić. W stacktrace nazwy plików w liniach „at”, np. <Plugin>.jar, oraz nazwy pakietów zdradzają plugin lub mod. Linie z java.base, net.minecraft, org.bukkit lub io.papermc należą do Javy i serwera. Utwórz kopię zapasową, zaktualizuj sprawcę i uruchom serwer ponownie. Jeśli nie wiesz, co dalej, otwórz zgłoszenie i podaj godzinę wystąpienia komunikatu.