Log Begone — Minecraft のログメッセージをフィルタリングする MOD

Log Begone — Minecraft のログメッセージをフィルタリングする MOD

Log Begone は、コンソールおよび latest.log ファイルから指定した行を取り除く Minecraft 用のユーティリティ MOD です。バニラのゲームは、すべての警告をログファイルに書き込みます。その中には、以前に MOD パックから削除されたコンテンツの名残として残る、欠落した構造物・バイオーム・ブロック・アイテムに関する繰り返しのメッセージも含まれます。この MOD はそうした行を非表示にするため、セッション中もコンソールとログファイルが読みやすいまま保たれます。クライアントと専用サーバーの両方で動作し、フィルタリングは各環境で別々に機能するため、両者間でのバージョン同期は必要ありません。

どのような用途に使われるか

主なシナリオは、一部の MOD やコンテンツを削除した MOD パックです。そうした削除の名残は、"missing entry" や未知のレジストリ識別子に関する同種の警告が何千件も出るという形で現れます。フィルターがないと、ワールド読み込み中にコンソールはこのような行で数百行も連続して埋め尽くされ、latest.log ファイルは1セッションで数十メガバイトにまで膨れ上がります。

もう一つの典型的なケースは、バニラクライアントが改造サーバーへ接続を試みた際のメッセージや、ネットワークチャンネルに関するサービス行です。開いたポートを持つサーバーでは、第三者クライアントによるスキャンのたびにこのようなメッセージが現れ、バックグラウンドのノイズを生み出して、本当の問題に気づきにくくします。

3つ目のシナリオは最適化です。ログが毎分数千行書き込まれていると、ディスクへの書き込み処理やメッセージの整形がリソースの目立つ割合を占めます。フィルターのリストから想定どおりのノイズを取り除けば、これらのリソースをゲームのスレッドに戻すことができます。これは稼働時間の長いサーバーで特に顕著です。

フィルタリングの仕組み

この MOD は、ログイベントが標準出力に届く前にそれを横取りします。メッセージが指定した基準のいずれかに一致すると、それはコンソールにもファイルにも書き込まれません。コマンド、グラフィカルインターフェース、ゲーム内通知は一切なく、すべては単一のテキスト設定ファイルで設定します。

2つの比較モードに対応しています。1つ目は部分文字列検索です。メッセージのテキストにリスト内のいずれかのフレーズが含まれていれば、その行は除外されます。これは繰り返される警告のほとんどに十分です。なぜなら、そのテンプレートには通常、安定した一意の部分が含まれているからです。2つ目のモードは正規表現です。可変要素（数字、識別子、時刻）を考慮する必要があるメッセージには、Java-regex の構文でパターンを指定し、一致すればその行が除外されます。

設定

このファイルは logbegone.json という名前で、初回起動時にゲームプロファイルの config フォルダーに自動的に作成されます。1.0.1 より前のバージョンでは TOML 形式が使われていましたが、NeoForge での TOML のパッケージングとの非互換性のため、作者は GSON ライブラリを使って設定を JSON に移行しました。

ファイルの構造

デフォルトでは、両方のリストに同じ行が含まれています — Disconnecting VANILLA connection attempt と Channels（末尾に空白があり、これは正しい一致のために重要です）。これらの値は、改造されたネットワークプロトコルが有効なサーバーで頻繁に現れるメッセージを取り除きます。

まとめ

Log Begone は、フレーズのリストまたは正規表現を用いて、Minecraft のログファイル内のあらかじめ分かっているノイズを非表示にします。これは従来の意味での最適化 MOD ではありません。ワールドの描画やチャンクの読み込みは変わりませんが、激しいスパムが発生している場合、何千もの繰り返しの行が単にディスクに書き込まれなくなることで、パフォーマンスとログサイズにおける間接的な利益が得られます。

安定した MOD 構成を持つサーバー管理者、コンテンツを削除した後の MOD パック作者、そして後で本当の問題を診断するためにログファイルを読みやすいサイズに抑えたいプレイヤーに適しています。