AzureLibは、Minecraftの別のMODがモデルやアニメーションを扱うために使うライブラリです。起動時にAzureLib不足と表示されたら、要求しているMODと、ゲーム版・ローダー・必要なバージョンを合わせて導入します。
この記事ではAzureDoom製のNeoForge用Minecraft Java版1.21.1・AzureLib 3.1.21を対象に、導入と版違い、表示の問題、更新・削除前の確認を解説します。作者資料と配布情報は2026年10月15日に確認しました。実機への導入や描画の検証は行っていません。
AzureLibは別のMODのアニメーションを支える
作者の正規配布ページは、AzureLibをMinecraft MOD向けのアニメーションエンジンとして紹介しています。3Dのキーフレーム、複数のアニメーション、音やパーティクルに関わる処理などを扱います。
プレイヤーが導入するのは、使いたいMODから前提として要求される場合が中心です。AzureLibだけを入れれば、それを使う別のMODのMob・武器・ブロックがすべて追加されるわけではありません。導入後の機能は、要求元のMODも含めて確認してください。
作者のGitHubにはBedrock形式のモデルを扱うという説明がありますが、これはJava版のMODで使うモデルに関する話です。Java版用JARを統合版へ導入できる、という意味にはなりません。
ゲーム版とローダーに対応する配布を選ぶ
正規配布元でゲーム版とNeoForgeを指定して確認したファイルは、次のとおりです。
| Minecraft Java版 | 確認したAzureLib | 配布条件 |
|---|---|---|
| 1.21.1 | 3.1.21 | release。NeoForge用、追加の必須MOD指定なし |
| 26.3 | 4.0.11 | release。NeoForge用、26.3用の別ファイル |
以下の導入・確認は1.21.1用を対象にしています。4.0.11の方が番号が大きくても、1.21.1用の更新としてそのまま入れるファイルではありません。
作者の1.21.1用の版定義でも、Minecraft 1.21.1・AzureLib 3.1.21を確認できます。ここに書かれたビルド用NeoForgeの番号を、起動に必要な最小値としてそのまま案内することはしません。
Minecraft公式の1.21.1情報と26.3情報も確認し、本体とローダーをそろえます。FabricやForgeで使う場合は、その環境に対応する別ファイルと条件を確認してください。
「追加の必須MOD指定なし」は、NeoForge自体も不要という意味ではありません。また、AzureLibを利用する別のMODには、そのMOD自身の前提条件がある場合があります。
要求元のMODと合わせてmodsへ導入する
最初に、AzureLibを要求するMODの配布ページと依存条件を確認します。名前だけでなく、必要な版の下限・上限、対応するローダーも照合してください。
ゲームとサーバーを終了し、ワールド、mods、configを保管します。NeoForge公式の導入案内に沿って、今回起動する1.21.1用の環境を確認します。
- 起動するNeoForgeプロファイルのゲームディレクトリを確認します。
- そのmodsへ、要求範囲を満たすAzureLibのJARを入れます。
- 古いAzureLibのJARが重複していないか確認します。
- マルチではサーバーと参加者の双方の導入・版を合わせます。
- コピーしたワールドで起動・接続と、要求元のモデルやアニメーションを確認します。
今回の配布情報では、AzureLibはクライアント・サーバーの両方を対象とします。描画に関わるライブラリだから、自分だけに入れればよいと一律には判断しません。
作者のドキュメントには、開発者がbuild.gradleへ依存を追加する例があります。通常のプレイヤーが前提MODを入れるために、Gradleを実行したり、MODをコンパイルしたりする必要はありません。例示されている3.0.0も、すべての環境で選ぶべき版という意味ではありません。
GeckoLibやAzureLib Armorとは区別する
作者はAzureLibをGeckoLib 4.xから派生したものと説明しています。ただし、由来が共通していても、要求されたライブラリを自由に置き換えてよいわけではありません。
AzureLibが必要と表示されたらAzureLibの条件を確認し、GeckoLibが必要ならその要求に対応します。両方の導入が必要かどうかも、実際に使うMODの依存情報で判断してください。
同じ作者にはAzureLib Armorという別の配布もあります。名前が似ているだけで、通常のAzureLibの代わりや、必ず一緒に入れる前提とは扱いません。
ライブラリ名・ゲーム版・ローダー・要求範囲を一つずつ合わせることが重要です。JARの名前や内部の対応情報を書き換えて、依存エラーを通す方法は使わないようにしましょう。
起動できない・表示がおかしい場合の確認
起動に失敗する問題と、起動後の表示の問題を分けて確認します。次は確認する内容の分類で、実際のログを再現した文章ではありません。
| 困っていること | 最初に確認する点 | 次の確認 |
|---|---|---|
| AzureLibが見つからない | 対象プロファイルのmodsにあるか | サーバー側の導入と要求元の条件 |
| AzureLibの版が合わない | 要求元が指定する範囲 | ゲーム版・ローダー・旧JARの重複 |
| マルチで接続できない | 双方の構成と版 | 接続ログと要求元の前提 |
| モデルや発光表示がおかしい | 要求元とライブラリの組み合わせ | 描画MOD・シェーダー・関連リソースとの関係 |
3.1.21の変更履歴には、発光レイヤーと、Irisシェーダー使用時のブロックエンティティの発光マスクに関する修正があります。表示の問題では、利用している版と変更履歴も照合してください。
この修正があることは、すべての描画MODやシェーダーとの互換性を保証するものではありません。モデルを追加しているMOD側の対応版やリソースも含めて確認します。
切り分けはコピーした環境で行い、変更前の構成・設定・ログを残します。複数の描画設定や関連ファイルをまとめて変更すると原因を追いにくいため、関係する項目を一つずつ確認してください。
更新・削除は要求元とワールドも保管する
更新ではAzureLib単体の新しさだけでなく、要求元のMODと本体・ローダーの対応を確認します。
| 変更したいこと | 先に照合する条件 | 保管するもの |
|---|---|---|
| AzureLibを更新する | 要求元の依存範囲とゲーム版 | 元のMOD一式・設定 |
| 利用側のMODを更新する | 新しい版が必要とするライブラリ | 利用側とAzureLibの元の組み合わせ |
| ゲーム版を変える | 移行先の本体・ローダー・双方の対応 | 移行前のワールド・MOD・設定 |
| AzureLibを削除する | まだ要求するMODが残っていないか | 元の構成とワールドのコピー |
利用側がMobやアイテム、ブロックを追加している場合は、それらを含むワールドや持ち物も保管してください。コピーした環境で起動・接続・対象のモデルやアニメーションを確認し、元の一式へ戻せる状態で進めます。
AzureLibを要求するMODが残っている状態でライブラリだけを外すと、依存不足になります。削除したい場合は要求元を確認し、利用側の追加要素を世界から外してよいかも含めて判断します。
ライブラリの削除で追加要素が自動的に別形式へ変換される、すべてのデータが残る、といった前提では進めないでください。
まとめ：AzureLibは要求元と対応版を合わせる
AzureLibは、別のMODのモデルやアニメーションを支えるライブラリです。今回の1.21.1用はNeoForge向け3.1.21で、26.3用4.0.11とは別のファイルとして選びます。
要求元のライブラリ名・依存範囲・導入側を確認し、GeckoLibやAzureLib Armorと名前だけで置き換えないようにしましょう。更新・削除前にはワールドと元の構成を一式保管してください。
コメント