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 за допомогою списку фраз або регулярних виразів. Це не оптимізаційний мод у класичному розумінні: рендер світу і завантаження чанків лишаються тими самими, але опосередкований виграш по продуктивності та розміру лога при сильному спамі досягається за рахунок того, що тисячі повторюваних рядків просто не записуються на диск.

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