Minecraft Exit Code 1 – jak znaleźć przyczynę i naprawić błąd uruchamiania

Co oznacza Minecraft Exit Code 1?

Exit Code 1 jest ogólnym kodem niepowodzenia procesu Minecraft Java. Launcher uruchamia grę jako proces JVM, czeka na jego zakończenie i informuje, że proces zwrócił wartość inną niż poprawne zero. Sam numer nie mówi, czy przyczyną był mod, niedostępna klasa, sterownik, zła wersja Java, brak pamięci albo odmowa zapisu. To tak, jak kontrolka „silnik” bez odczytu diagnostycznego: potwierdza problem, lecz nie wybiera części do wymiany.

Poradnik dotyczy przede wszystkim Java Edition, w tym vanilla, Forge, Fabric, NeoForge i modpacków. Bedrock nie uruchamia klienta przez JVM i zwykle nie używa tego samego modelu kodów launchera. Jeżeli Minecraft for Windows zamyka się bez komunikatu, sprawdź aplikację, sklep, system i pomoc dla Bedrock zamiast instalować inną Javę. Jeśli komunikat pojawia się dopiero podczas łączenia z serwerem, najpierw rozróżnij awarię klienta od błędu sieci w poradniku dołączania do serwera Minecraft.

Najcenniejsze dane są zwykle w logs/latest.log aktywnej instancji i — jeśli gra zdążyła go utworzyć — w najnowszym pliku crash-reports. Kod widoczny w launcherze jest ostatnim zdarzeniem. Przyczyna pojawia się wcześniej: pierwsza istotna linia wyjątku, komunikat loadera lub ostatnia sekcja Caused by:. Nie wyszukuj wyłącznie „Exit Code 1 fix”, bo wynik może zalecić Javę dla innej epoki gry albo usunięcie pliku, którego Twój problem nie dotyczy.

Zanim naprawisz: zabezpiecz światy i całą instancję

Zamknij launcher, sprawdź w menedżerze procesów, czy gra nie zapisuje świata, a następnie skopiuj dane poza aktywny katalog. Najważniejszy jest folder światów: zwykle saves w Java. Zachowaj również screenshots, resourcepacks, listę serwerów i konfiguracje modpacka, jeżeli są potrzebne. Nie kopiuj tylko jednego pliku level.dat; kompletny świat obejmuje regiony, wymiary, dane graczy, datapacki i inne podfoldery. Szczegółową rotację oraz próbę odtworzenia opisuje poradnik backupu Minecraft.

Domyślne katalogi Java to %APPDATA%\.minecraft w Windows, ~/Library/Application Support/minecraft w macOS i ~/.minecraft w Linuksie. To tylko punkt startu. Każda instalacja launchera może mieć własny Game Directory, a menedżer modpacków tworzy odrębną instancję. Najpewniejszą lokalizację odczytasz z ustawień profilu albo z początku logu. Jeżeli backupujesz domyślny katalog, a awaria dotyczy instancji w innym miejscu, zachowasz nie te światy i nie ten log.

Utwórz kopię diagnostyczną całej wadliwej instancji i nadaj jej datę, na przykład modpack-2026-08-21-przed-naprawa. Na tej kopii można usuwać mody metodą połówek, podczas gdy oryginał pozostaje dowodem. Zanotuj godzinę ostatniego błędu, wersję gry, wersję loadera, nazwę paczki i ostatnią zmianę: dodany mod, sterownik, shader, nowe argumenty JVM albo aktualizację gry. Bez tego po dziesięciu próbach nie będziesz wiedzieć, która zmiana wpłynęła na wynik.

Drzewo decyzji: naprawa Exit Code 1 bez zgadywania

Najpierw ustal granicę awarii. Jeśli launcher nie otwiera się w ogóle, nie jest to jeszcze crash procesu gry — napraw aplikację launcher, logowanie lub usługi systemu. Jeśli po „Graj” pojawia się okno i znika, szukaj logu gry. Jeśli menu działa, lecz crash następuje przy wejściu do jednego świata, nie reinstaluj launchera: sklonuj świat i sprawdź datapacki, encje albo mod związany z zapisem. Jeśli każdy świat działa do włączenia shaderów, warstwa renderowania jest znacznie bardziej prawdopodobna niż konto Microsoft.

To drzewo zapobiega najczęstszemu błędowi: jednoczesnemu przeinstalowaniu Javy, sterownika, launchera i wszystkich modów. Taki „fix” może uruchomić grę, ale nie wiadomo dlaczego, a przy następnej aktualizacji problem wraca. Kontrolowany eksperyment zmienia jedną zmienną. Po każdym starcie sprawdź, czy powstał nowy latest.log, zanotuj wynik i zamknij grę normalnie, jeśli działa.

Czysty profil tej samej wersji: test rozstrzygający

Minecraft Help zaleca utworzenie nowej instalacji, gdy gra przestaje uruchamiać się z istniejącego profilu. W oficjalnym launcherze wybierz Java Edition, zakładkę Installations i New installation. Ustaw dokładnie tę samą wersję, na której występuje błąd, ale użyj nowego, pustego Game Directory. Nie dodawaj loadera, shaderów, resource packów, własnej Javy ani argumentów JVM. Uruchom do menu, utwórz tymczasowy świat i zamknij grę. Oficjalna procedura jest opisana w instrukcji czystej instalacji Minecraft Java ↗ (otwiera w nowej karcie).

Jeśli czysty profil działa, konto, podstawowe pliki tej wersji, dołączony runtime i podstawowa ścieżka renderowania są zdolne uruchomić grę. Nie dowodzi to, że każdy sterownik jest idealny, ale mocno zawęża problem do wcześniejszej instancji: loadera, moda, konfiguracji, argumentów JVM, shaderów albo uszkodzonego pliku. Nie kopiuj całego starego katalogu do nowego. Najpierw zainstaluj zgodny loader z oficjalnego źródła, sprawdź start, potem przywracaj manifest paczki lub komponenty partiami.

Jeśli czysty profil upada, uruchom jeszcze najnowsze wspierane vanilla dostarczane przez launcher. Gdy tylko jedna stara wersja nie działa, porównaj wymagane runtime i sterowniki z jej epoką. Gdy żadna wersja nie działa, sprawdź wolny dysk, katalog tymczasowy, aktualizacje systemu, oficjalny runtime, sterownik GPU i oprogramowanie wstrzykujące overlay. Użyj funkcji naprawy/reinstalacji launchera dopiero po zabezpieczeniu katalogów; nie musisz usuwać światów, aby pobrać czyste biblioteki do osobnego Game Directory.

Jak znaleźć i czytać latest.log oraz crash-report?

Otwórz aktywny Game Directory, potem logs/latest.log. W crash-reports wybierz najnowszy plik tekstowy odpowiadający godzinie awarii. Crash-report powstaje tylko wtedy, gdy mechanizm gry zdąży przechwycić wyjątek; bardzo wczesny błąd JVM, natywny sterownik lub zatrzymanie procesu może go nie wygenerować. Brak raportu nie jest więc wskazówką, aby usuwać folder. Sprawdź latest.log, log launchera i ewentualny plik błędu JVM o nazwie zbliżonej do hs_err_pid1234.log.

Zacznij od dołu latest.log, ale nie zatrzymuj się na ostatniej linii „process exited”. Cofnij się do pierwszego ERROR, FATAL, nazwy wyjątku i łańcucha Caused by:. W Javie wyjątek jest często opakowywany kilka razy. Najbardziej zewnętrzny mówi „nie udało się uruchomić”, a najgłębsza przyczyna mówi „brakuje klasy biblioteki X” albo „mod Y wymaga wersji Z”. Zapisz 30–100 linii wokół wyjątku, a nie zrzut ekranu dwóch czerwonych wierszy.

Crash-report zaczyna się opisem i stack trace, dalej zawiera system details: wersję gry, Java, pamięć, GPU, loader oraz listę modów. Dokumentacja Fabric wyjaśnia lokalizacje i znaczenie sekcji w przewodniku po crash-reportach ↗ (otwiera w nowej karcie). Nazwa moda wysoko w stosie jest tropem, nie zawsze winowajcą: mod A może wywołać kod biblioteki B, która została zepsuta przez konflikt C. Najpierw sprawdź wymagania i znane błędy, dopiero potem zgłaszaj autorowi.

Najczęstsze sygnatury błędów i ich znaczenie

Tekst przed pierwszym wyjątkiem daje kontekst, a sama nazwa wyjątku wybiera gałąź diagnostyki. Nie tłumacz każdej linii stack trace osobno. Najpierw rozpoznaj rodzinę problemu. Poniższe przykłady są wzorcami, nie obietnicą, że każda linia zawierająca te słowa ma identyczną przyczynę.

Wyszukując błąd, połącz unikalny wyjątek z wersją Minecraft, loaderem i nazwą modu. Nie wklejaj całego logu do wyszukiwarki, bo może zawierać prywatne dane. Ostrzeżenia WARN nie muszą zatrzymywać gry; ważny jest punkt, po którym start nie postępuje. Jeżeli log kończy się podczas generowania tekstur, a nie ma wyjątku, sprawdź czy proces nie został zabity przez system z powodu pamięci lub ochrony.

Java 25, starsze wersje i runtime launchera

Oficjalny Minecraft Launcher pobiera środowisko odpowiednie dla wybranej wersji i zwykle nie wymaga systemowej instalacji Javy. To najbezpieczniejszy punkt odniesienia dla vanilla. Problem zaczyna się, gdy użytkownik ustawi w profilu własny Java Executable, skopiuje argumenty z poradnika dla innej wersji albo zewnętrzny launcher wybierze pierwsze java z PATH. W logu i crash-reporcie znajdź wiersze Java Version, producenta oraz ścieżkę procesu. Nie zakładaj wersji po wyniku polecenia w innym terminalu.

Od Minecraft Java 26.1 gra wymaga Java 25, a dołączona dystrybucja to Microsoft Build of OpenJDK 25. Changelog podaje też domyślną alokację 4 GB i ZGC na zgodnych urządzeniach. Oficjalne szczegóły są w informacjach o Java 26.1 ↗ (otwiera w nowej karcie). Modpack dla 1.20.1 nie staje się dzięki temu paczką Java 25: starsze wydania i ich loadery powstały dla wcześniejszych runtime. Każda instalacja powinna mieć własne wymaganie, nie jeden globalny plik wykonywalny.

Gdy UnsupportedClassVersionError wskazuje nowszy bytecode, rozwiązaniem jest zgodny zestaw, nie edycja pliku JAR. Gdy mod wymaga niższej/nowszej Java niż sama gra, sprawdź, czy pobrałeś jego wariant dla tej wersji. Javę pobieraj ze źródła wskazanego przez oficjalną dokumentację loadera lub zaufanego dostawcę OpenJDK. Nie używaj wyskakującej reklamy „Java fixer” i nie podmieniaj DLL w folderze systemowym.

Forge, Fabric i NeoForge: zgodność czterech wymiarów

Mod musi pasować jednocześnie do wersji Minecraft, loadera, strony klient/serwer i zależności. Plik dla Fabric nie staje się modem Forge po przeniesieniu do tego samego folderu. NeoForge i Forge mają wspólne korzenie, ale są odrębnymi loaderami; wybierz wariant zadeklarowany przez autora. Numer „1.21” w nazwie nie zawsze obejmuje 1.21.1, 1.21.4 i późniejsze wydania. Pobieraj ze strony projektu/autorów, czytaj nazwę pliku i stronę wersji, a nie tylko pierwszy przycisk Download.

Loader sam często podaje czytelny komunikat: mod wymaga Fabric API, konkretnych wersji Forge, NeoForge, Architectury lub biblioteki konfiguracji. Przeczytaj całą listę wymagań. Dodanie najnowszej biblioteki może być równie błędne jak jej brak, jeśli mod deklaruje zakres. Dokumentacja Forge pokazuje, że plik moda może definiować obowiązkową zależność, zakres wersji, kolejność i stronę, a niespełniona cecha blokuje ładowanie — zobacz opis zależności modów Forge ↗ (otwiera w nowej karcie).

Najpierw uruchom czyste vanilla, potem sam loader bez modów. Jeśli loader bez modów upada, sprawdź zgodność jego instalatora, wersję Java i Game Directory. Jeśli działa, przywróć dokładny manifest modpacka. Nie aktualizuj losowo pięciu modów „bo są nowe”; modpack jest przetestowanym zestawem wersji. Jeżeli samodzielnie budujesz paczkę, dodawaj komponenty małymi partiami i zachowuj działający punkt. Instrukcja instalowania modów Minecraft Java pomaga rozróżnić plik klientowy, serwerowy i loader.

Brakujące zależności, konflikty mixin i zła strona moda

NoClassDefFoundError i ClassNotFoundException mówią, że w czasie wykonania nie znaleziono oczekiwanej klasy. Nazwa pakietu często wskazuje bibliotekę, ale nie pobieraj pojedynczej klasy. Sprawdź stronę moda: wymagane projekty, minimalne/maksymalne wersje i loader. Plik mógł zostać pobrany w wariancie NeoForge zamiast Fabric albo pochodzić z klienta i trafić na serwer. Przywrócenie zgodnej paczki jest bezpieczniejsze niż szukanie klasy na forum.

Mixiny zmieniają kod Minecrafta podczas ładowania. MixinApplyError, InvalidMixinException lub komunikat o nieznanym celu może oznaczać mod dla innej mapy wersji, konflikt dwóch modyfikacji albo brak biblioteki. W stack trace szukaj identyfikatora mixina, nazwy moda i pierwszego Caused by. Wyjmij podejrzany mod razem z dodatkami, które go wymagają, na kopii instancji. Jeżeli startuje, sprawdź changelog i tracker obu projektów; nie oznacza to jeszcze, że pierwszy nazwany mod jest wyłącznie winny.

Błąd strony pojawia się, gdy mod zawierający kod tylko dla klienta trafia na serwer lub odwrotnie. Nazwy takie jak net.minecraft.client w crashu dedykowanego serwera są ważnym tropem. Część modów jest wymagana po obu stronach, część tylko po stronie klienta, a plugin serwera nie jest modem klienta. Ułóż dwie jawne listy zamiast kopiować cały folder mods. Na serwerze czytaj jego własny log i crash-report; kod z launchera gracza nie opisuje procesu serwera.

RAM, Xmx i argumenty JVM: kiedy pamięć jest naprawdę winna

Zwiększenie RAM ma sens, gdy log pokazuje OutOfMemoryError, ciągłe problemy garbage collectora albo paczka ma udokumentowane wyższe wymaganie. Sam Exit Code 1 nie jest dowodem braku pamięci. Oficjalna Java 26.1 zwiększyła domyślną alokację do 4 GB na zgodnych urządzeniach, ale komputer z małą ilością fizycznego RAM potrzebuje miejsca także dla systemu, sterownika i launchera. Ustawienie -Xmx16G na komputerze z 16 GB może pogorszyć sytuację lub dać Could not reserve enough space.

Na czystym profilu usuń własne argumenty i pozwól launcherowi ustawić wartości domyślne. Dla modpacka zacznij od zaleceń jego autora i zwiększaj umiarkowanie, obserwując użycie. Nie kopiuj kilkunastu flag garbage collectora z filmu dla Java 8 do Java 25. Flagi mogą być usunięte, ignorowane albo sprzeczne z domyślnym ZGC. Nie ustawiaj -Xms równego całej fizycznej pamięci. Zamknij przeglądarkę i inne gry podczas testu, ale nie uznawaj tego za trwałą naprawę wycieku w modzie.

Jeżeli crash występuje tylko w jednym miejscu świata, pamięć może być skutkiem uszkodzonego chunka, ogromnej liczby encji lub moda generującego dane. Testuj kopię świata i obserwuj log przed OOM. Nie zapisuj wielokrotnie oryginału w różnych wersjach. Gdy system zabija proces bez Java OOM, sprawdź dziennik systemowy i pamięć wirtualną. Serwer i klient to oddzielne procesy; dodanie RAM klientowi nie naprawi braku pamięci hostingu.

Sterownik GPU, OpenGL/Vulkan, shadery i overlay

Błędy GLFW, OpenGL, Vulkan albo natywne awarie w bibliotece sterownika kierują uwagę na grafikę. Najpierw uruchom czyste vanilla bez shaderów, paczki HD i modów renderujących. Na laptopie sprawdź, której karty używa proces, ale nie wymuszaj dedykowanej karty kilkoma narzędziami równocześnie. Java 26.2 ma eksperymentalny backend Vulkan i pokazuje wybrane API w F3; na niewspieranym sprzęcie używa fallbacku OpenGL. Przy awarii Vulkan wróć do domyślnego/stabilnego API przed zmianą reszty profilu.

Zaktualizuj system, a sterownik pobierz przez Windows Update lub bezpośrednio z oficjalnej strony producenta GPU. Microsoft zaleca Windows Update, a gdy nie znajduje właściwego sterownika — witrynę producenta; zobacz instrukcję aktualizacji sterowników ↗ (otwiera w nowej karcie). Nie używaj „driver boosterów” z reklam ani archiwum losowych DLL. Po instalacji zrestartuj system i wykonaj test na tym samym czystym profilu.

Overlay Discord, nagrywanie, licznik FPS, monitoring GPU, filtry obrazu i nakładka producenta mogą wstrzykiwać kod do procesu. Wyłącz je pojedynczo na czas testu; zamknięcie okna nie zawsze wyłącza usługę w tle. Jeśli hs_err_pid wskazuje „Problematic frame” w module nakładki, masz konkretny trop. Potem zaktualizuj lub skonfiguruj tę aplikację, zamiast pozostawiać wyłączone wszystkie zabezpieczenia. Shadery dobierz do wersji moda renderującego i gry; paczka działająca na poprzednim wydaniu nie gwarantuje zgodności po aktualizacji.

Uprawnienia, antywirus, synchronizacja i brak miejsca

AccessDeniedException, Permission denied, nieudane utworzenie katalogu lub pobranie biblioteki wskazują dostęp do plików. Sprawdź, czy Game Directory znajduje się w katalogu, do którego Twoje konto może pisać, czy nie jest tylko do odczytu i czy drugi proces nie trzyma pliku. Nie uruchamiaj launchera stale jako administrator — maskuje problem i zwiększa skutki ewentualnego złośliwego moda. Utwórz pusty katalog w zwykłych dokumentach użytkownika i użyj go do czystego testu.

Synchronizacja chmurowa może blokować lub cofać pliki, gdy gra zapisuje świat. Na próbę użyj lokalnego katalogu poza folderem aktywnie synchronizowanym, ale nie wyłączaj usługi przez usuwanie danych online. Antywirus może poddać nowy plik kwarantannie. Sprawdź historię ochrony, zweryfikuj źródło pliku i dodaj minimalny wyjątek tylko wtedy, gdy masz dowód fałszywego alarmu. Nie wyłączaj ochrony w całym systemie i nie przywracaj pliku pobranego z nieznanej strony.

Zostaw zapas wolnego miejsca na biblioteki, logi, rozpakowanie aktualizacji i zapis świata. No space left on device może oznaczać pełny wolumin, limit konta albo brak inode w systemie uniksowym. Usuń bezpieczne pliki tymczasowe lub przenieś stare backupy na drugi nośnik po sprawdzeniu, ale nie kasuj jedynej kopii świata. Sprawdź poprawność daty i czasu systemu, bo błędny zegar potrafi zakłócić uwierzytelnienie i bezpieczne pobieranie. Jeśli dysk zgłasza błędy, najpierw zabezpiecz dane, a dopiero potem naprawiaj instalację.

Modpack: jak znaleźć wadliwy mod metodą połówek

Najpierw odtwórz oficjalny manifest paczki. Jeśli modpack działał przed ręczną aktualizacją, przywrócenie jego dokładnej wersji jest szybsze niż test setek plików. Metodę połówek stosuj na kopii dopiero wtedy, gdy paczka jest własna albo musisz znaleźć konflikt. Zachowaj osobno mods, config, defaultconfigs i manifest. Nie testuj na jedynym świecie; uruchamiaj menu lub tymczasową mapę.

1. Potwierdź, że sam loader bez modów startuje na tej wersji Minecraft i Java.
2. Podziel mody na dwie grupy, zachowując wymagane biblioteki razem z modami zależnymi.
3. Uruchom pierwszą grupę. Jeśli crash wraca, podejrzany jest w niej; jeśli nie, testuj drugą.
4. Dziel wadliwą grupę ponownie, aż zostanie mały zestaw. Po każdym teście zachowaj jego latest.log.
5. Sprawdź pary: mod może działać sam, a upadać dopiero z drugim modem lub konkretną konfiguracją.
6. Potwierdź wynik, przywracając podejrzany komponent do ostatniego działającego zestawu.

Biblioteka używana przez wiele modów wymaga ostrożności: jej usunięcie spowoduje dziesiątki wtórnych braków i nie wskaże pierwotnego konfliktu. Zamiast przenosić ją samą, grupuj zależności na podstawie komunikatów loadera. Mody wydajnościowe i renderujące testuj wraz z shaderami osobno. Mody generacji świata mogą zapisywać dane, więc wejście do oryginalnej mapy bez nich grozi utratą bloków; sprawdzaj menu albo kopię. Po znalezieniu konfliktu wybierz zgodne wersje, zgłoś pełny log autorom lub usuń jedną funkcję — nie edytuj JAR-a.

Czego nie robić przy Exit Code 1?

Nie usuwaj całego .minecraft przed backupem. Taki katalog zawiera światy, zrzuty ekranu i dowody. Nowy Game Directory daje ten sam test czystości bez destrukcji. Nie pobieraj pojedynczej DLL, klasy Java ani „crash fixera” ze strony zbierającej ruch na nazwach błędów. Biblioteki powinny pochodzić z oficjalnego launchera, loadera, moda, systemu lub producenta sterownika. Nie wyłączaj na stałe antywirusa i zapory.

Nie ustawiaj wszystkich profili na najnowszą Javę. Java 25 jest poprawna dla 26.1+, ale nie jest automatycznym runtime dla starego Forge 1.12.2 czy paczki 1.20.1. Nie kopiuj argumentów JVM bez rozumienia i nie przydzielaj całego RAM-u. Nie mieszaj Fabric, Forge i NeoForge. Nie aktualizuj tylko połowy gotowego modpacka, jeśli autor dostarcza wspólny manifest. Nie otwieraj ważnego świata na kolejnych wersjach bez kopii, bo poprawny start nie gwarantuje poprawnego zapisu danych modów.

Nie publikuj logu bez sprawdzenia prywatnych danych i nie wysyłaj hasła osobie oferującej pomoc. Zdalny pulpit daje kontrolę nad komputerem; większość diagnoz wymaga tylko tekstu logu. Nie zgłaszaj „Exit Code 1” autorowi moda bez wersji i stack trace — nie ma z czego odtworzyć problemu. Nie traktuj pierwszego moda wymienionego w stosie jako winnego bez testu. I nie zmieniaj dziesięciu rzeczy przed jednym uruchomieniem, bo utracisz informację ważniejszą niż szybki przypadkowy start.

Jak przygotować dobry pakiet danych do uzyskania pomocy?

Jeśli kontrolowana procedura nie wskazuje naprawy, przygotuj materiał pozwalający innej osobie odtworzyć awarię. Podaj system, wersję gry, launcher, Game Directory (bez prywatnej nazwy użytkownika), wersję Java odczytaną z logu, loader i jego wersję, nazwę modpacka, ilość RAM oraz kartę graficzną. Napisz, czy czysty profil tej samej wersji działa, w którym momencie następuje crash i co zmieniło się przed pierwszym wystąpieniem.

Log udostępnij jako tekst lub link z zaufanego serwisu, nie jako serię zdjęć monitora. Fabric dokumentuje, że najnowszy log znajduje się w folderze logs i nazywa zwykle latest.log; zobacz instrukcję udostępniania logów ↗ (otwiera w nowej karcie). Na trackerze moda użyj jego szablonu zgłoszenia i sprawdź duplikaty. Nie wklejaj 300 modów w opis, jeśli można dołączyć manifest.

Po naprawie wykonaj trzy testy: start do menu, utworzenie i ponowne otwarcie świata testowego, a następnie otwarcie kopii właściwego świata. Zachowaj działający manifest oraz log i opisz przyczynę jednym zdaniem, na przykład „mod X dla Fabric trafił do NeoForge” albo „profil 26.1 wskazywał Java 21 zamiast dołączonej Java 25”. Dzięki temu następna aktualizacja będzie świadomą zmianą, a nie kolejną rundą losowych fixów. Jeżeli szukasz serwera zgodnego z naprawionym klientem, porównaj serwery modowane lub wszystkie serwery Java i przed wejściem sprawdź wymagany zestaw.