Log Begone — mod per filtrare i messaggi di log in Minecraft

Log Begone — mod per filtrare i messaggi di log in Minecraft

Log Begone è un mod di utilità per Minecraft che rimuove righe specifiche dalla console e dal file latest.log. Il gioco vanilla scrive nel file di log tutti gli avvisi, comprese le segnalazioni ripetute su strutture, biomi, blocchi o oggetti mancanti rimasti da contenuti rimossi in precedenza in un modpack. Questo mod nasconde tali righe, così la console e il file di log restano leggibili durante la sessione. Funziona sia sul client sia sul server dedicato — il filtraggio agisce in modo indipendente per ciascun ambiente, quindi non è necessaria alcuna sincronizzazione delle versioni tra loro.

Per quali compiti si usa

Lo scenario principale sono i modpack da cui sono stati rimossi singoli mod o contenuti. I residui di tali rimozioni si manifestano sotto forma di migliaia di avvisi identici su "missing entry" o su un identificatore di registro sconosciuto. Senza un filtro, durante il caricamento del mondo la console viene inondata da centinaia di righe del genere di fila, e il file latest.log in una sola sessione cresce fino a decine di megabyte.

Un altro caso tipico sono i messaggi sui tentativi di connessione di un client vanilla a un server modificato o le righe di servizio sui canali di rete. Su un server con una porta aperta, tali messaggi compaiono a ogni scansione da parte di client esterni e creano un rumore di fondo che rende più difficile notare i problemi reali.

Il terzo scenario è l'ottimizzazione. Se il log viene scritto a migliaia di righe al minuto, le operazioni di scrittura su disco e la formattazione dei messaggi occupano una quota significativa di risorse. Rimuovendo il rumore previsto dall'elenco del filtro, è possibile restituire queste risorse al flusso di gioco — ciò è particolarmente evidente sui server con un uptime prolungato.

Come funziona il filtraggio

Il mod intercetta gli eventi di log prima che arrivino all'output standard. Se il messaggio corrisponde a uno dei criteri impostati, non viene scritto né sulla console né sul file. Non ci sono comandi, interfaccia grafica o notifiche di gioco: tutto si configura tramite un unico file di configurazione testuale.

Sono supportate due modalità di confronto. La prima è la ricerca di una sottostringa: se nel testo del messaggio compare una qualsiasi delle frasi dell'elenco, la riga viene scartata. Questo basta per la maggior parte degli avvisi ripetuti, perché il loro modello contiene di solito una parte unica e stabile. La seconda modalità sono le espressioni regolari: per i messaggi in cui occorre tenere conto di elementi variabili (numeri, identificatori, orari), si imposta un modello nella sintassi Java-regex, e la corrispondenza significa lo scarto della riga.

Configurazione

Il file si chiama logbegone.json e viene creato automaticamente nella cartella config del profilo di gioco al primo avvio. Nelle versioni precedenti alla 1.0.1 si usava il formato TOML, ma a causa dell'incompatibilità con il packaging di TOML in NeoForge l'autore ha convertito la configurazione in JSON tramite la libreria GSON.

Struttura del file

Per impostazione predefinita entrambi gli elenchi contengono le stesse righe — Disconnecting VANILLA connection attempt e Channels (con uno spazio alla fine, importante per la corrispondenza corretta). Questi valori rimuovono i messaggi che compaiono spesso sui server con un protocollo di rete modificato attivo.

Conclusione

Log Begone nasconde il rumore già noto nel file di log di Minecraft tramite un elenco di frasi o di espressioni regolari. Non è un mod di ottimizzazione nel senso classico: il rendering del mondo e il caricamento dei chunk restano gli stessi, ma il vantaggio indiretto in prestazioni e dimensione del log in caso di spam intenso si ottiene perché migliaia di righe ripetute semplicemente non vengono scritte su disco.

È adatto agli amministratori di server con un set di mod stabile, agli autori di modpack dopo la rimozione di contenuti, e anche ai giocatori che vogliono ridurre il file di log a una dimensione leggibile per la successiva diagnosi di problemi reali.