Log Begone — een mod voor het filteren van logberichten in Minecraft

Log Begone — een mod voor het filteren van logberichten in Minecraft

Log Begone is een hulpprogramma-mod voor Minecraft die bepaalde regels uit de console en uit het bestand latest.log verwijdert. Het vanilla-spel schrijft alle waarschuwingen naar het logbestand, waaronder herhaalde berichten over ontbrekende structuren, biomen, blokken of items die zijn overgebleven van inhoud die eerder uit een modpack is verwijderd. Deze mod verbergt zulke regels, zodat de console en het logbestand tijdens een sessie leesbaar blijven. Hij werkt zowel op de client als op een dedicated server — het filteren werkt afzonderlijk voor elke omgeving, dus versiesynchronisatie ertussen is niet nodig.

Voor welke taken wordt hij gebruikt

Het belangrijkste scenario zijn modpacks waaruit afzonderlijke mods of inhoud zijn verwijderd. De restanten van zulke verwijderingen duiken op als duizenden gelijksoortige waarschuwingen over "missing entry" of een onbekende register-identifier. Zonder filter wordt de console tijdens het laden van de wereld overspoeld met honderden van zulke regels achter elkaar, en groeit het bestand latest.log tijdens één sessie aan tot tientallen megabytes.

Een ander typisch geval zijn berichten over pogingen van een vanilla-client om verbinding te maken met een gemodificeerde server, of serviceregels over netwerkkanalen. Op een server met een open poort verschijnen zulke berichten bij elke scan door externe clients en veroorzaken ze achtergrondruis waardoor het lastiger is om echte problemen op te merken.

Het derde scenario is optimalisatie. Als de log met duizenden regels per minuut wordt weggeschreven, nemen schrijfbewerkingen naar de schijf en het formatteren van berichten een merkbaar deel van de bronnen in beslag. Door de verwachte ruis uit de filterlijst te halen, kun je deze bronnen teruggeven aan de spelthread — dit is vooral merkbaar op servers met een lange uptime.

Hoe het filteren werkt

De mod onderschept loggebeurtenissen nog voordat ze de standaarduitvoer bereiken. Als een bericht aan een van de opgegeven criteria voldoet, wordt het niet naar de console en het bestand geschreven. Er zijn geen commando's, grafische interface of in-game meldingen: alles wordt ingesteld via één enkel tekstconfiguratiebestand.

Er worden twee vergelijkingsmodi ondersteund. De eerste is het zoeken naar een deelstring: als er in de berichttekst een van de zinnen uit de lijst voorkomt, wordt de regel afgesneden. Dat is voldoende voor de meeste herhaalde waarschuwingen, omdat hun sjabloon meestal een stabiel, uniek deel bevat. De tweede modus zijn reguliere expressies: voor berichten waarbij rekening moet worden gehouden met variabele elementen (getallen, identifiers, tijd) wordt een patroon opgegeven in de Java-regex-syntaxis, en een match betekent dat de regel wordt afgesneden.

Configuratie

Het bestand heet logbegone.json en wordt bij de eerste start automatisch aangemaakt in de map config van het spelprofiel. In versies vóór 1.0.1 werd het TOML-formaat gebruikt, maar vanwege incompatibiliteit met de TOML-verpakking in NeoForge zette de auteur de configuratie over naar JSON via de GSON-bibliotheek.

Structuur van het bestand

Standaard bevatten beide lijsten dezelfde regels — Disconnecting VANILLA connection attempt en Channels (met een spatie aan het einde, die belangrijk is voor een correcte match). Deze waarden verwijderen berichten die vaak verschijnen op servers met een actief gemodificeerd netwerkprotocol.

Conclusie

Log Begone verbergt vooraf bekende ruis in het logbestand van Minecraft met behulp van een lijst met zinnen of reguliere expressies. Het is geen optimalisatiemod in de klassieke zin: het renderen van de wereld en het laden van chunks blijven hetzelfde, maar een indirecte winst in prestaties en logbestandsgrootte bij hevige spam wordt bereikt doordat duizenden herhaalde regels simpelweg niet naar de schijf worden geschreven.

Hij is geschikt voor serverbeheerders met een stabiele set mods, voor modpack-auteurs na het verwijderen van inhoud, en voor spelers die het logbestand willen terugbrengen tot een leesbare grootte om later echte problemen te kunnen diagnosticeren.