Ticking entity i awarie po stronie modów

Błąd "ticking entity" oznacza wyjątek podczas aktualizacji encji, na przykład moba. Podobny błąd "ticking block entity" dotyczy bloku z własnymi danymi, takiego jak maszyna. Przyczyną może być mod, konflikt dodatków, błąd gry lub dane świata. Sam nagłówek raportu nie wystarcza, by wskazać winny mod albo zagwarantować naprawę bez utraty danych.

Jak rozpoznać ten błąd

Gdy serwer się wywala, gra zapisuje crash report. Znajdziesz go w zakładce Pliki, w folderze crash-reports/ (kliknij Pobierz przy najnowszym pliku). W środku poszukaj sekcji:

• -- Entity being ticked --, gdy problem dotyczy encji (moba, przedmiotu, pojazdu),
• -- Block entity being ticked -- (w starszych wersjach -- Tile entity being ticked --), gdy chodzi o blok funkcyjny, np. skrzynię moda albo maszynę.

Ta sekcja jest tuż pod stosem wywołań (stack trace) i zawiera dane obiektu, którego aktualizacja zgłosiła błąd. Poniższy fragment jest przykładem, nie raportem z testu naprawy:

-- Entity being ticked --
    Entity Type: alexsmobs:crocodile (...)
    Entity ID: 18595
    Entity Name: Crocodile
    Entity's Exact location: 2068.07, 10.24, -4058.78

Zapisz typ encji, współrzędne X, Y, Z oraz wymiar świata z raportu. Prefiks alexsmobs wskazuje właściciela typu, ale nie dowodzi, że tylko ten mod spowodował wyjątek. Sprawdź również stos wywołań. Cały raport omawia poradnik Logi i crash reporty.

Prawdziwy raport z kontrolowanego błędu zależności przy starcie Forge. Zrzut pokazuje pobieranie raportu, nie odtworzenie błędu ticking entity ani naprawę świata.

Droga naprawy krok po kroku

Zaczynamy od zachowania danych i oceny raportu, a następnie przechodzimy do bardziej technicznych rozwiązań. Wybór zależy od przyczyny awarii; żaden z poniższych sposobów nie gwarantuje naprawy.

1. Przywróć backup (najszybciej)

Najpierw pobierz obecną zawartość serwera, nawet jeśli nie startuje. Następnie rozważ przywrócenie kopii sprzed awarii w zakładce Backupy. Utracisz wszystkie późniejsze zmiany, nie tylko ostatnie minuty; zakres zależy od wieku kopii. Jeśli przyczyną jest sam kod moda, problem może wrócić również na starszym świecie. Zasady przechowywania i sprawdzania kopii omawiamy w artykule Backup serwera Minecraft.

2. Włącz usuwanie błędnych encji (ostrożnie)

Niektóre wersje Forge i NeoForge mają przełączniki usuwania obiektów, które zgłoszą błąd podczas swojej aktualizacji. Nie jest to automatyczne czyszczenie świata przy starcie. Na przykład Forge 1.20.1 przechwytuje wyjątek podczas ticku encji albo aktualizacji bloku i, po włączeniu odpowiedniej opcji, usuwa ten obiekt zamiast kończyć pracę serwera. To celowe usunięcie obiektu ze świata, więc traktuj tę opcję jak ostateczność. Gdzie szukać ustawienia, zależy od silnika:

• Forge 1.20.1: plik <folder-swiata>/serverconfig/forge-server.toml, klucze removeErroringEntities i removeErroringBlockEntities. Obie opcje domyślnie mają wartość false. Dla innej wersji sprawdź jej wygenerowaną konfigurację.
• NeoForge: sprawdź wygenerowany neoforge-server.toml i dokumentację dokładnej wersji. Lokalizacja ustawień serwerowych zmieniała się między wydaniami; nie zakładaj jednej ścieżki dla wszystkich wersji. Szukaj kluczy removeErroringEntities i removeErroringBlockEntities w istniejącym pliku, nie dopisuj ich do przypadkowej konfiguracji.
• Stary Forge 1.12 i wcześniejszy: plik config/forge.cfg, klucze removeErroringEntities i removeErroringTileEntities.

Po wykonaniu kopii zatrzymaj serwer. Otwórz właściwy plik w zakładce Pliki, zmień tylko potrzebną opcję z false na true, zapisz i uruchom serwer. Opcja może usuwać także inne obiekty, które zgłoszą błąd, nie tylko pierwszy obiekt z raportu. Samo uruchomienie serwera nie dowodzi naprawy: problematyczny obiekt musi zostać wczytany i zaktualizowany. Po sprawdzeniu logów i wyniku próby ponownie zatrzymaj serwer, przywróć false, zapisz i uruchom go jeszcze raz. Jeśli klucza nie ma w konfiguracji danej wersji, nie dopisuj go w ciemno.

Zachowanie i domyślne wartości dla Forge 1.20.1 można sprawdzić w oficjalnej konfiguracji Forge.

Plik forge-server.toml wygenerowany przez Forge 1.20.1-47.4.10 na serwerze testowym. Obie opcje pozostają wyłączone; zrzut pokazuje ich położenie, nie wynik naprawy.

3. Usuń lub cofnij winny mod

Jeśli raport i dokumentacja moda wskazują na błąd konkretnego wydania, sprawdź poprawkę albo zgodną wcześniejszą wersję. Sama nazwa encji nie wystarcza do wyboru pliku do usunięcia. Zatrzymaj serwer i zachowaj kopię przed zmianą plików w mods/. Sprawdź zależności oraz zgodność z loaderem i zapisanym światem. Usunięcie moda może usunąć jego bloki i przedmioty albo uniemożliwić wczytanie świata; testuj zmianę na kopii, nie na jedynym zapisie.

4. Ostateczność: edycja pliku regionu

Ręczna edycja wymaga dopasowania narzędzia do wersji świata i typu danych. W nowszych formatach zwykłe encje mają osobne pliki w entities/, a dane bloków znajdują się w regionach właściwego wymiaru. Usunięcie całego regionu może skasować duży fragment mapy i nie jest równoznaczne z usunięciem jednej encji. Nie podmieniaj plików podczas pracy serwera. Pracuj wyłącznie na kopii; jeśli nie znasz formatu danych, przekaż raport i współrzędne na Discordzie, zanim rozpoczniesz edycję.

Zapobieganie

Wykonaj kopię zapasową przed każdą aktualizacją lub dodaniem moda i sprawdź, czy została ukończona. Przywrócenie cofnie postępy do chwili wykonania kopii, a czas operacji zależy od wielkości danych. Jak zorganizować backupy, tłumaczymy na blogu: Backup serwera Minecraft. Aktualizuj powiązane mody zgodnie z ich zależnościami i testuj każdą zmianę na kopii serwera.

Najczęstsze pytania

Czy stracę cały świat? Sam komunikat tego nie oznacza, ale bez raportu i kopii nie można zagwarantować zakresu naprawy. Zachowaj obecne pliki przed przywracaniem lub usuwaniem obiektów.

Nie mam żadnego backupu, co teraz? Zatrzymaj serwer i pobierz obecną zawartość, aby zachować punkt wyjścia. Dopiero na kopii oceniaj usuwanie encji lub zmianę modów. Na przyszłość ustaw regularne backupy.

Skąd wiem, który mod jest winny? Typ encji wskazuje, do którego projektu należy obiekt, nie kto spowodował wyjątek. Zestaw tę informację ze stosem wywołań, wersjami dodatków i zgłoszeniami autora. Także prefiks minecraft: nie rozstrzyga przyczyny.

Ostatnia aktualizacja: październik 2026.