Plugin Minecraft to plik JAR (archiwum Javy) w folderze plugins/. Zawsze jest zbudowany dla określonych wersji Minecraft, określonej wersji Javy i zwykle także dla konkretnego oprogramowania serwera, takiego jak Paper czy Spigot. Jeśli któryś z tych elementów się nie zgadza, plugin w ogóle się nie ładuje, sam się wyłącza albo przestają działać niektóre jego funkcje. Każda sekcja poniżej dotyczy konkretnego komunikatu: jak wygląda, co się za nim kryje i jak go naprawić.
Pełny komunikat znajdziesz w Konsola albo w Pliki w logs/latest.log. Przeczytaj też linie przed nim, bo często podana jest tam nazwa problematycznego pluginu. U nas wersja Javy jest ustawiana automatycznie zgodnie z wersją Minecraft. Jakie wersje obsługuje dany plugin, znajdziesz na jego stronie pobierania. Zanim zmienisz wersję albo edytujesz pliki konfiguracji lub świata, utwórz kopię zapasową w Kopie zapasowe.
UnsupportedClassVersionError: plugin lub serwer wymaga nowszej wersji Javy
Tak wygląda komunikat:
[ModernPluginLoadingStrategy] Could not load plugin '<Plugin>.jar' in folder 'plugins'
java.lang.UnsupportedClassVersionError: <Klasa> has been compiled by a more recent version of the Java Runtime …
org.bukkit.plugin.InvalidPluginException: java.lang.UnsupportedClassVersionError: <Klasa> …
Co się za tym kryje: Plik wymaga nowszej wersji Javy niż ta, której używa Twój serwer. W pełnym komunikacie podana jest wymagana wersja pliku klasy oraz najwyższa obsługiwana: 69.0 odpowiada Javie 25, a 65.0 Javie 21. Jeśli komunikat dotyczy pluginu, nie uruchomi się tylko on; jeśli dotyczy pliku JAR serwera, nie uruchomi się cały serwer.
Jak to naprawić:
- Przeczytaj pełny komunikat w sekcji Pliki w
logs/latest.logalbo w zakładce Konsola. Sprawdź na stronie projektu, jakiej wersji Javy wymaga wskazany plik. - W przypadku pluginu pobierz wydanie dla swojej wersji Minecrafta, które działa też z używaną wersją Javy. Zatrzymaj serwer, zastąp stary plik w
plugins/i uruchom serwer ponownie. - W przypadku pliku JAR serwera sprawdź, czy plik pasuje do wybranej wersji w zakładce Wersja. Odpowiednią wersję Javy ustawiamy automatycznie dla każdej wersji Minecrafta.
- Jeśli musisz zmienić wersję, najpierw zabezpiecz serwer w zakładce Kopie zapasowe. Jeśli przypisanie jest już prawidłowe, a błąd nie znika, otwórz zgłoszenie i podaj godzinę wystąpienia komunikatu.
Więcej szczegółów: Jakiej wersji Javy potrzebuje Twój serwer Minecraft?
„Unsupported API version …”: plugin wymaga nowszej wersji Minecrafta
Tak wygląda komunikat:
[ModernPluginLoadingStrategy] Could not load plugin '<Plugin>.jar' in folder 'plugins'
[ModernPluginLoadingStrategy] Could not load plugin '<Plugin>.jar' in folder 'plugins/.paper-remapped'
org.bukkit.plugin.InvalidPluginException: Unsupported API version <Wersja>
Co się za tym kryje: Każdy plugin zawiera mały plik z opisem, czyli plugin.yml. Wpis api-version podaje w nim wymaganą wersję API, czyli wersję interfejsu programistycznego serwera. Jeśli ta wersja jest nowsza niż Twój serwer, Paper w ogóle nie załaduje pluginu, np. przy Unsupported API version 26.1 na serwerze z wersją 1.21.11. Serwer się uruchamia, ale wszystko, co miał zapewniać plugin, całkowicie znika: komendy, zasady ochrony, menu.
Jak to naprawić:
- Porównaj liczbę po
Unsupported API versionz wersją Minecrafta Twojego serwera w zakładce Wersja. - Na Modrinth lub SpigotMC przefiltruj pliki do pobrania pluginu według swojej wersji Minecrafta i pobierz pasujące wydanie.
- Zatrzymaj serwer, zastąp stary plik w sekcji Pliki w folderze
plugins/i uruchom serwer ponownie. - Jeśli nie ma pasującego wydania, przestaw serwer w zakładce Wersja na wersję wymaganą przez plugin. Wcześniej utwórz kopię zapasową, ponieważ świat zostanie przy tym przekonwertowany na nową wersję.
Warto wiedzieć: Nie zmieniaj samodzielnie api-version w pliku pluginu. Obejście tej kontroli nie doda brakujących funkcji serwera; użyj pasującego wydania pluginu.
Więcej na ten temat: Bezpieczna zmiana wersji Minecrafta i modloadera
„Fatal error trying to convert”: Paper nie może załadować pluginu dla nowszej Javy
Tak wygląda komunikat:
Fatal error trying to convert <Plugin> v<Wersja>:<Ścieżka>/<Klasa>.class
java.lang.IllegalArgumentException: Unsupported class file major version 65
java.lang.IllegalArgumentException: Unsupported class file major version 69
Co się za tym kryje: Paper podczas ładowania przekształca pluginy za pomocą wbudowanego konwertera. Liczba pokazuje, dla jakiej wersji Javy plugin został skompilowany: 65 oznacza Javę 21, a 69 Javę 25. Paper 1.19.4 lub starszy nie odczyta klas dla Javy 21 lub nowszej. Również nowsze wersje Papera, takie jak 1.21.1 czy 1.21.4, nie radzą sobie z klasami dla Javy 25. Plugin nie zostaje załadowany. Często dotyczy to Geysera: wtedy gracze Bedrock nie mogą dołączyć. Sam serwer się uruchamia, a gracze Java nadal mogą wejść.
Jak to naprawić:
- Odczytaj nazwę danego pluginu po
trying to convert. - Jeśli chcesz zostać przy swojej wersji Minecrafta, pobierz starsze wydanie pluginu dokładnie dla tej wersji i zastąp nim plik w sekcji Pliki w folderze
plugins/. - Możesz też przestawić serwer w zakładce Wersja na nowszą wersję Minecrafta. Przy 65 wystarczy 1.20.5 lub nowsza, ponieważ nowsze buildy Papera odczytują klasy dla Javy 21. Przy 69 obsługiwane wersje znajdziesz na stronie pluginu. Wcześniej utwórz kopię zapasową w zakładce Kopie zapasowe.
- Uruchom serwer ponownie i sprawdź w zakładce Konsola, czy plugin ładuje się bez błędów.
Warto wiedzieć: Komunikat często pojawia się kilka razy z rzędu, raz dla każdej klasy. Mimo to dotyczy tylko tego jednego pluginu.
Więcej szczegółów: Jakiej wersji Javy potrzebuje Twój serwer Minecraft?
„Unsupported server version”: plugin nie obsługuje wersji serwera
Tak wygląda komunikat:
[Essentials] You are running an unsupported server version!
[<Plugin>] This plugin does not support Paper servers! …
Boot failure initializing QuickShop-Hikari v<Wersja>: … UnsupportedOperationException: Unsupported platform
Co się za tym kryje: Plugin nie obsługuje twojej wersji Minecrafta albo oprogramowania serwera. Wyświetla ostrzeżenie albo całkowicie lub częściowo się wyłącza, a sam serwer działa dalej. Z tego powodu może się też pojawić „Boot failure”: jeśli poniżej widnieje „Unsupported platform”, oprogramowanie serwera nie pasuje do wydania pluginu. Niektóre pluginy oferują do tego osobne pliki do pobrania.
Jak to naprawić:
- Przeczytaj w Konsola pełny komunikat błędu. Linie „Caused by” wskazują faktyczną przyczynę błędu „Boot failure”.
- Sprawdź na stronie pluginu, które wersje Minecrafta i jakie oprogramowanie serwera są obsługiwane.
- Pobierz odpowiednie wydanie, zatrzymaj serwer i podmień stary plik w Pliki w folderze
plugins/. Następnie uruchom serwer ponownie. - Jeśli nie ma pasującego wydania, utwórz kopię zapasową w Kopie zapasowe. Wybierz obsługiwaną wersję Minecrafta w Wersja albo oprogramowanie serwera przez Zmień oprogramowanie / loader. Do starszej wersji Minecrafta potrzebujesz pasującego do niej świata, w razie potrzeby z kopii zapasowej sprzed aktualizacji.
Dobrze wiedzieć: Nawet aktywny plugin mógł wyłączyć pojedyncze funkcje. Przetestuj polecenia, których potrzebujesz.
„Failed to remap plugin jar …”: Paper nie może przepisać pluginu
Tak wygląda komunikat:
[PluginRemapper] Encountered exception remapping plugins
java.util.concurrent.CompletionException: java.lang.RuntimeException: Failed to remap plugin jar 'plugins/<Plugin>.jar'
java.util.concurrent.CompletionException: java.lang.RuntimeException: Failed to open plugin jar plugins/<Plugin>.jar
Co się za tym kryje: Nowsze wersje Papera przy starcie przepisują starsze pluginy na wewnętrzną strukturę bieżącej wersji Minecrafta; nazywa się to remappingiem. Kopie robocze znajdują się w plugins/.paper-remapped. Przy Failed to open plugin jar nie da się otworzyć już oryginalnego pliku JAR, w przeciwnym razie nie udaje się samo przepisanie. Serwer uruchamia się dalej, ale plugin może w ogóle nie działać albo działać tylko częściowo, często bez dalszego komunikatu o błędzie.
Jak to naprawić:
- Odczytaj nazwę pliku po
Failed to remap plugin jarlubFailed to open plugin jar. - Sprawdź w sekcji Pliki, czy w
plugins/znajduje się kilka plików JAR tego samego pluginu. Usuń potwierdzone nadmiarowe kopie przy zatrzymanym serwerze. - Pobierz ponownie kompletne, pasujące wydanie pluginu z oficjalnej strony projektu. Zatrzymaj serwer i zastąp nim stary plik w sekcji Pliki w
plugins/, a nie kopię roboczą wplugins/.paper-remapped. - Uruchom serwer ponownie i sprawdź, czy komunikat zniknął.
Warto wiedzieć: Jeśli nie ma pasującego wydania, plugin nie jest jeszcze gotowy na Twoją wersję serwera. Usuń go lub poczekaj na aktualizację.
Zduplikowane pliki: Plik pluginu uszkodzony, zduplikowany lub w ogóle niebędący pluginem
„Unsupported key” / „Unable to lookup value for key”: nieznana nazwa bloku lub przedmiotu
Tak wygląda komunikat:
Unsupported key: minecraft:bed
[<Rozszerzenie>] [STDERR] Unable to lookup value for key <minecraft:chain> in registries <RegistryKeyImpl[key=minecraft:block]>!
Co się za tym kryje: Minecraft prowadzi każdy blok i każdy przedmiot pod stałą nazwą w formie minecraft:<Nazwa>, czyli tak zwanym kluczem rejestru. Plugin, mod lub ich konfiguracja używa nazwy, której Twoja wersja Minecrafta nie zna. Typowym przykładem jest minecraft:bed: od wersji 1.13 łóżka nazywają się według koloru, np. red_bed. Wpis zostaje pominięty, serwer działa dalej, ale danej funkcji może brakować.
Jak to naprawić:
- Odczytaj nazwę rozszerzenia na początku linii lub w poprzednich liniach w zakładce Konsola albo w
logs/latest.log. - Zabezpiecz konfigurację i wyszukaj podany klucz w sekcji Pliki. W przypadku pluginów konfiguracja zwykle znajduje się w
plugins/<Plugin>/; w przypadku modów jej lokalizację podaje ich instrukcja. - Zastąp nazwę oznaczeniem obowiązującym w Twojej wersji Minecrafta, które znajdziesz w Minecraft Wiki. W plikach YAML (
.yml), czyli w ustrukturyzowanym formacie konfiguracji, nie zmieniaj wcięć ani cudzysłowów. - Uruchom serwer ponownie. Jeśli nazwa jest zapisana na stałe w pluginie lub modzie, zaktualizuj rozszerzenie w zakładce Pluginy lub Mody do pasującej wersji. Przed wymianą plików zatrzymaj serwer.
Przy błędach w pliku: Plik konfiguracyjny pluginu zawiera błędy
„Type net.kyori.adventure… not present”: plugin wymaga nowszej wersji Adventure
Tak wygląda komunikat:
Caused by: java.lang.ExceptionInInitializerError: Exception java.lang.TypeNotPresentException: Type net.kyori.adventure.text.TranslationArgument not present
Co się za tym kryje: Adventure to biblioteka, za pomocą której Paper tworzy kolorowe teksty czatu, tytuły i teksty po najechaniu kursorem. Jest wbudowana na stałe w serwer, więc jej wersja zależy od twojej wersji Minecrafta. Plugin został zbudowany pod nowszą wersję Adventure, a na twoim serwerze brakuje wskazanej klasy. Dlatego części pluginu się nie uruchamiają. Serwer działa dalej.
Jak to naprawić:
- Ustal, którego pluginu to dotyczy. W stacktrace, czyli liście linii
at …pod komunikatem, często widnieje nazwa pliku JAR lub nazwa pakietu należącego do pluginu. W przeciwnym razie pomogą linie wcześniej. - Pobierz starsze wydanie pluginu zbudowane dla twojej wersji serwera i zastąp plik w Pliki w folderze
plugins/. - Albo przestaw serwer w Wersja na nowszą wersję Minecrafta. Wcześniej utwórz kopię zapasową.
Warto wiedzieć: Dodatkowy plik Adventure w folderze plugins/ nie pomoże, ponieważ Paper używa swojej wbudowanej wersji.
ProtocolLib nie pasuje do wersji serwera
Tak wygląda komunikat:
[ProtocolLib] INTERNAL ERROR: Cannot load ProtocolLib.
If this problem hasn't already been reported, please open a ticket
java.lang.IllegalArgumentException: Unable to find a field that matches …
Co się za tym kryje: ProtocolLib to biblioteka pomocnicza, przez którą inne pluginy odczytują i modyfikują pakiety sieciowe. W tym celu sięga głęboko do wewnętrznych mechanizmów serwera, a te zmieniają się niemal z każdą wersją Minecrafta. Jeśli ProtocolLib nie znajdzie oczekiwanych pól pakietów, nie załaduje się. Wszystkie pluginy, które potrzebują ProtocolLib, również wtedy nie działają.
Jak to naprawić:
- Pobierz najnowszy build ProtocolLib dla Twojej aktualnej wersji Minecrafta. Dla zupełnie nowych wersji pasujące buildy często pojawiają się najpierw jako wersja przedpremierowa na stronie projektu.
- Zastąp stary plik w sekcji Pliki w folderze
plugins/. Zostaw tylko jeden plik ProtocolLib. - Uruchom serwer całkowicie od nowa, czyli zatrzymaj go i uruchom ponownie, a nie przez
/reload. - Wpisz w sekcji Konsola
pluginsi sprawdź, czy ProtocolLib oraz zależne pluginy są zielone.
Dobrze wiedzieć: Prośba o otwarcie zgłoszenia w ProtocolLib pochodzi od samego pluginu. Zwykle brakuje tylko pasującego buildu.
Zależne pluginy: Plugin potrzebuje innego pluginu, którego brakuje
„is not compatible with Minecraft …”: Citizens się wyłącza
Tak wygląda komunikat:
[Citizens] v<Wersja> (build <Numer>) is not compatible with Minecraft <Wersja> - try upgrading or downgrading Citizens. Disabling.
Co się za tym kryje: Citizens to plugin do NPC, czyli postaci sterowanych przez komputer, takich jak handlarze czy zleceniodawcy zadań. Każdy build Citizens obsługuje tylko określone wersje Minecrafta i buildy serwera. Jeśli nie pasuje do Twojego serwera, Citizens wyłącza się przy starcie. Twoje NPC się wtedy nie pojawiają, a pluginy oparte na Citizens tracą tę funkcję. Sam serwer działa dalej.
Jak to naprawić:
- Sprawdź w sekcji Wersja, jaką wersję Minecrafta ma Twój serwer.
- Pobierz build Citizens dokładnie dla tej wersji. Wiele buildów Citizens ma w nazwie
SNAPSHOT, decydująca jest wersja Minecrafta podana obok na stronie pobierania. - Zatrzymaj serwer, zastąp stary plik w sekcji Pliki w folderze
plugins/i uruchom ponownie. - Jeśli nie ma pasującego buildu, dostosuj wersję serwera w sekcji Wersja. Wcześniej utwórz kopię zapasową.
Dobrze wiedzieć: try upgrading or downgrading oznacza, że Citizens może być za stary albo za nowy. Najnowszy plik nie jest więc automatycznie właściwy.
„is not compatible with your version of Minecraft”: wersja pluginu nie pasuje
Tak wygląda komunikat:
[Citizens] v<Wersja> (build <Numer>) is not compatible with your version of Minecraft. Disabling...
[Citizens] Could not fetch NMS field <Pole>: …
Your MC version isn't supported
Co się za tym kryje: Plugin został zbudowany dla innej wersji Minecrafta lub innego oprogramowania serwera. NMS oznacza wewnętrzne klasy serwera Minecraft; „Could not fetch NMS field” zgłasza problemy z dostępem do ich pól. W zależności od pluginu wyłącza się on całkowicie albo przestają działać poszczególne funkcje, np. kolorowe teksty czatu przy Unable to load Adventure, chat components will not work. Serwer działa dalej.
Jak to naprawić:
- Odczytaj nazwę pluginu w nawiasach kwadratowych na początku linii. Jeśli jej brak, znajdziesz ją w liniach powyżej.
- Sprawdź na stronie pluginu, jakie wersje Minecrafta i jakie oprogramowanie serwera obsługuje.
- Pobierz pasujące wydanie, zatrzymaj serwer i zastąp stary plik w sekcji Pliki w folderze
plugins/. - Jeśli nie ma pasującego wydania, przestaw serwer w sekcji Wersja na wersję, której wymaga plugin. Wcześniej utwórz kopię zapasową.
- Po ponownym uruchomieniu wpisz w sekcji Konsola
pluginsi sprawdź, czy plugin jest zielony. Następnie przetestuj daną funkcję.
Dobrze wiedzieć: Przejście na nowszą wersję Minecrafta konwertuje świat. Niezawodny powrót jest możliwy tylko z kopii zapasowej.
Plugin wymaga nowszego buildu Paper dla Twojej wersji Minecrafta
Tak wygląda komunikat:
[EntrypointUtil] Class io.papermc.paper.plugin.loader.library.impl.MavenLibraryResolver does not have member field 'java.lang.String MAVEN_CENTRAL_DEFAULT_MIRROR'
java.lang.NoSuchFieldError: …
Co się za tym kryje: Paper jest stale rozwijany także w obrębie jednej wersji Minecrafta, a każde wydanie nazywa się buildem. Plugin korzysta z pola API Paper, i to w części, która przy starcie pobiera dodatkowe biblioteki dla pluginów. To pole (MAVEN_CENTRAL_DEFAULT_MIRROR) istnieje dopiero w nowszych buildach. W Twoim buildzie go brakuje, dlatego plugin się nie ładuje. Sam serwer działa dalej.
Jak to naprawić:
- Otwórz w panelu sekcję Wersja i zaktualizuj do najnowszego buildu Paper dla Twojej wersji Minecrafta.
- Uruchom ponownie i sprawdź w sekcji Konsola, czy plugin ładuje się teraz bez błędów.
- Jeśli nie chcesz zmieniać buildu, użyj starszego wydania pluginu i zastąp plik w sekcji Pliki w folderze
plugins/.
Dobrze wiedzieć: Nowszy build tej samej wersji Minecrafta to niewielki krok. Świat pozostaje przy tym na tej samej wersji Minecrafta. Mimo to kopia zapasowa wcześniej nie zaszkodzi.
„Failed to init reflection”: dostęp pluginu do wnętrza serwera zawodzi
Tak wygląda komunikat:
Failed to init reflection: Index 3 out of bounds for length 3
java.lang.RuntimeException: Failed to obtain CraftItemStack.asCraftMirror
java.lang.RuntimeException: Couldn't initialize NMS adapter
Co się za tym kryje: Niektóre pluginy odczytują wewnętrzne klasy serwera bezpośrednio po ich nazwie; nazywa się to Reflection. Te wewnętrzne mechanizmy zmieniają się między wersjami Minecrafta, więc wersja pluginu zbudowana dla innej wersji serwera nie znajduje oczekiwanych metod ani pól. Również biblioteka taka jak ProtocolLib może zawieść przy dostępie; NMS oznacza wewnętrzne klasy serwera Minecraft. Zależne od tego funkcje przestają działać albo plugin się nie uruchamia, podczas gdy serwer działa dalej.
Jak to naprawić:
- Odczytaj nazwę pluginu na początku komunikatu lub w liniach powyżej. Sprawdź w sekcji Konsola lub w
logs/latest.logtakże linieat …, które pokazują łańcuch wywołań. - Sprawdź, jaką wersję serwera obsługuje plugin i wymienione zależności, takie jak ProtocolLib. Zaktualizuj je do wzajemnie zgodnych wersji dla Twojej wersji serwera.
- Zabezpiecz aktualny stan, zatrzymaj serwer i zastąp odpowiednie pliki w sekcji Pliki w folderze
plugins/. - Uruchom ponownie i przetestuj daną funkcję. Sprawdź, czy komunikat zniknął.
Dobrze wiedzieć: Jeśli nie ma pasującego wydania, użyj kompatybilnej alternatywy albo pozostaw dany plugin tymczasowo wyłączony.
Efekty świecenia pluginu są wyłączone (GlowingEntities)
Tak wygląda komunikat:
[GlowingEntities] [GlowingEntities] Glowing Entities reflection failed to initialize. The util is disabled. Please ensure your version (<Wersja>) is supported.
java.lang.NoSuchFieldException: MARKER
Co się za tym kryje: GlowingEntities nie jest osobnym pluginem, lecz komponentem, który inne pluginy dołączają, aby gracze, moby lub obiekty mogły świecić. Ten komponent nie znajduje wewnętrznego pola w buildzie Twojego serwera. Dlatego efekty świecenia danego pluginu są wyłączone. Serwer działa dalej i zwykle sam plugin również działa dalej, tylko bez tych efektów.
Jak to naprawić:
- Znajdź plugin, który zawiera GlowingEntities. W liniach
at …pod komunikatem znajdziesz wpis w postaci<Plugin>.jar//…. - Pobierz ten plugin w wydaniu przeznaczonym dla Twojego buildu Paper.
- Zastąp starą plik w sekcji Pliki w folderze
plugins/i uruchom serwer ponownie.
Warto wiedzieć: Samego GlowingEntities nie możesz zaktualizować osobno. Zajmuje się tym twórca pluginu, w którym znajduje się ten komponent. Jeśli nie potrzebujesz efektów świecenia, możesz ignorować ten komunikat do następnej aktualizacji.
„Failed to apply GUI head texture”: brak głów w menu Simple_RTP
Tak wygląda komunikat:
[Simple_RTP] Failed to apply GUI head texture: IllegalArgumentException: Can not set net.minecraft.world.item.component.ResolvableProfile field org.bukkit.craftbukkit.inventory.CraftMetaSkull.profile to com.mojang.authlib.GameProfile
Co się za tym kryje: Simple_RTP to plugin do losowych teleportacji. Dla głów w swoim menu ustawia profil gracza w starym formacie (GameProfile). Twoja wersja Minecrafta oczekuje jednak w tym miejscu nowszego formatu (ResolvableProfile). Te formaty do siebie nie pasują, dlatego głowy w menu nie działają. Serwer działa dalej.
Jak to naprawić:
- Sprawdź w sekcji Wersja, jaką wersję Minecrafta ma Twój serwer.
- Pobierz Simple_RTP w wydaniu dla tej wersji Minecrafta.
- Zatrzymaj serwer, zastąp stary plik w sekcji Pliki w folderze
plugins/i uruchom serwer ponownie. - Otwórz menu w grze i sprawdź, czy głowy się teraz pojawiają.
Warto wiedzieć: Komunikat może się powtarzać przy każdym otwarciu menu. Nie wyrządza żadnych dodatkowych szkód, pokazuje jedynie, że wydanie pluginu jest nieaktualne.
„CommandExecuteException”: dane ZNPCs nie pasują do wersji pluginu
Tak wygląda komunikat:
io.github.gonalez.znpcs.commands.CommandExecuteException
No enum constant io.github.gonalez.znpcs.npc.<…>.PLAYER
Co się za tym kryje: ZNPCs zapisuje twoje NPC wraz z typem i akcjami w pliku. Znajduje się w nim typ lub akcja, której twoja zainstalowana wersja ZNPCs nie zna, na przykład ActionType.PLAYER. Zwykle dzieje się tak, gdy NPC zostały utworzone w innej wersji ZNPCs. Wykonywane polecenie zostaje przerwane, ale serwer działa dalej.
Jak to naprawić:
- Utwórz kopię zapasową w zakładce Kopie zapasowe.
- Zainstaluj wersję ZNPCs, w której utworzono NPC, i uruchom serwer ponownie.
- Jeśli to nie zadziała, zatrzymaj serwer, otwórz w zakładce Pliki plik
plugins/ZNPCs/data.jsoni usuń wpis problematycznego NPC. JSON to format tekstowy z nawiasami i przecinkami: jeden brakujący przecinek sprawia, że cały plik staje się nieczytelny. - Uruchom serwer i ponownie przetestuj polecenie.
Warto wiedzieć: Edytuj plik tylko przy zatrzymanym serwerze. Jeśli serwer działa, ZNPCs może przy wyłączaniu nadpisać twoje zmiany.
„failed to register events”: pluginowi brakuje wymaganej klasy
Tak wygląda komunikat:
Plugin <Plugin> v<Wersja> has failed to register events for class <Klasa> because io/papermc/paper/event/<Zdarzenie> does not exist.
Plugin <Plugin> v<Wersja> has failed to register events for class <Klasa> because <Zależność>/<Klasa> does not exist.
Co się za tym kryje: Pluginy reagują na zdarzenia w grze, na przykład gdy gracz niszczy blok. Podczas konfigurowania tych reakcji brakuje wymaganej klasy, czyli elementu programu. Często plugin potrzebuje Papera zamiast Spigota albo innej wersji Minecrafta; brakująca klasa może jednak pochodzić także z innego pluginu lub biblioteki. Funkcje pluginu, których to dotyczy, przestają działać, serwer działa dalej.
Jak to naprawić:
- Przeczytaj nazwę po
becausei sprawdź wymagania danego pluginu: oprogramowanie serwera, wersję Minecrafta i wymagane dodatkowe pluginy. - Jeśli nazwa zaczyna się od
io/papermc/paperlubcom/destroystokyo/paper, a Twój serwer działa na Spigocie, zrób kopię zapasową i przejdź w sekcji Zmień oprogramowanie / loader na obsługiwaną wersję Papera. - Jeśli serwer już działa na Paperze, użyj pasującego do niego wydania pluginu. Jeśli nazwa wskazuje na inną zależność, zainstaluj ją lub zaktualizuj zgodnie z instrukcją pluginu.
- Uruchom serwer ponownie i sprawdź, czy komunikat zniknął.
Więcej na ten temat: Zmiana oprogramowania i wersji serwera w panelu
„Unsupported class file major version …”: plik zbudowany dla nowszej Javy
Tak wygląda ten komunikat:
java.lang.IllegalArgumentException: Unsupported class file major version 69
Co się za tym kryje: Pluginy, mody i biblioteki są kompilowane dla konkretnej wersji Javy. Liczba za major version zdradza, dla której: liczba minus 44 daje wersję Javy, czyli 65 oznacza Javę 21, a 69 Javę 25. Narzędzia twojego serwera, które odczytują lub przepisują pluginy i mody podczas wczytywania, nie rozumieją tej nowszej wersji. Dany element nie zostaje wczytany.
Jak to naprawić:
- Sprawdź w liniach powyżej, który plugin lub mod był właśnie wczytywany.
- Pobierz dla niego wersję zbudowaną dla twojej wersji Minecrafta i zamień starý plik w Pliki w folderze
plugins/lubmods/. - Alternatywnie zaktualizuj serwer w Wersja do nowszej wersji Minecrafta, która działa z Javą 21 lub nowszą. Odpowiednia wersja Javy jest u nas ustawiana automatycznie. Wcześniej utwórz kopię zapasową.
Dobrze wiedzieć: Jeśli bezpośrednio przed tym komunikatem widać Fatal error trying to convert, obowiązuje sekcja o starszych serwerach Paper opisana wyżej.
Szczegółowo: Jakiej wersji Javy potrzebuje twój serwer Minecraft?
Stary plugin szuka usuniętej funkcji chunków (Legacy ID)
Tak wygląda komunikat:
java.lang.NoSuchMethodException: net.minecraft.world.level.chunk.Chunk.k(net.minecraft.core.BlockPosition)
Co się za tym kryje: Do Minecrafta 1.12 bloki miały numeryczne ID, kamień miał na przykład 1. Niektóre stare pluginy wewnętrznie nadal korzystają z tych Legacy ID i w tym celu odwołują się bezpośrednio do wewnętrznych funkcji gry, czyli klas w net.minecraft. Szukana funkcja chunków nie istnieje już w Twojej wersji. Dlatego funkcja Legacy ID pluginu się nie uruchamia. W zależności od pluginu przestają przez to działać pojedyncze lub liczne funkcje.
Jak to naprawić:
- Zajrzyj do stacktrace'a pod komunikatem, czyli do linii
at …. Znajdziesz tam nazwę pluginu lub jego pliku JAR. - Zaktualizuj ten plugin do wydania dla Twojej wersji Minecrafta i zastąp plik w sekcji Pliki w folderze
plugins/. - Jeśli takiego wydania nie ma, plugin nie jest już rozwijany dla nowoczesnych wersji. Poszukaj aktualnego pluginu zastępczego.
Warto wiedzieć: Krótka nazwa k to zaciemniona nazwa wewnętrzna. Takie nazwy zmieniają się z każdą wersją Minecrafta. Pluginy, które korzystają z nich bezpośrednio, psują się więc niemal przy każdej aktualizacji.
„GameProfile.getProperties()”: plugin używa przestarzałej funkcji profili Mojang
Tak wygląda komunikat:
[<Plugin>] Failed to apply GUI head texture: NoSuchMethodException: com.mojang.authlib.GameProfile.getProperties()
java.lang.NoSuchMethodException: com.mojang.authlib.GameProfile.getProperties()
O co chodzi: authlib to biblioteka Mojang, za pomocą której serwer zarządza profilami graczy z nazwą i skinem. Plugin odczytuje te profile przez metodę (GameProfile.getProperties), której w Twojej wersji Minecrafta już nie ma. Funkcja, której to dotyczy, przestaje działać, najczęściej są to głowy graczy w menu. Serwer działa dalej.
Jak to naprawić:
- Znajdź plugin: często jego nazwa stoi w nawiasach kwadratowych na początku komunikatu. W przeciwnym razie jego nazwę lub plik JAR podają linie
at …poniżej albo linie powyżej. - Pobierz wydanie tego pluginu dla Twojej wersji Minecrafta.
- Zastąp stary plik w Pliki w folderze
plugins/i uruchom serwer ponownie. - Otwórz w grze menu, którego to dotyczy, i sprawdź, czy głowy znów się pojawiają.
Warto wiedzieć: Ta zmiana dotyka jednocześnie wielu pluginów z menu i głowami. Jeśli kilka pluginów przestało pokazywać głowy, zwykle przyczyna jest ta sama, a każdy z nich potrzebuje własnej aktualizacji.
„No enum constant” / „NoSuchFieldException”: plugin nie pasuje do wersji
Tak wygląda komunikat:
java.lang.IllegalArgumentException: No enum constant org.bukkit.Material.<Nazwa>
java.lang.NoSuchFieldException: maxStack
java.lang.NoSuchFieldError: Class org.bukkit.<Klasa> does not have member field '<Pole>'
O co chodzi: Plugin został zbudowany dla innej wersji Minecrafta i odwołuje się do elementów gry, których tu brakuje lub które nazywają się inaczej, na przykład bloków, cząsteczek czy atrybutów. NoSuchFieldException dotyczy też wewnętrznych pól rozmiarów stosów, do których plugin sięga przez Reflection, czyli po ich nazwie. W zależności od pluginu błąd pojawia się przy każdej akcji albo przestają działać pojedyncze funkcje. Mogą też wystąpić Unknown material i Could not initialize Brigadier mappings; Brigadier to system komend Minecrafta z uzupełnianiem klawiszem Tab.
Jak to naprawić:
- Odczytaj nazwę pluginu z linii powyżej lub z linii
at …poniżej. - Pobierz wydanie pluginu dla Twojej wersji Minecrafta, zrób kopię zapasową obecnego stanu i zatrzymaj serwer. Zastąp plik w Pliki w folderze
plugins/i uruchom serwer ponownie. - Alternatywnie ustaw w Wersja wersję Minecrafta obsługiwaną przez plugin. Najpierw zrób kopię zapasową serwera; dla starszej wersji potrzebujesz pasującego do niej stanu świata.
- Jeśli nieznana nazwa materiału znajduje się w pliku konfiguracyjnym pluginu, zastąp ją nazwą obsługiwaną przez Twoją wersję Minecrafta. Brakujące pola wewnętrzne naprawisz, instalując kompatybilną wersję pluginu.
Plugin Marriage nie pasuje do wersji Minecrafta
Tak wygląda komunikat:
[Marriage] Marriage is not compatible with the version of minecraft you are using
Marriage kissing will be disabled!
O co chodzi: Marriage pozwala graczom brać ślub w grze i dodaje funkcje takie jak całowanie. Plugin nie obsługuje Twojej wersji Minecrafta. Dlatego wyłącza co najmniej funkcję całowania, inne elementy też mogą być dotknięte. Serwer działa normalnie dalej.
Jak to naprawić:
- Sprawdź na stronie pluginu, czy istnieje wydanie Marriage dla Twojej wersji Minecrafta. Swoją wersję zobaczysz w Wersja.
- Jeśli istnieje, zastąp stary plik w Pliki w folderze
plugins/i uruchom serwer ponownie. - Jeśli nie istnieje, zastąp plugin aktualnym o podobnej funkcji. Licz się z tym, że inny plugin nie przejmie zapisanych danych Marriage, i najpierw zrób kopię zapasową.
Warto wiedzieć: Jeśli przeszkadza Ci tylko brak całowania, a reszta działa, możesz ignorować komunikat do czasu pojawienia się aktualizacji.
Plugin antycheat lub pakietowy nie zna jeszcze w pełni Twojej wersji Minecrafta
Tak wygląda komunikat:
java.lang.IllegalStateException: Unknown entity metadata type id: <Liczba> version V_<Wersja>
O co chodzi: Niektóre pluginy odczytują pakiety sieciowe przesyłane między grą a serwerem, na przykład antycheat GrimAC za pomocą biblioteki PacketEvents. Z nowymi wersjami Minecrafta dochodzą nowe typy danych dla stworzeń i obiektów, czyli metadane encji. Plugin nie zna jeszcze jednego z nich, zwykle dlatego, że jest starszy niż wersja Twojego serwera. Pakiety, których to dotyczy, są przetwarzane błędnie. Może to powodować fałszywe alarmy antycheatu lub problemy z połączeniem.
Jak to naprawić:
- Zaktualizuj plugin oraz, jeśli jest zainstalowany jako osobny plik, także PacketEvents do wersji, która wyraźnie obsługuje Twoją wersję Minecrafta.
- Uruchom serwer całkowicie od nowa.
- Jeśli pasującej wersji jeszcze nie ma, tymczasowo wyłącz plugin: zmień nazwę jego pliku w Pliki, na przykład na
<Plugin>.jar.off. Serwer wczytuje tylko pliki z rozszerzeniem.jar. - Alternatywnie ustaw w Wersja wersję Minecrafta obsługiwaną przez plugin. Najpierw zrób kopię zapasową.
Dodatek do WorldEdit używa usuniętego interfejsu
Tak wygląda komunikat:
[WorldEdit] Got request to set EditSessionFactory <…> EditSessionFactories have been removed …
O co chodzi: WorldEdit usunął starszy interfejs, EditSessionFactory. Dzięki niemu pluginy dodatkowe mogły podpinać się pod każdą zmianę wykonaną w WorldEdit. Jakiś plugin dodatkowy, na przykład do logowania bloków lub ochrony terenu, wciąż próbuje go używać. Sam WorldEdit działa normalnie. Funkcja logowania lub ochrony pluginu dodatkowego nie obejmuje jednak zmian z WorldEdit: to, co budujesz lub usuwasz za pomocą WorldEdit, nie jest przez niego ani rejestrowane, ani blokowane.
Jak to naprawić:
- Ustal, który plugin wysyła to żądanie. Jego nazwa zwykle stoi w samym komunikacie lub w liniach powyżej.
- Zaktualizuj ten plugin dodatkowy do wersji, która współpracuje z Twoim WorldEdit lub FastAsyncWorldEdit (FAWE, szybszy wariant WorldEdit).
- Jeśli takiej nie ma, wyłącz integrację z WorldEdit w konfiguracji pluginu dodatkowego, o ile jest do tego odpowiednie ustawienie.
- Uruchom serwer ponownie i sprawdź, czy komunikat zniknął.
Warto wiedzieć: Dopóki tego nie naprawisz, nie możesz polegać na tym, że zmiany z WorldEdit są rejestrowane ani że da się je w ten sposób cofnąć.
Braslety: przepis nie zostaje zarejestrowany
Tak wygląda komunikat:
[Braslety] … java.lang.IllegalAccessException: class com.example.braslety.BraceletsPlugin cannot access …
O co chodzi: Braslety sięga przez Reflection do wewnętrznych klas CraftBukkit. Reflection oznacza, że plugin odczytuje elementy serwera bezpośrednio, zamiast korzystać z oficjalnego interfejsu. W Twojej wersji serwera te elementy nie są dostępne, a Java odmawia dostępu. Dlatego przepis, którego to dotyczy, nie zostaje zarejestrowany, więc powiązanego przedmiotu nie da się wytworzyć. Serwer działa dalej.
Jak to naprawić:
- Sprawdź, czy istnieje wersja Braslety dla Twojego obecnego buildu Paper. Swój stan zobaczysz w Wersja.
- Jeśli istnieje, zastąp stary plik w Pliki w folderze
plugins/i uruchom serwer ponownie. - Jeśli nie istnieje, zastąp plugin rozwijanym pluginem o podobnej funkcji.
- Sprawdź w grze, czy przepis działa.
Warto wiedzieć: Nazwa pakietu com.example wskazuje na samodzielnie stworzony lub mało popularny plugin. Aktualizację może wtedy dostarczyć tylko jego twórca.
„Error during loading of Protocol…”: ViaVersion nie może załadować modułu tłumaczenia
Tak wygląda komunikat:
[ViaVersion] Error during loading of Protocol<Wersja>To<Wersja>
java.util.concurrent.CompletionException: java.lang.NoSuchMethodError: '…'
Co się za tym kryje: ViaVersion tłumaczy między wersjami gry, aby gracze z nowszymi lub starszymi klientami również mogli dołączyć. Rozszerzenia takie jak ViaBackwards uzupełniają to dla starszych klientów. Każde tłumaczenie znajduje się we własnym module, którego nazwa zaczyna się od Protocol. Jednego z nich nie udało się załadować, zwykle dlatego, że ViaVersion i jego rozszerzenia nie pasują do siebie nawzajem lub do wersji serwera. Gracze z danymi wersjami klienta nie mogą wtedy dołączyć. Kto gra dokładnie na wersji serwera, nie jest tym dotknięty.
Jak to naprawić:
- Pobierz najnowsze wersje ViaVersion i wszystkich rozszerzeń Via, z których korzystasz.
- Zastąp je wszystkie naraz w Pliki w folderze
plugins/. Nie mieszaj starych i nowych plików Via. - Uruchom serwer całkowicie od nowa.
- Przetestuj dołączanie z wersją klienta, która wcześniej nie działała.
Warto wiedzieć: Jeśli pod komunikatem widnieje NoSuchMethodError, pliki Via do siebie nie pasują. Szczegóły: Konfiguracja ViaVersion: łączenie starszych i nowszych klientów
LibreLogin nie działa na Spigot
Tak wygląda komunikat:
[LibreLogin] Detected an unsupported server distribution. Please use Paper or its forks. SPIGOT IS NOT SUPPORTED!
Co się za tym kryje: LibreLogin to plugin logowania: gracze logują się za pomocą hasła. Jest to szczególnie ważne na serwerach działających w trybie offline. LibreLogin wymaga Paper lub kompatybilnego forka, czyli odmiany Paper, takiej jak Purpur, i wyłącza się na Spigot. Jeśli Twój serwer działa w trybie offline, brakuje przez to ochrony hasłem: gracze mogą łączyć się pod cudzymi nickami.
Jak to naprawić:
- Utwórz kopię zapasową w zakładce Kopie zapasowe.
- Przełącz serwer na Paper lub Purpur w zakładce Zmień oprogramowanie / loader. Pluginy dla Spigot z reguły nadal tam działają.
- Uruchom ponownie serwer i sprawdź w zakładce Konsola, czy LibreLogin ładuje się bez tego komunikatu.
- Jeśli chcesz zostać przy Spigot, użyj pluginu logowania, który wyraźnie obsługuje Spigot.
Warto wiedzieć: Jeśli Twój serwer działa w trybie offline, napraw to, zanim gracze zaczną dołączać.
Więcej na ten temat: Zmiana oprogramowania i wersji serwera w panelu
Novej brakuje parametru startowego Javy (-javaagent)
Tak wygląda komunikat:
[Nova] Missing required JVM argument: -javaagent:plugins/Nova-<Wersja>.jar
Co się za tym kryje: Nova to rozbudowany plugin, który umożliwia dodawanie własnych bloków i przedmiotów na serwerach Paper. Do części swoich funkcji wymaga, aby Java przy starcie załadowała tak zwany Java-Agent. Jest to dodatek, który uruchamia się jeszcze przed właściwym serwerem i jest dołączany za pomocą parametru startowego. Twój serwer uruchamia się bez tego parametru. Nova nie działa więc w pełni, choć sam serwer działa.
Jak to naprawić:
- Odczytaj z komunikatu dokładny parametr, łącznie z nazwą pliku JAR Novej.
- Polecenia startowego swojego serwera Minecraft nie możesz samodzielnie zmienić w panelu. Otwórz więc zgłoszenie, wklej do niego parametr z komunikatu i podaj godzinę jego wystąpienia.
- Jeśli Nova nie jest Ci koniecznie potrzebna, usuń plugin w zakładce Pluginy i uruchom ponownie serwer. Komunikat wtedy zniknie.
Warto wiedzieć: Z każdą nową wersją Novej zwykle zmienia się też nazwa pliku w parametrze. Dlatego po aktualizacji Novej komunikat często pojawia się ponownie.
AngelChest: integracja z WorldGuard wyłączona z powodu konfliktu wersji
Tak wygląda komunikat:
[AngelChest] WorldGuard integration is disabled.
Co się za tym kryje: AngelChest wykrywa, że WorldGuard nie obsługuje w pełni Twojej wersji Minecraft. Dlatego wyłącza połączenie z tym pluginem. Zależne od niego funkcje AngelChest są niedostępne, a serwer nadal działa. Sprawdź działanie w chronionych obszarach, zanim znowu zaczniesz polegać na współpracy obu pluginów.
Jak to naprawić:
- Zanotuj wersję Minecraft z zakładki Wersja i sprawdź w zakładce Konsola wersje załadowanych pluginów.
- Utwórz kopię zapasową swoich ustawień w zakładce Kopie zapasowe.
- Zainstaluj w zakładce Pluginy wydania WorldGuard i AngelChest, które obsługują Twoją wersję Minecraft.
- Uruchom serwer całkowicie od nowa. Sprawdź, czy komunikat zniknął, i przetestuj AngelChest w dotkniętych obszarach.
EssentialsSpawn: teleportacja nowych graczy nie działa z powodu brakującej metody
Tak wygląda komunikat:
[EssentialsSpawn] <Gracz> Failed to teleport new player!
java.util.concurrent.CompletionException: java.lang.AbstractMethodError: Receiver class com.earth2me.essentials.OfflinePlayerStub <Szczegóły>
Co się za tym kryje: EssentialsSpawn wywołuje dla nowego gracza interfejs teleportacji Paper. Błąd AbstractMethodError oznacza, że używana klasa Essentials nie udostępnia oczekiwanej metody. Zainstalowane komponenty nie pasują do siebie w tym miejscu; automatyczna teleportacja nie działa, a serwer nadal pracuje.
Jak to naprawić:
- Zabezpiecz konfigurację pluginów i sprawdź w zakładce Konsola pełny komunikat błędu oraz wersje załadowanych pluginów.
- Zaktualizuj jednocześnie EssentialsX i EssentialsSpawn w zakładce Pluginy do wydania pasującego do Twojej wersji Paper. W przypadku plików przesłanych samodzielnie użyj zakładki Pliki.
- Usuń stare, zdublowane pliki tych pluginów w zakładce Pliki i uruchom serwer całkowicie od nowa.
- Przetestuj teleportację nowo dołączającego gracza. Jeśli błąd nie zniknie, zgłoś go projektowi EssentialsX, dołączając oczyszczony ślad błędu i wszystkie używane wersje.
Folia odrzuca plugin z powodu braku wsparcia
Tak wygląda komunikat:
Could not load plugin '<Plugin> <Wersja>' as it is not marked as supporting Folia!
Co się za tym kryje: Folia przetwarza obszary świata równolegle i wymaga do tego dostosowanych pluginów. Ten plugin nie deklaruje takiego wsparcia i zostaje odrzucony podczas ładowania. Jego funkcje są niedostępne, ale inne odpowiednie pluginy mogą nadal się ładować.
Jak to naprawić:
- Sprawdź w zakładce Konsola, którego pliku pluginu to dotyczy, i przejrzyj informacje autora na temat Folii.
- Zainstaluj w zakładce Pluginy lub Pliki wydanie z wyraźnym wsparciem i uruchom serwer całkowicie od nowa.
- Jeśli nie ma wydania dla Folii, wybierz alternatywę. Przed zmianą oprogramowania serwera najpierw utwórz kopię zapasową w zakładce Kopie zapasowe i sprawdź wymagania wszystkich pluginów.
Warto wiedzieć: Samodzielne dopisanie deklaracji wsparcia nie sprawi, że plugin będzie kompatybilny z Folią.
CnUsername nie może odblokować nazw ze znakami specjalnymi
Tak wygląda komunikat:
[CnUsername] 修改StringUtil类失败: java.lang.IllegalStateException: 修改类 net.minecraft.util.StringUtil 失败!
Co się za tym kryje: Minecraft pozwala w nazwach graczy tylko na litery, cyfry i podkreślnik. CnUsername zmienia przy starcie wewnętrzną klasę serwera, aby działały też znaki chińskie i inne. Chiński komunikat oznacza: zmiana klasy StringUtil nie powiodła się. Plugin nie pasuje do twojej wersji serwera. Gracze z takimi nazwami nadal nie mogą wejść na serwer, wszystko inne działa normalnie.
Jak to naprawić:
- Sprawdź na stronie pluginu CnUsername, które wersje serwera są obsługiwane.
- Zatrzymaj serwer i zastąp plik w Pluginy odpowiednim wydaniem.
- Jeśli nie ma pasującego wydania, usuń plugin albo przejdź w Wersja na obsługiwaną wersję Minecrafta. Wcześniej utwórz kopię zapasową w Kopie zapasowe.
- Uruchom serwer i sprawdź Konsola.
Warto wiedzieć: Odrzucone nazwy pojawiają się w logu jako „The name of the profile contains invalid characters”.
Nie ma tu Twojego komunikatu?
Przeczytaj cały komunikat w Konsola albo w logs/latest.log, także linie przed nim. Problematyczny plugin rozpoznasz po nazwie w nawiasach kwadratowych na początku linii albo w stacktrace, czyli liście linii at …: znajdziesz tam nazwy plików JAR z plugins/ lub mods/ oraz nazwy pakietów, które często zawierają nazwę pluginu. Następnie porównaj wersje obsługiwane na stronie pluginu z wersją swojego serwera. Przed każdą zmianą wersji utwórz kopię zapasową. Jeśli nie wiesz, co dalej, otwórz zgłoszenie i podaj godzinę wystąpienia komunikatu.