Log Begone — mod para filtrar mensagens de log no Minecraft

Log Begone — mod para filtrar mensagens de log no Minecraft

Log Begone é um mod utilitário para Minecraft que remove linhas específicas do console e do arquivo latest.log. O jogo vanilla grava no arquivo de log todos os avisos, incluindo mensagens repetidas sobre estruturas, biomas, blocos ou itens ausentes que restaram de conteúdo removido anteriormente em um modpack. Esse mod oculta essas linhas, de modo que o console e o arquivo de log permaneçam legíveis durante a sessão. Funciona tanto no cliente quanto no servidor dedicado — a filtragem atua de forma independente para cada ambiente, portanto não é necessário sincronizar as versões entre eles.

Para que tarefas é usado

O cenário principal são os modpacks dos quais mods ou conteúdos específicos foram removidos. Os resíduos dessas remoções aparecem na forma de milhares de avisos idênticos sobre "missing entry" ou sobre um identificador de registro desconhecido. Sem um filtro, durante o carregamento do mundo o console é inundado por centenas dessas linhas em sequência, e o arquivo latest.log em uma única sessão cresce até dezenas de megabytes.

Outro caso típico são as mensagens sobre tentativas de conexão de um cliente vanilla a um servidor modificado ou as linhas de serviço sobre canais de rede. Em um servidor com uma porta aberta, essas mensagens aparecem a cada varredura por clientes externos e criam um ruído de fundo que dificulta perceber os problemas reais.

O terceiro cenário é a otimização. Se o log é gravado a milhares de linhas por minuto, as operações de gravação em disco e a formatação das mensagens ocupam uma parcela considerável dos recursos. Ao remover o ruído esperado da lista do filtro, é possível devolver esses recursos ao thread do jogo — isso é especialmente perceptível em servidores com tempo de atividade prolongado.

Como funciona a filtragem

O mod intercepta os eventos de log antes que eles cheguem à saída padrão. Se a mensagem corresponder a um dos critérios definidos, ela não é gravada nem no console nem no arquivo. Não há nenhum comando, interface gráfica ou notificações no jogo: tudo é configurado por meio de um único arquivo de configuração de texto.

São suportados dois modos de comparação. O primeiro é a busca de substring: se no texto da mensagem aparecer qualquer uma das frases da lista, a linha é descartada. Isso basta para a maioria dos avisos repetidos, pois seu modelo geralmente contém uma parte única e estável. O segundo modo são as expressões regulares: para mensagens em que é preciso considerar elementos variáveis (números, identificadores, hora), define-se um padrão na sintaxe Java-regex, e uma correspondência significa o descarte da linha.

Configuração

O arquivo se chama logbegone.json e é criado automaticamente na pasta config do perfil de jogo na primeira inicialização. Nas versões anteriores à 1.0.1 era usado o formato TOML, mas devido à incompatibilidade com o empacotamento de TOML no NeoForge o autor migrou a configuração para JSON por meio da biblioteca GSON.

Estrutura do arquivo

Por padrão, ambas as listas contêm as mesmas linhas — Disconnecting VANILLA connection attempt e Channels (com um espaço no final, importante para a correspondência correta). Esses valores removem mensagens que aparecem com frequência em servidores com um protocolo de rede modificado ativo.

Conclusão

Log Begone oculta o ruído conhecido de antemão no arquivo de log do Minecraft usando uma lista de frases ou de expressões regulares. Não é um mod de otimização no sentido clássico: a renderização do mundo e o carregamento dos chunks permanecem os mesmos, mas o ganho indireto em desempenho e tamanho do log em caso de spam intenso é obtido porque milhares de linhas repetidas simplesmente não são gravadas no disco.

É adequado para administradores de servidores com um conjunto estável de mods, para autores de modpacks após a remoção de conteúdo, e também para jogadores que desejam reduzir o arquivo de log a um tamanho legível para diagnosticar depois problemas reais.