Minecraft crashuje z modami - jak to naprawić

Aktualizacja:

Spis treści:

Exit code 1 oznacza tylko tyle, że proces Javy, w którym działa Minecraft, zakończył się błędem. Sam kod nie mówi, co się stało - właściwa przyczyna jest zapisana w crash reporcie (folder crash-reports) albo w pliku logs/latest.log w folderze gry. Przy modach najczęściej chodzi o złą wersję Javy, mod do innej wersji gry lub innego modloadera, brakującą bibliotekę, zdublowany plik albo konflikt dwóch modów. Poniżej pokazujemy, jak znaleźć w logu właściwą linijkę i co z nią zrobić.

Co oznacza exit code 1?

Launcher nie wie, dlaczego gra się wyłączyła. Widzi tylko, że Java zakończyła działanie z kodem innym niż zero, i pokazuje okno o awarii z dopiskiem Exit Code: 1. To najbardziej ogólny kod błędu, więc za tym samym komunikatem może stać wiele różnych problemów. Dlatego rady w stylu "przeinstaluj Javę" raz pomagają, a raz nie. Zamiast zgadywać, zajrzyj do logów.

Osobny przypadek to długie ujemne kody, takie jak -1073741819. To windowsowy kod naruszenia dostępu do pamięci - przy Minecrafcie często oznacza, że wysypał się sterownik karty graficznej albo inna natywna biblioteka, a nie sam mod.

Gdzie znaleźć crash report i latest.log

W oficjalnym launcherze wszystko leży w folderze .minecraft - wciśnij Windows + R, wpisz %appdata%\.minecraft i zatwierdź Enterem. Interesują cię:

  • crash-reports - pliki w rodzaju crash-2026-10-29_18.42.10-client.txt. Powstają, gdy gra zdąży sama wychwycić błąd.
  • logs/latest.log - pełny zapis ostatniego uruchomienia. Jest nadpisywany przy każdym starcie, więc skopiuj go, zanim spróbujesz ponownie. Starsze logi leżą obok jako spakowane pliki .log.gz.
  • logs/debug.log - na Forge i NeoForge bardziej szczegółowa wersja logu.
  • hs_err_pid z numerem, np. hs_err_pid12345.log, bezpośrednio w folderze gry - pojawia się, gdy wysypała się sama Java, a nie gra. Wtedy crash reportu nie ma.

W CurseForge App każda paczka ma własny folder - kliknij profil prawym przyciskiem i wybierz otwarcie folderu. Domyślnie paczki leżą w folderze użytkownika, w curseforge\minecraft\Instances. W Prism Launcher kliknij instancję prawym przyciskiem i wybierz Folder; logi są w podfolderze minecraft lub .minecraft, a bieżący log widać też na żywo w oknie instancji.

Jeśli crash reportu nie ma, gra wysypała się, zanim zdążyła go zapisać - wtedy odpowiedź jest w latest.log. A jeśli latest.log ma starą datę, gra w ogóle nie wystartowała: problem leży w Javie albo w argumentach uruchomienia ustawionych w launcherze.

Jak czytać crash report

Crash report otwierasz zwykłym notatnikiem. Wygląda jak ściana tekstu, ale liczy się w nim tylko kilka miejsc:

  1. Description na samej górze - krótki opis sytuacji, np. Initializing game (crash przy starcie), Rendering overlay albo Ticking entity (błąd konkretnego moba lub obiektu w świecie).
  2. Linijka pod opisem - typ wyjątku i komunikat, np. java.lang.NullPointerException albo java.lang.NoClassDefFoundError.
  3. Linie zaczynające się od at - szukaj w nich nazw pakietów zawierających nazwę moda albo autora. Linie z net.minecraft, java. czy org.spongepowered należą do gry i bibliotek.
  4. Ostatnie Caused by: - jeśli w raporcie jest ich kilka, to najniższe zwykle wskazuje pierwotną przyczynę.
  5. Suspected Mod(s) - na Forge i NeoForge raport często podaje podejrzany mod. To podpowiedź, nie wyrok.
  6. System Details na dole - wersja gry, wersja Javy i lista wczytanych modów. Sprawdź tu, czy gra działa na właściwej Javie.

Dwie wskazówki na skróty: NoClassDefFoundError albo ClassNotFoundException z nazwą klasy innego moda zwykle oznacza brakującą zależność lub jej złą wersję. Słowa Mixin, MixinApplyError czy InvalidInjectionException wskazują na mody, które próbują zmienić ten sam fragment gry - w pobliżu zwykle pada nazwa pliku w rodzaju nazwamoda.mixins.json, która zdradza winowajcę.

Jak przeszukać latest.log

Log jest dłuższy niż crash report, więc korzystaj z wyszukiwania (Ctrl + F): ERROR, FATAL, Exception. Czytaj od końca w górę - ostatni błąd przed zamknięciem gry jest zwykle najważniejszy. Linijki z WARN możesz w większości pominąć, bo wiele modów zapisuje ostrzeżenia także przy normalnym działaniu.

Najczęstsze przyczyny i jak je naprawić

Zła wersja Javy

Każda wersja gry wymaga określonej Javy: 1.20.5 i nowsze - Javy 21, 1.18-1.20.4 - Javy 17, a 1.16.5 i starsze - Javy 8. Stary Forge, na przykład na 1.12.2, nie uruchomi się na nowszej Javie. Najnowsze wersje gry mogą wymagać jeszcze nowszej Javy, ale oficjalny launcher dobiera ją sam.

Kłopot pojawia się, gdy w profilu wskazano ręcznie inną Javę. W oficjalnym launcherze sprawdź Instalacje → Edytuj → Więcej opcji i pole z plikiem wykonywalnym Javy - jeśli jest wypełnione, wyczyść je, a launcher wróci do własnej Javy. W innych launcherach wybierz w ustawieniach instancji wersję pasującą do gry.

Za stary modloader albo mod do innej wersji

O plikach przeznaczonych na inną wersję gry piszemy w poradniku instalacji modów. Rzadziej sprawdzana przyczyna to wersja samego modloadera. Nowe wydania modów często wymagają nowszego Fabric Loadera lub NeoForge, a Fabric zgłasza to komunikatem w rodzaju:

requires version 0.16.0 or later of fabricloader, but only the wrong version is present: 0.15.11!

Rozwiązanie: uruchom ponownie instalator modloadera i zainstaluj nowszą wersję dla tej samej wersji gry. Pamiętaj też, że od 1.20.2 mody na Forge i NeoForge to osobne pliki - szczegóły w poradniku jak zainstalować NeoForge.

Brakująca biblioteka

Wiele modów korzysta z bibliotek, które same nie dodają nic do gry, ale bez nich zależny mod nie wystartuje. Najczęściej są to Fabric API, GeckoLib, Architectury API, Cloth Config API, Curios API i Balm. Forge i NeoForge pokazują wtedy komunikat w rodzaju:

Missing or unsupported mandatory dependencies:
Mod ID: 'geckolib', Requested by: 'nazwamoda', Expected range: '[4.4,)', Actual version: '[MISSING]'

Mod ID to brakująca biblioteka, Requested by - mod, który jej potrzebuje, a Expected range - wymagane wersje ([4.4,) oznacza 4.4 lub nowszą). [MISSING] znaczy, że biblioteki nie ma wcale. Jeśli zamiast tego stoi numer wersji, biblioteka jest, ale w złej wersji i trzeba ją zaktualizować. Listę zależności znajdziesz na stronie moda - pobierz je dla tej samej wersji gry i tego samego modloadera.

Ten sam mod dwa razy

Po aktualizacji moda stary plik często zostaje w folderze obok nowego. Modloader zgłasza wtedy zdublowany identyfikator moda (mod ID) i odmawia startu. Posortuj folder mods po nazwie - duplikaty będą stały obok siebie. Usuń starszą wersję.

Konflikt dwóch modów

Każdy mod osobno działa, razem - crash. Najczęściej oba zmieniają ten sam fragment gry, a log pełen jest wspomnianych wyżej błędów Mixin. Klasyczne przykłady to OptiFine razem z Sodium albo dwa porty Sodium w jednym folderze (więcej w poradniku mody na FPS). Najpierw zaktualizuj oba mody, bo autorzy często poprawiają zgodność. Jeśli to nie pomaga, zajrzyj do zgłoszeń błędów na stronie projektu albo zrezygnuj z jednego z nich.

Sterownik karty graficznej

Crash przy starcie z komunikatem GLFW error 65542: WGL: The driver does not appear to support OpenGL albo plik hs_err_pid zamiast crash reportu to typowe objawy problemów ze sterownikiem. W pliku hs_err_pid poszukaj linijki Problematic frame - jeśli jest tam np. nvoglv64.dll (NVIDIA), atio6axx.dll (AMD) albo ig9icd64.dll (Intel), winna jest biblioteka OpenGL ze sterownika. Pobierz najnowszy sterownik ze strony producenta karty, a na laptopie upewnij się, że gra działa na dedykowanej karcie graficznej.

Za mało pamięci

OutOfMemoryError w logu wskazuje na brak pamięci, a gra, która przestała startować zaraz po zwiększeniu przydziału, ma zwykle błąd w argumencie -Xmx. Oba przypadki opisujemy w poradniku jak przydzielić więcej RAM.

Uszkodzona konfiguracja albo problem w świecie

Jeśli crash pojawił się po zmianie ustawień moda, usuń jego plik z folderu config - mod utworzy nowy z domyślnymi wartościami. Crash z opisem Ticking entity lub Ticking block entity powtarza się za każdym razem, gdy wczytuje się dany fragment świata. W raporcie znajdziesz typ obiektu i jego współrzędne, a po identyfikatorze w rodzaju nazwamoda:obiekt poznasz mod, do którego należy. Zaktualizuj go i zgłoś błąd autorowi. Zanim cokolwiek zmienisz, zrób kopię folderu saves.

Metoda 50/50 - jak znaleźć winny mod

Gdy log nie wskazuje jednoznacznie winowajcy, zostaje metoda połówkowa:

  1. Zrób kopię całego folderu mods w bezpiecznym miejscu.
  2. Przenieś połowę modów poza folder.
  3. Uruchom grę. Jeśli crash nadal występuje, winny jest w pozostałej połowie; jeśli zniknął - w wyjętej.
  4. Z podejrzanej połowy znowu wyjmij połowę i powtarzaj, aż zostanie jeden plik.

Najważniejsza zasada: biblioteki zostają w folderze przez cały czas. Jeśli wyjmiesz GeckoLib, a zostawisz mod, który go potrzebuje, dostaniesz błąd o brakującej zależności i test przestanie cokolwiek mówić. Przy 64 modach dojście do jednego pliku zajmuje około sześciu rund. Jeśli obie połówki osobno działają, a razem nie, masz do czynienia z konfliktem - winne są dwa mody, po jednym w każdej połowie.

Gdy crashuje gotowa paczka modów

Paczki są testowane jako całość, więc gdy świeżo zainstalowana paczka się wysypuje, przyczyna leży zwykle w Javie, pamięci, sterownikach albo w modach dodanych samodzielnie.

  • Sprawdź w opisie paczki zalecaną ilość RAM i ustaw co najmniej tyle.
  • Usuń mody dodane do paczki na własną rękę.
  • Jeśli crash pojawił się po aktualizacji paczki, zainstaluj ją od nowa jako osobny profil i przenieś tylko kopię folderu saves.
  • Zajrzyj do zgłoszeń błędów albo na Discorda paczki - większość dużych paczek je ma, a twój błąd mógł już zostać opisany.

Prosząc o pomoc, wklej cały log, a nie zrzut ekranu ostatnich linijek, i napisz, co zmieniło się przed pierwszym crashem. Jeśli dobierasz mody samodzielnie, na naszej liście modów przefiltrujesz je po wersji gry i modloaderze, więc łatwiej trafić od razu we właściwe pliki.

Najczęstsze pytania

Co znaczy exit code 1 w Minecraft?

Że proces Javy zakończył się błędem. To ogólny kod - konkretną przyczynę znajdziesz w crash reporcie albo w logs/latest.log.

Gdzie jest crash report Minecrafta?

W folderze crash-reports wewnątrz .minecraft (%appdata%\.minecraft), a przy CurseForge i Prism - w folderze danej instancji.

Czy reinstalacja Minecrafta albo Javy pomoże?

Rzadko, bo mody i konfiguracja zostają na miejscu. Najpierw uruchom zwykły profil bez modów: jeśli działa, problem leży w modach. Jeśli i on się wysypuje, winna jest Java, sterowniki albo launcher.

Gra crashuje bez crash reportu - co robić?

Otwórz logs/latest.log i szukaj błędów od końca pliku. Jeśli w folderze gry pojawił się plik hs_err_pid, wysypała się sama Java - zacznij od sterownika karty graficznej.