Log Begone — мод для фильтрации лог-сообщений в Minecraft

Log Begone — мод для фильтрации лог-сообщений в Minecraft

Log Begone — это утилитарный мод для Minecraft, который убирает определённые строки из консоли и файла latest.log. Ванильная игра записывает в лог-файл все предупреждения, в том числе повторяющиеся сообщения об отсутствующих структурах, биомах, блоках или предметах, оставшихся от ранее удалённого контента в модпаке. Этот мод скрывает такие строки, поэтому консоль и лог-файл остаются читаемыми в течение сессии. Работает и на клиенте, и на выделенном сервере — фильтрация работает отдельно для каждой среды, поэтому синхронизация версий между ними не нужна.

Для каких задач используется

Основной сценарий — модпаки, из которых удалили отдельные моды или контент. Остатки таких удалений мигрируют в виде тысяч однотипных предупреждений о «missing entry» или о неизвестном идентификаторе реестра. Без фильтра консоль во время загрузки мира заливается сотнями таких строк подряд, а файл latest.log за одну сессию разрастается до десятков мегабайтов.

Другой типичный случай — сообщения о попытках подключения ванильного клиента к модифицированному серверу или служебные строки о сетевых каналах. На сервере с открытым портом такие сообщения появляются при каждом сканировании сторонними клиентами и создают фоновый шум, из-за которого труднее заметить реальные проблемы.

Третий сценарий — оптимизация. Если лог пишется тысячами строк в минуту, операции записи на диск и форматирование сообщений занимают заметную долю ресурсов. Убрав ожидаемый шум из списка фильтра, можно вернуть эти ресурсы под игровой поток — особенно это заметно на серверах с длительным аптаймом.

Как работает фильтрация

Мод перехватывает лог-события ещё до того, как они попадают в стандартный вывод. Если сообщение соответствует одному из заданных критериев — оно не записывается в консоль и в файл. Никаких команд, графического интерфейса или внутриигровых уведомлений нет: всё настраивается через единый текстовый конфиг-файл.

Поддерживаются два режима сравнения. Первый — поиск подстроки: если в тексте сообщения встречается любая из фраз из списка, строка отсекается. Этого достаточно для большинства повторяющихся предупреждений, потому что их шаблон обычно содержит стабильную уникальную часть. Второй режим — регулярные выражения: для сообщений, в которых нужно учесть переменные элементы (числа, идентификаторы, время), задаётся шаблон в синтаксисе Java-regex, и совпадение означает отсев строки.

Конфигурация

Файл называется logbegone.json и создаётся автоматически в папке config игрового профиля при первом запуске. В версиях до 1.0.1 использовался формат TOML, но из-за несовместимости с упаковкой TOML в NeoForge автор перевёл конфиг на JSON через библиотеку GSON.

Структура файла

По умолчанию оба списка содержат одинаковые строки — Disconnecting VANILLA connection attempt и Channels (с пробелом в конце, он важен для корректного совпадения). Эти значения убирают сообщения, которые часто появляются на серверах с активным модифицированным сетевым протоколом.

Вывод

Log Begone скрывает заранее известный шум в лог-файле Minecraft с помощью списка фраз или регулярных выражений. Это не оптимизационный мод в классическом понимании: рендер мира и загрузка чанков остаются теми же, но косвенный выигрыш по производительности и размеру лога при сильном спаме достигается за счёт того, что тысячи повторяющихся строк просто не записываются на диск.

Подходит администраторам серверов со стабильным набором модов, авторам модпаков после удаления контента, а также игрокам, которые хотят свести лог-файл к читаемому размеру для последующей диагностики реальных проблем.