Paginated Advancements & Custom Frames — Minecraft Java Edition 1.18.1 - 26.1+

バニラの進捗インターフェースはタブの表示を制限しています。標準のウィンドウは幅と高さが固定されており、6 つのタブ分しか想定されていません。各大型 Mod が独自の進行ブランチを追加するような大規模な Mod パックを導入すると、新しいタブが画面の端からはみ出したり、互いに重なり合ったり、あるいはインターフェースから完全に消えたりし始めます。Paginated Advancements & Custom Frames という Mod は、進捗メニューの標準ウィンドウを拡張し、ページ式ナビゲーション、優先ブランチを固定するシステム、内蔵のデバッグツール、そしてリソースパックやデータパックによるアイコン用の完全に新しいフレームのサポートを追加します。

技術的な動作原理とバニラインターフェースの制限の解決

バニラのクラス AdvancementsScreen は、進捗ウィンドウの描画にハードコードされた座標を使用しています（サイズは 252 × 140 ピクセル）。タブのグリッドや背景の描画といった操作要素は固定のウィンドウサイズに紐づけられており、高解像度モニターに合わせてスケーリングすることが不可能です。クラス AdvancementTab も、メインフレームの周囲に沿ってタブアイコンを描画するための厳格な境界を持っています。

Paginated Advancements & Custom Frames は、クラス MixinAdvancementsScreen および MixinAdvancementTab への Mixin インジェクションを用いて、クライアントのグラフィカルインターフェースの描画ロジックに直接変更を加えます。ハードコードされた定数を使用する代わりに、この Mod はインターフェースの初期化を傍受し、ゲームウィンドウの現在のサイズを読み取ります。このデータに基づいて、進捗フレームの最適なサイズが計算され、適応的に拡張して画面の大部分を占めるようになります。

システムは、登録されたすべてのタブを自動的に個別のページにグループ化します（ページネーション）。アルゴリズムは、ウィンドウの幅と設定された余白を考慮した計算式に従って、ウィンドウの上部および下部パネルの範囲内に収まるタブの最大数を計算します。進捗ブランチの数がページの上限を超えると、Mod は追加の仮想ページを作成し、インターフェースの下部にインタラクティブな矢印ボタンを追加します。ページの切り替え時には、レンダラーが非アクティブなページのタブを非表示にし、グラフィックオブジェクトによるメインメモリの過負荷を防ぎ、要素の重なりによる競合を解消します。

主な機能と特徴

Paginated Advancements & Custom Frames の主な機能は、グラフィカルな進捗メニューの再編成です。この Mod は、ナビゲーションのためのいくつかの実用的なツールを提供します:

·        動的ページネーション: 進捗ウィンドウの下隅にページ切り替え用の矢印を追加します。パックに独自のタスクチェーンを持つ Mod が 50 個以上有効化されていても、プレイヤーは任意の数のタブを閲覧できます。

·        タブの固定: ユーザーは任意のタブをお気に入りリストに追加できます。そのために、各タブには星形の専用ボタンが用意されています。固定されたタブは、そのアルファベット順やゲーム内の並べ替え順に関係なく、自動的に最初のページに移動してリストの先頭に表示されます。

·        セッション状態の保持: この Mod は、最後に開いた進捗タブを記憶します。メニューを閉じて L キーで再び開いた場合、インターフェースは最初の標準タブにリセットされるのではなく、プレイヤーが中断したのと同じタブを表示します。

·        進捗デバッガー（Advancement Debugger）: パック開発者やクエスト作者向けの特別なモードです。これは設定で有効化するか、拡張ツールチップ（F3 + H キー）を有効にすると起動します。カーソルを進捗アイコンの上に合わせると、技術情報を含む追加のツールチップウィンドウが表示されます。内部識別子（例: minecraft:adventure/arbalistic）と、達成に必要なトリガー（条件）の一覧です。キーの組み合わせ Ctrl + C で、選択した進捗の識別子をクリップボードにコピーできます。

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

進捗メニューの表示パラメーターは、設定ファイルを通じてユーザーが変更できます。ファイルの場所と形式は Mod ローダーによって異なります:

·        Fabric と Quilt: 設定を機能させるには、Cloth Config API ライブラリのインストールが必要です。パラメーターは config フォルダー内の paginatedadvancements.json（または paginatedadvancements.json5）ファイルに書き込まれます。

·        NeoForge: 2.8.0 以降の Mod バージョンは NeoForge の内蔵設定システムを使用するため、追加のライブラリは不要です。ファイルは config フォルダー内に paginatedadvancements-client.toml という名前で生成されます。

設定ファイルでは、以下の主要なパラメーターが利用できます:

·        showDebugTooltips – 進捗のデバッグ用技術情報の表示を制御する真偽値（true または false）。

·        maxDebugLines – ツールチップウィンドウ内のトリガー行の最大数を制限する整数値で、要件が多数ある場合にテキストが画面外にはみ出すのを防ぎます。

·        disableBackgroundFade – 進捗メニューの閲覧中にゲーム背景が暗くなる効果を無効にするパラメーター。

·        spacing – パネル上の隣接するタブ間の距離を調整するためのピクセル単位のステップ。

·        enablePinning – プレイヤーが選択したタブを固定することを許可または禁止します。

この Mod は、Custom Frames（カスタムフレーム）の仕組みを通じてアイコンをカスタマイズするシステムをサポートしています。デフォルトでは、Minecraft は 3 種類のフレームを提供しています: task（通常のタスク）、goal（目標）、そして challenge（挑戦）です。この Mod では、データパックを使って新しい種類を作成できます。

新しいフレームを追加するには、データパック内の次のパスに JSON ファイルを作成する必要があります:

assets/<mod識別子>/advancement_frame_types/<フレーム名>.json

ファイル内容の例:

フレーム用のテクスチャは次のパスに配置します:

·       assets/<mod識別子>/textures/gui/sprites/advancements/<フレーム名>_unobtained.png – 進捗を達成する前のフレームの外観。

·      assets/<mod識別子>/textures/gui/sprites/advancements/<フレーム名>_obtained.png – 達成後のフレームの外観。

作成したフレームを特定の進捗に紐づけるには、データパック内の次のパスにあるマッピングファイル assets/<mod識別子>/advancement_frames/<ファイル名>.json を使用します:

この Mod は純粋なクライアント側ユーティリティとして開発されたため、サーバーへのインストールは不要です。複雑なクエストシステムや多数の進捗タブを追加する大型の工業系・魔法系 Mod（Create、Ender IO、Botania など）と完全に互換性があります。旧来の Forge ローダーのユーザー向けには、ForgedPaginatedAdvancements という名前の非公式の Mod 移植版が利用可能です。NeoForge 26.1+ プラットフォームで最新バージョンの Mod を実行するには、Java 25 のランタイム環境の使用が必須です。

結論

Paginated Advancements & Custom Frames は、大規模な Mod パックで深刻になるバニラの進捗インターフェースの限られたスペースという問題を効果的に解決します。主にページを追加せずウィンドウをスケーリングするだけの類似 Mod Better Advancements とは異なり、この Mod は明確なページ分割と便利なタブの固定を提供します。この Mod は、内蔵のデバッガーと、データパックの JSON 構造による新しいフレームタイプの柔軟な登録システムのおかげで、改造パック開発者の作業を簡素化します。唯一の目立った制限は、カスタムグラフィックフレームを正しく表示するために、追加のクライアントリソースパックを作成する必要があることです。