Iris/Oculus & GeckoLib Compat — Minecraft でシェーダー使用時のアニメーションを修正する MOD

Iris/Oculus & GeckoLib Compat — Minecraft でシェーダー使用時のアニメーションを修正する MOD

Iris/Oculus & GeckoLib Compat（GeckoAnimFix とも呼ばれます）は、ある特定のバグを修正する Minecraft 向けの小さなクライアントサイド MOD です。シェーダーパックでエンティティの影が有効になっていると、GeckoLib ライブラリをベースに作られた mob やその他のエンティティのアニメーションが再生されなくなります。カスタムの生き物は一つのポーズで固まってしまい、世界の真ん中で彫像のように見えます。

バグの原因

GeckoLib ライブラリは、より複雑な 3D モデルや mob のスケルタルアニメーションのために広く使われるツールです。独自の生き物を持つ数十もの MOD がこれを使用しています。歩行サイクル、呼吸、武器の振り、攻撃的なポーズなどです。Minecraft でのエンティティのレンダリングは、実際には 1 フレームあたり複数回実行されます。メイン画像用と、影マップの構築用とで別々にです。アニメーションはそのうちの一つのパスでのみ更新されるべきものです。

シェーダーパックがエンティティの影（Entity Shadows オプション）を追加すると、mob のモデルはシェーダーパス用に再び描画されます。古いバージョンの GeckoLib では、この追加のパスでモデルのアニメーション状態が壊れ、フレームが固まってしまいます。シェーダーなし、あるいはエンティティの影を無効にした状態では、このバグは現れません。

MOD が具体的に行うこと

GeckoAnimFix は GeckoLib の挙動に小さな修正を加えます。シェーダーの影によって有効化される追加のレンダーパスで mob のアニメーションサイクルがリセットされないようにするものです。エンティティは、Iris や Oculus でどのシェーダーが有効になっているかに関わらず、通常どおりアニメーションを再生し続けます。

この MOD は自動的に機能します。.jar ファイルを mods/ フォルダに置けば、追加の設定は不要です。コマンドや新しいブロック、ゲーム内メニューなどは一切現れません。プレイヤーは、以前は壊れていた mob が再び正常に動くようになったことに気づくだけです。

導入方法

インストール手順は、対応するローダーにとって標準的なものです。.jar ファイルを、GeckoLib ライブラリおよびシェーダー MOD（Iris または Oculus）と一緒に mods/ フォルダに置きます。この MOD はゲーム内に個別のサービスファイルを作成しません。

注意すべき点が一つあります。MOD のバージョンは Minecraft とローダーのバージョンに正確に一致している必要があります。ゲームのバージョン番号が同じでも、Forge 用のビルドは Fabric では起動せず、その逆も同様です。Modrinth のページでは、ファイル一覧で各ゲームバージョンごとに、特定の .jar がどのローダーに対応しているかが個別に示されています。

まとめ

Iris/Oculus & GeckoLib Compat は、一つの狭い課題を解決します。ユーザーが自分のシェーダーパックの影を手放したくない場合に、Minecraft のカスタム mob のアニメーションに命を吹き返らせるのです。最も意味があるのは、GeckoLib がまだ独自の修正を含んでいなかった古い modpack 1.18.2–1.19.4 や初期の 1.20 でのプレイです。制約は明確です。新しいバージョンの GeckoLib にとって、この MOD はすでに不要であり、複雑なアニメーションを持つ MOD の妨げになることさえあります。代替手段は、GeckoLib ライブラリ自体を 4.x 以降に単純に更新することです。これにより個別の修正は不要になりますが、パック内のその他の MOD が互換性のあるバージョンであることが必要になります。