Crash serwera po wgraniu modów

Najczęstsze przyczyny to brakująca biblioteka, mod pod inny loader lub inną wersję gry, mod przeznaczony tylko dla gracza, dwie wersje tego samego moda albo zła wersja Javy. Panel często rozpoznaje przyczynę sam i pokazuje ją w zakładce Konsola. Jeśli nie, znajdziesz ją w logu startu według komunikatów opisanych niżej.

Krok 1: sprawdź kartę diagnozy w Konsoli

Otwórz zakładkę Konsola i uruchom serwer. Jeśli panel rozpozna błąd startu, nad logiem pojawi się karta z nazwą problemu. Kliknij ją, aby zobaczyć wyjaśnienie z nazwą moda i zalecane działanie. Karta jest widoczna w trakcie startu: gdy serwer się wyłączy, Konsola pokazuje tylko komunikat Serwer jest wyłączony, więc uruchom serwer ponownie z otwartą Konsolą. Przy modach najczęściej zobaczysz:

• Brakuje zależności moda lub pluginu. Mod wymaga biblioteki, której nie ma na serwerze albo jest w złej wersji.
• Wykryto mod tylko dla klienta. Na serwer trafił mod przeznaczony dla gracza.
• Niepasująca wersja Java. Mod albo loader wymaga innej wersji Javy niż ustawiona.
• Serwerowi zabrakło pamięci RAM. Mody potrzebują więcej pamięci, niż ma plan.
• Błędna wartość w konfiguracji. W pliku ustawień moda jest wartość, której mod nie rozumie.

Kontrolowany start na testowym serwerze Forge 1.20.1: Waystones bez wymaganej biblioteki Balm

Karta Wykryto kod klienta w modzie to ostrzeżenie, a nie błąd: serwer pominął fragment moda przeznaczony dla gracza i wystartował. Jeśli wszystko działa, możesz ją odrzucić.

Niektóre błędy panel pokazuje też na górze każdej strony serwera, w alercie Serwer wymaga uwagi. Przy modach najczęściej to Uszkodzony mod lub datapack blokuje start serwera: zwykle winny jest mod tylko dla gracza albo uszkodzony lub niezgodny mod, a jego nazwę znajdziesz w logu.

Krok 2: znajdź błąd w logu

Jeśli karty nie ma, przewiń Konsolę do miejsca, w którym serwer się zatrzymał, albo włącz filtr Błędy nad logiem. Szukaj pierwszego komunikatu z ERROR, Exception lub Caused by, a nie ostatniej linii. Linia [voxelhost.pl] Nie udało się załadować logów. Serwer prawdopodobnie jest wyłączony. nie jest przyczyną problemu, tylko informacją, że serwer się wyłączył. Przyczyna jest wyżej. Pełny log zapisuje się w pliku logs/latest.log, a przy crashu dodatkowo w folderze crash-reports. Oba otworzysz w zakładce Pliki. Więcej o czytaniu logów znajdziesz w poradniku Jak czytać logi i crash reporty.

W komunikacie zwykle widać identyfikator moda (mod ID), na przykład create albo fabric-api. Ten sam identyfikator znajdziesz w nazwie pliku w folderze mods lub na stronie moda.

Najczęstsze przyczyny i komunikaty

Brakująca biblioteka (zależność)

Mod potrzebuje innego moda, zwykle biblioteki, takiej jak Fabric API, Architectury API czy Cloth Config.

• Fabric wypisuje Some of your mods are incompatible with the game or each other!, a pod spodem linię kończącą się na which is missing!, na przykład requires any version of fabric-api, which is missing!. Quilt zgłasza brak zależności podobnie.
• Forge i NeoForge wypisują Missing or unsupported mandatory dependencies: z linią w rodzaju Mod ID: 'balm', Requested by: 'waystones', Expected range: '[7.3.28,)', Actual version: '[MISSING]', a chwilę później Mod waystones requires balm 7.3.28 or above i Currently, balm is not installed. W Konsoli te linie mogą zawierać znaki formatowania, na przykład §e.

Rozwiązanie: zainstaluj brakującą bibliotekę w zakładce Mody (podzakładka Przeglądaj) albo ręcznie, w wersji zgodnej z wymaganym zakresem. Jeśli zamiast [MISSING] widać numer wersji, biblioteka jest, ale zbyt stara lub zbyt nowa. Zaktualizuj ją albo moda, który jej wymaga. Linia Fabric z recommends ..., which is missing to tylko zalecenie: serwer wystartuje bez tej biblioteki.

Mod pod inną wersję Minecrafta lub inny loader

• Fabric pisze wtedy, że mod wymaga innej wersji minecraft, niż jest na serwerze, i kończy linię na but only the wrong version is present.
• Forge i NeoForge pokazują taki sam komunikat jak przy brakującej bibliotece, ale wskazują minecraft, forge lub neoforge i oczekiwany zakres wersji.
• Mod dla innego loadera (na przykład mod Forge na serwerze Fabric) zwykle w ogóle się nie wczytuje. Serwer startuje, ale mod nie działa.

Rozwiązanie: pobierz wydanie moda dla loadera i wersji gry ustawionych w Ustawienia > Konfiguracja serwera i usuń stary plik. Jeśli moda nie ma w wersji dla Twojego serwera, nie zadziała na nim.

Mod tylko dla gracza

Mody graficzne, shadery, minimapy i mody menu odwołują się do części gry, której serwer nie ma.

• Forge i NeoForge zatrzymują start z komunikatem Attempted to load class net/minecraft/client/... for invalid dist DEDICATED_SERVER.
• Fabric i Quilt pomijają tylko mody, które autor oznaczył jako klienckie. Wiele modów dla gracza, także minimapy, nie ma tego oznaczenia i zatrzymuje start błędem NoClassDefFoundError lub ClassNotFoundException zaraz po wczytaniu.

Rozwiązanie: usuń mod z folderu mods. Gracze, którzy chcą go używać, instalują go u siebie. Zakładka Mody w panelu nie pozwala instalować modów klienckich, więc ten problem dotyczy zwykle plików wgranych ręcznie.

Dwie wersje tego samego moda

Zdarza się po ręcznej aktualizacji, gdy w folderze mods zostaje stary plik obok nowego. W logu zwykle pojawia się słowo duplicate i nazwy obu plików.

Rozwiązanie: zostaw tylko nowszy plik. W zakładce Mody oba pliki są widoczne na liście Zainstalowane z numerami wersji.

Konflikt między modami

Komunikaty z Mixin apply failed, MixinApplyError albo @Mixin target ... was not found oznaczają, że mod próbuje zmienić fragment gry lub innego moda, który wygląda inaczej, niż się spodziewa. Najczęściej to dwa mody zmieniające to samo albo mod zbudowany pod inną wersję gry.

Rozwiązanie: zaktualizuj oba mody wymienione w błędzie. Jeśli to nie pomoże, sprawdź na stronie moda listę znanych niezgodności i zostaw tylko jeden z nich.

Zła wersja Javy

W logu zobaczysz Unsupported class file major version albo compiled by a more recent version of the Java Runtime. Nowe wersje Minecrafta wymagają nowszej Javy, a starsze wersje Forge nie działają na zbyt nowej: wymagają Javy 8, a na nowszej kończą start błędem Unknown option: -s.

Rozwiązanie: w Ustawienia > Konfiguracja serwera otwórz kartę Wersja Javy i wybierz wersję wymaganą przez loader i wersję gry. Zmiana wyłącza serwer, więc po niej uruchom go ponownie.

Za mało pamięci RAM

Komunikat java.lang.OutOfMemoryError oznacza, że mody zużyły całą pamięć planu. Zmniejsz liczbę modów albo wybierz wyższy plan w Ustawienia > Plan i płatności.

Gdy log nie wskazuje winnego moda

Wyłączaj mody połówkami, aż znajdziesz ten, który blokuje start:

1. Zrób backup w zakładce Backupy. Start bez części modów może usunąć ze świata ich bloki i przedmioty, dlatego po testach przywrócisz kopię.
2. W zakładce Pliki otwórz folder mods i zmień nazwę połowy plików, dopisując na końcu .disabled, na przykład przykladowymod.jar.disabled. Loader pomija pliki, które nie kończą się na .jar. Biblioteki (Fabric API, Architectury API, Cloth Config i podobne) zostaw włączone.
3. Kliknij Restart. Jeśli serwer wystartował, winny mod jest wśród wyłączonych. Jeśli nie, jest wśród włączonych.
4. Powtarzaj, dzieląc podejrzaną grupę na pół, aż zostanie jeden plik.
5. Usuń albo wymień winny mod, przywróć nazwy pozostałych plików i przywróć backup, jeśli serwer uruchamiał świat bez części modów.

Jeśli utkniesz, napisz na naszym Discordzie i dołącz fragment logu z pierwszym błędem.

Powiązane artykuły

• Jak czytać logi i crash reporty
• Jak zainstalować mody na serwerze
• Mody klienckie: co instalują gracze, a co serwer

---

Ostatnia aktualizacja: listopad 2026.