Log Begone — en mod til filtrering af logmeddelelser i Minecraft

Log Begone — en mod til filtrering af logmeddelelser i Minecraft

Log Begone er en hjælpemod til Minecraft, der fjerner bestemte linjer fra konsollen og filen latest.log. Vanilla-spillet skriver alle advarsler til logfilen, herunder gentagne meddelelser om manglende strukturer, biomer, blokke eller genstande, der er efterladt fra indhold, som tidligere er fjernet fra en modpakke. Denne mod skjuler sådanne linjer, så konsollen og logfilen forbliver læsbare under en session. Den virker både på klienten og på en dedikeret server — filtreringen fungerer separat for hvert miljø, så der kræves ingen versionssynkronisering mellem dem.

Hvilke opgaver bruges den til

Hovedscenariet er modpakker, hvorfra enkelte mods eller indhold er blevet fjernet. Resterne af sådanne fjernelser dukker op som tusindvis af ensartede advarsler om "missing entry" eller en ukendt registreringsidentifikator. Uden et filter oversvømmes konsollen under indlæsning af verdenen af hundredvis af sådanne linjer i træk, og filen latest.log vokser i løbet af en enkelt session til titusindvis af megabyte.

Et andet typisk tilfælde er meddelelser om forsøg fra en vanilla-klient på at oprette forbindelse til en modificeret server eller servicelinjer om netværkskanaler. På en server med en åben port dukker sådanne meddelelser op ved hver scanning fra tredjepartsklienter og skaber baggrundsstøj, der gør det sværere at få øje på reelle problemer.

Det tredje scenarie er optimering. Hvis loggen skrives med tusindvis af linjer i minuttet, optager diskskrivninger og formatering af meddelelser en mærkbar andel af ressourcerne. Ved at fjerne den forventede støj fra filterlisten kan disse ressourcer føres tilbage til spillets tråd — det er især mærkbart på servere med lang oppetid.

Sådan fungerer filtreringen

Moden opfanger loghændelser, allerede inden de når standardoutputtet. Hvis en meddelelse matcher et af de angivne kriterier, skrives den ikke til konsollen og filen. Der er ingen kommandoer, grafisk grænseflade eller notifikationer inde i spillet: alt konfigureres via én enkelt tekstbaseret konfigurationsfil.

Der understøttes to sammenligningstilstande. Den første er delstrengssøgning: hvis meddelelsesteksten indeholder en af fraserne fra listen, skæres linjen fra. Det er nok til de fleste gentagne advarsler, fordi deres skabelon som regel indeholder en stabil, unik del. Den anden tilstand er regulære udtryk: for meddelelser, hvor man skal tage højde for variable elementer (tal, identifikatorer, tid), angives et mønster i Java-regex-syntaks, og et match betyder, at linjen skæres fra.

Konfiguration

Filen hedder logbegone.json og oprettes automatisk i config-mappen i spilprofilen ved første start. I versioner før 1.0.1 blev TOML-formatet brugt, men på grund af inkompatibilitet med TOML-pakningen i NeoForge skiftede forfatteren konfigurationen til JSON via GSON-biblioteket.

Filens struktur

Som standard indeholder begge lister de samme linjer — Disconnecting VANILLA connection attempt og Channels (med et mellemrum til sidst, som er vigtigt for et korrekt match). Disse værdier fjerner meddelelser, der ofte dukker op på servere med en aktiv modificeret netværksprotokol.

Konklusion

Log Begone skjuler på forhånd kendt støj i Minecrafts logfil ved hjælp af en liste over fraser eller regulære udtryk. Det er ikke en optimeringsmod i klassisk forstand: rendering af verden og indlæsning af chunks forbliver de samme, men en indirekte gevinst i ydeevne og logstørrelse ved kraftig spam opnås ved, at tusindvis af gentagne linjer simpelthen ikke skrives til disken.

Den egner sig til serveradministratorer med et stabilt sæt mods, til modpakkeforfattere efter fjernelse af indhold samt til spillere, der ønsker at bringe logfilen ned til en læsbar størrelse for senere at diagnosticere reelle problemer.