Better Ping Display [Fabric] — Minecraft Java Edition 1.15.2 - 1.21.11+

Minecraft の標準インターフェースは、プレイヤーリストのメニュー（TAB キー）でプレイヤーの接続遅延を、5 本の縦棒からなるグラフィックアイコンとして表示します。同じアイコンが 80 ミリ秒の遅延にも 140 ミリ秒の遅延にも対応しうるため、この方式では接続の安定性に関する正確な情報が得られません。競技性の高いゲームプレイ、PvP の戦闘、あるいは大規模なゲームサーバーの管理においては、正確な ping の数値が極めて重要です。Better Ping Display [Fabric] という改造は、抽象的なグラフィックの棒を、ミリ秒単位の正確な数値の遅延でプレイヤーリストのメニュー内に直接置き換えることで、この問題を解決します。

技術的な動作原理と標準的な遅延描画の制限

ping に関する情報を伝えるために、Minecraft サーバーはプレイヤーリストの更新パケットを送信します（現代のバージョンのゲームでは ClientboundPlayerInfoUpdatePacket パケットがこれを担当します）。パケット内の各エントリには、ミリ秒で表される整数の遅延パラメーター（latency）が含まれています。ゲームのクライアント側はこのデータを受け取り、PlayerInfo オブジェクト（初期のバージョンでは NetworkPlayerInfo として知られる）のプロパティとしてメモリに保存します。

画面上にプレイヤーリストを描画する際、バニラのインターフェースクラス PlayerListHud（Yarn マッピングでは PlayerTabOverlay）は、接続中のすべてのユーザーを走査し、遅延レベルを判定します。アイコンの表示は内部メソッド renderLatencyIcon（または renderPingIcon）が担当します。このメソッドはミリ秒の整数を固定のしきい値と比較します：

·        0 未満の値は接続なしのアイコン（赤い×印）を表示します。

·        150 ミリ秒未満の値は最大の 5 本の棒に対応します。

·        150 から 299 ミリ秒の範囲は 4 本の棒を表示します。

·        300 から 599 ミリ秒の範囲は 3 本の棒を表示します。

·        600 から 999 ミリ秒の範囲は 2 本の棒を表示します。

·        1000 ミリ秒以上の遅延は 1 本の棒を表示します。

このように、正確な数値は画面に出力される直前に破棄され、その代わりにテクスチャファイル icons.png から対応するスプライトが描画されます。

Better Ping Display は Mixin システムを用いてこの処理に変更を加えます。インジェクションクラスは、各プレイヤーの行を描画する時点で PlayerListHud の動作を変更します。この改造はグラフィックの棒を描画する呼び出しを横取りし、その実行をブロックします（または設定に応じて並行して実行します）。その代わりに、PlayerInfo オブジェクトを介して正確な latency の値を取得する呼び出しが実行されます。さらに mod はこの数値をクライアントのテキストレンダラー Font に渡し、設定されたスタイルとインターフェース要素の配置を考慮しながら、文字を画面上に動的に描画します。

主な機能：数値表示、カラースケール、グラフィックの棒

この mod は、以下の機能によってネットワーク統計インターフェースの情報量を拡張します：

·        リアルタイムの数値指標：ミリ秒単位の正確な遅延値を表示します。プレイヤーは、カーソルを合わせたりチャットに診断コマンドを入力したりすることなく、各参加者の実際の接続状態を確認できます。

·        自動カラーマーキング：この改造はデフォルトで、接続の品質に応じて ping のテキストを色付けします。低い遅延（100 ミリ秒未満）は緑色でハイライトされ、中程度（100 から 299 ミリ秒）は黄色またはオレンジ色を帯び、高い遅延（300 ミリ秒以上）は赤色に着色されます。これにより、接続が不安定なプレイヤーを瞬時に見つけ出すことができます。

·        組み合わせ表示モード：ユーザーは、数値とオリジナルのバニラ ping バーを同時に表示するように設定できます。この場合、テキストはグラフィックアイコンの左側に描画され、Minecraft のおなじみの視覚スタイルが保たれます。

·        クライアントアーキテクチャ：この改造は純粋にクライアント側で動作します。サーバーへのインストールを必要とせず、サーバーに追加のリクエストを送信しません。mod は、Minecraft サーバーがデフォルトで接続中のすべてのクライアントに送信するトラフィック情報のみを読み取ります。これにより、Better Ping Display は、公式の Realms サーバーや改造非対応の公開サーバーを含む、あらゆるサーバーで動作します。

設定、互換性、エコシステム

表示パラメーターの設定は、ゲームの初回起動後に config ディレクトリに自動的に作成される betterpingdisplay.json ファイルを編集することで行います。ファイルには次の設定が含まれます：

·        autoColorPingText – 論理フラグ（true/false）。値が true の場合、ping の色は接続速度に応じて緑から赤へ自動的に変化します。false が指定されると、色は静的になり、次のパラメーターによって決まります。

·        pingTextColor – 16 進数のカラーコードを設定するためのテキストフィールド（例えば、明るい灰色には #A0A0A0）。この色は、自動カラーマーキングが無効の場合にのみ使用されます。

·        renderPingBars – 数値指標の隣に標準のバニラ遅延バーを描画するかどうかを制御する論理フラグ。

·        pingTextFormatString – テキストの書式設定文字列。デフォルトでは %dms が設定されており、%d という記号は必須の技術的マーカーで、描画時に現在の遅延のミリ秒数に置き換えられます。

mod のバージョン 1.2.0 以降では、ゲームメニュー内で直接設定を行えるグラフィカルインターフェースのサポートが追加されました。mod 一覧でビジュアルな設定メニューにアクセスするには、2 つの追加の補助コンポーネントをインストールする必要があります：YetAnotherConfigLib (YACL) ライブラリと Mod Menu という mod です。これらが存在すると、ゲーム内に Better Ping Display のパラメーターを変更するためのスイッチとスライダーを備えた便利なウィンドウが表示されます。

この改造は、ほとんどのクライアント最適化 mod（Sodium、Lithium、FerriteCore など）やグラフィック強化 mod（Iris Shaders）と互換性があります。ネットワークパケットの構造に影響を与えず、クライアント上のローカル描画段階のみを変更するため、プレイヤーリスト用のカスタムプラグインを備えたサーバーでのプレイ中に競合を引き起こしません。

結論

Better Ping Display [Fabric] は、Minecraft の標準プレイヤーリストの本質的な欠点を修正する、コンパクトで効果的なクライアント改造です。Numeral Ping や Ping Display のような類似の解決策とは異なり、この mod はゲーム内で直接パラメーターを設定するための YACL ライブラリとのシンプルな統合を備え、バニラの遅延アイコンを保持することができます。主な制限は、数値の更新頻度がサーバー自体の設定に依存することです（デフォルトでは Minecraft サーバーは数秒に一度 ping 統計の更新を送信するため、遅延の瞬間的な変動はすぐには表示されません）。この mod は、システムに余計な負荷をかけずにネットワークパラメーターを明確に把握する必要があるネットワークモードのプレイヤーやサーバー管理者に最適です。