Poradnik

Jak naprawić błędy pluginów Minecraft

Zaktualizowano: 18 października 2026

Gdy plugin się nie ładuje, serwer prawie zawsze mówi dlaczego: powód jest w konsoli podczas startu, kilka linii nad lub pod nazwą pluginu. Naucz się czytać tę część logu, a naprawa większości błędów zajmie minutę. Oto najczęstsze z nich i co oznaczają.

Podaj wersję serwera i to, co plugin ma robić.

Wygeneruj to w Codexe

Krok po kroku

1.Otwórz log ze startu
Przeczytaj konsolę albo logs/latest.log w folderze serwera. W panelu hostingu użyj jego konsoli lub menedżera plików.
2.Wyszukaj nazwę pluginu
Znajdź pierwszy błąd, który o nim wspomina. Liczą się linie zaczynające się od [ERROR] lub [WARN] ze stack trace pod nimi.
3.Przeczytaj pierwszą linię i linie „Caused by”
Pierwsza linia mówi, co się nie udało; ostatnia linia Caused by: zwykle mówi dlaczego. Linie z nazwą pakietu samego pluginu pokazują, w którym miejscu jego kodu.
4.Dopasuj go do listy poniżej
Większość błędów przy starcie to problem z wersją, Javą lub zależnością, a komunikat mówi, z czym.
5.Napraw jedną rzecz i zrestartuj
Zmień jedną rzecz, zrestartuj serwer (nie przez /reload) i ponownie przeczytaj log. Błędy jednego pluginu mogą wywoływać błędy w innych.

Najczęstsze błędy

Widzisz	Co to oznacza	Rozwiązanie
`Unsupported API version 1.21`	`api-version` pluginu jest nowsze niż twój serwer.	Pobierz wersję pod swój serwer albo zaktualizuj serwer.
`Could not load 'plugins/X.jar'` z `Invalid plugin.yml` lub `Jar does not contain plugin.yml`	Brakuje deskryptora pluginu albo ma on błąd YAML, albo plik nie jest pluginem.	Sprawdź, czy pobrałeś plugin, a nie jego kod źródłowy, mod lub zip. Jeśli sam go zbudowałeś, popraw `plugin.yml`.
`UnsupportedClassVersionError`, „class file version 65.0”	Plugin potrzebuje nowszej Javy niż ta, na której działa serwer (61 = Java 17, 65 = Java 21, 69 = Java 25).	Uruchom serwer na tej Javie albo przebuduj plugin pod swoją Javę.
`NoClassDefFoundError` lub `ClassNotFoundException`	Brakuje klasy, której potrzebuje plugin: brakuje pluginu będącego zależnością, biblioteka nie została spakowana do pliku .jar albo to API nie istnieje w tej wersji.	Zainstaluj plugin wymieniony w błędzie (Vault, ProtocolLib) albo użyj builda pod swoją wersję.
`Unknown/missing dependency plugins`	Plugin wymieniony w `depend` nie jest zainstalowany.	Zainstaluj go w `plugins/`.
`Error occurred while enabling X (Is it up to date?)`	Plugin się załadował, ale wysypał się w `onEnable`.	Przeczytaj linię `Caused by`: często to błąd konfiguracji lub brakująca zależność.
`Ambiguous plugin name`	W `plugins/` są dwa pliki .jar tego samego pluginu.	Usuń stary.

Błędy niezwiązane z ładowaniem

Plugin jest zielony, ale komenda zwraca „Unknown command”: komendy brakuje w plugin.yml albo inny plugin używa tej samej nazwy.
„I'm sorry, but you do not have permission”: gracz nie ma węzła uprawnień. Sprawdź węzeł na stronie pluginu i nadaj go swoim pluginem uprawnień.
Błędy po edycji config.yml: YAML wymaga spacji, a nie tabulatorów, oraz cudzysłowów wokół tekstu z : lub & na początku.
Działa po restarcie, psuje się po /reload: plugin nie obsługuje /reload. Zamiast tego zrestartuj serwer.

Jakiej Javy potrzebuje twój serwer

Minecraft 1.20.5 i nowsze wymagają Javy 21, a 26.x wymaga Javy 25; wersje od 1.18 do 1.20.4 wymagają Javy 17. Uruchom java -version tą samą Javą, której używa serwer (w panelu hostingu to zwykle ustawienie o nazwie obraz Docker lub wersja Javy). Plugin zbudowany pod starszą Javę działa na nowszej, ale nie odwrotnie.

Naprawianie pluginów zrobionych w Codexe

Pluginy zrobione w Codexe są kompilowane pod wybraną wersję i sprawdzane pod kątem poprawnego plugin.yml, zanim będą gotowe. Na serwerze testowym karta Logi pokazuje log na żywo z wyróżnionymi błędami, a Eksportuj logi zapisuje go jako plik. Opisz na czacie projektu, co widzisz („plugin jest czerwony w /plugins, a log mówi ...”), a Codexe zmieni kod i zbuduje go ponownie. Jeśli Skompiluj się nie powiedzie na plikach dokładnie takich, jakie dostarczył Codexe, Napraw z AI naprawi je za darmo.

Pytania

Gdzie jest log serwera?

logs/latest.log w folderze serwera, dla bieżącego uruchomienia. Starsze uruchomienia są w tym samym folderze jako pliki .log.gz.

Czy jeden plugin może zepsuć inny?

Tak: brakująca lub zepsuta zależność zatrzymuje każdy plugin, który jej potrzebuje. Napraw pierwszy błąd w logu przed pozostałymi.

Czy udostępnianie logu jest bezpieczne?

Zwykle tak, ale najpierw go sprawdź: logi mogą zawierać adresy IP, a przy niektórych pluginach także hasła do bazy danych z komunikatów o błędach.

Przebuduj zepsuty plugin pod swój serwer

Ten prompt otworzy się gotowy do wysłania:

“Plugin na Paper 1.21.4 o nazwie SimpleWarps, który zastępuje mój stary, już się nieładujący: /setwarp, /warp i /delwarp z nazwą, /warps wyświetla je w GUI, uprawnienie warps.admin do ustawiania i usuwania, warpy zapisywane między restartami, wiadomości w config.yml.”