Log Begone — mod do filtrowania komunikatów dziennika w Minecraft

Log Begone — mod do filtrowania komunikatów dziennika w Minecraft

Log Begone to narzędziowy mod do Minecraft, który usuwa określone wiersze z konsoli oraz z pliku latest.log. Wersja waniliowa gry zapisuje do pliku dziennika wszystkie ostrzeżenia, w tym powtarzające się komunikaty o brakujących strukturach, biomach, blokach czy przedmiotach, pozostałe po wcześniej usuniętej zawartości z modpacka. Ten mod ukrywa takie wiersze, dzięki czemu konsola i plik dziennika pozostają czytelne podczas sesji. Działa zarówno po stronie klienta, jak i na dedykowanym serwerze — filtrowanie działa osobno dla każdego środowiska, więc synchronizacja wersji między nimi nie jest potrzebna.

Do jakich zadań się go używa

Główny scenariusz to modpacki, z których usunięto poszczególne mody lub zawartość. Pozostałości po takich usunięciach pojawiają się w postaci tysięcy jednakowych ostrzeżeń o "missing entry" lub nieznanym identyfikatorze rejestru. Bez filtra konsola podczas wczytywania świata zalewana jest setkami takich wierszy z rzędu, a plik latest.log w ciągu jednej sesji rozrasta się do dziesiątek megabajtów.

Inny typowy przypadek to komunikaty o próbach połączenia waniliowego klienta z zmodyfikowanym serwerem lub wiersze serwisowe o kanałach sieciowych. Na serwerze z otwartym portem takie komunikaty pojawiają się przy każdym skanowaniu przez klientów innych firm i tworzą szum tła, przez który trudniej zauważyć rzeczywiste problemy.

Trzeci scenariusz to optymalizacja. Jeśli dziennik jest zapisywany tysiącami wierszy na minutę, operacje zapisu na dysk i formatowanie komunikatów zajmują zauważalną część zasobów. Usuwając oczekiwany szum z listy filtra, można zwrócić te zasoby wątkowi gry — jest to szczególnie widoczne na serwerach o długim czasie pracy.

Jak działa filtrowanie

Mod przechwytuje zdarzenia dziennika jeszcze zanim trafią do standardowego wyjścia. Jeśli komunikat odpowiada jednemu z zadanych kryteriów — nie jest zapisywany w konsoli ani w pliku. Nie ma żadnych komend, interfejsu graficznego ani powiadomień w grze: wszystko konfiguruje się przez jeden plik tekstowy konfiguracji.

Obsługiwane są dwa tryby porównywania. Pierwszy to wyszukiwanie podciągu: jeśli w tekście komunikatu występuje którakolwiek z fraz z listy, wiersz zostaje odcięty. To wystarcza dla większości powtarzających się ostrzeżeń, ponieważ ich szablon zwykle zawiera stabilną, unikalną część. Drugi tryb to wyrażenia regularne: dla komunikatów, w których trzeba uwzględnić zmienne elementy (liczby, identyfikatory, czas), podaje się wzorzec w składni Java-regex, a dopasowanie oznacza odcięcie wiersza.

Konfiguracja

Plik nazywa się logbegone.json i jest tworzony automatycznie w folderze config profilu gry przy pierwszym uruchomieniu. W wersjach do 1.0.1 używano formatu TOML, jednak z powodu niezgodności z pakowaniem TOML w NeoForge autor przeniósł konfigurację na JSON za pomocą biblioteki GSON.

Struktura pliku

Domyślnie obie listy zawierają te same wiersze — Disconnecting VANILLA connection attempt i Channels (ze spacją na końcu, która jest istotna dla poprawnego dopasowania). Te wartości usuwają komunikaty, które często pojawiają się na serwerach z aktywnym zmodyfikowanym protokołem sieciowym.

Podsumowanie

Log Begone ukrywa z góry znany szum w pliku dziennika Minecraft za pomocą listy fraz lub wyrażeń regularnych. Nie jest to mod optymalizacyjny w klasycznym rozumieniu: renderowanie świata i wczytywanie chunków pozostają takie same, ale pośredni zysk w wydajności i rozmiarze dziennika przy silnym spamie osiągany jest dzięki temu, że tysiące powtarzających się wierszy po prostu nie są zapisywane na dysk.

Nadaje się dla administratorów serwerów ze stabilnym zestawem modów, dla autorów modpacków po usunięciu zawartości, a także dla graczy, którzy chcą sprowadzić plik dziennika do czytelnego rozmiaru w celu późniejszego diagnozowania rzeczywistych problemów.