Iceberg MODの入れ方と前提エラー・対応版の確認方法

Iceberg MODは、ほかのMODが使う処理をまとめた前提ライブラリです。「Icebergが必要」と表示されたら、使いたいMODが要求する版と、Minecraft・ローダーの対応を合わせて導入するのが基本です。Icebergだけを入れて、新しいブロックや専用の遊び方が追加されるものではありません。

この記事ではJava版1.21.1・NeoForge用のIceberg 1.3.2を対象に、入れ方、必須と任意の依存関係、起動エラー、更新・削除前の確認を説明します。2026年10月15日に作者の配布情報と対象版ソースを確認しました。実機での動作検証や性能測定は行っていません。

IcebergはほかのMODを支えるライブラリ

Grend作のIcebergの正規配布ページでは、単体では機能せず、ほかのMODを作るためのイベントや補助機能を提供するライブラリと説明されています。新しい氷山や氷のブロックを追加するMODとして探すものではありません。

同名のリソースパックや、氷山にぶつかった船の動作を変える別作者のMODもあります。必要とされているものがGrendのIcebergか、配布元の作者名とプロジェクトを確認してください。

すべてのMinecraft環境に一律で必要なMODではありません。 使いたいMODやMODパックの必要条件にIcebergが含まれる場合に、その指定を確認して加えます。ライブラリ単体での画面の変化や、FPS向上を目的に導入するものでもありません。

NeoForge1.21.1用1.3.2と実行条件を確認する

この記事で確認したのは、Minecraft1.21.1・NeoForge用のIceberg 1.3.2です。配布ページのゲーム版とローダーを確認し、同じ「Iceberg」という名前だけで別のファイルを選ばないでください。

確認するもの	今回の対象	選ぶときの条件
Minecraft	Java版1.21.1	依存するMODも同じゲーム版へ合わせる
Iceberg	1.3.2・NeoForge用	通常の本体JARを選ぶ
NeoForge	21.1.54以上	対象版の実行依存条件を満たす
追加の外部必須MOD	選択ファイルには指定なし	NeoForge自体まで不要という意味ではない
マルチプレイ	配布情報では両側がrequired	依存するMODの導入先も合わせて確認する

対象版の実行依存定義では、Minecraftは1.21.1、NeoForgeは21.1.54以上です。開発時のビルド設定にある21.1.119を、そのまま最低必須版と読み替えないようにします。

配布ページには別のゲーム版やローダー向けのファイルもあります。新しい番号のIcebergなら古いゲーム版でも使える、とは限りません。また、Icebergを要求するMOD側が特定の範囲を指定しているなら、今回の例よりその条件を優先して照合してください。

起動する環境のmodsへ通常JARを入れる

Minecraft公式の1.21.1情報とNeoForge公式の導入案内を確認し、起動環境をそろえます。追加する前にゲームとサーバーを終了し、ワールド・mods・configを一式保管してください。

1. 使いたいMODの配布情報で、必要なIcebergの版とローダーを確認する。
2. 同じMinecraft版・ローダーに対応するIcebergの通常JARを選ぶ。
3. 実際に起動するゲームディレクトリのmodsへ入れる。
4. 古いIcebergのJARが重複していないか確認する。
5. コピー環境で起動し、Icebergを必要とするMODの機能も確認する。

JARを直接起動して導入する手順ではありません。sourcesや開発用ファイルと、本体の通常JARを取り違えないでください。複数の起動構成がある場合は、別の構成のmodsへ入れても読み込まれません。

選択した配布情報はクライアントとサーバーの両側をrequiredとしています。マルチプレイでは管理者と構成を確認し、Icebergを利用するMOD側の対応版・導入先の説明も合わせます。クライアントに入れただけで、接続先サーバーのファイルまで追加されるわけではありません。

必須依存と任意連携の向きを区別する

前提MODの確認では、「どのMODが、何を必要としているか」を分けることが大切です。Icebergを必要とするMODがあることと、IcebergがそのMODを必須にすることは別です。

見つけた情報	意味	利用者が確認すること
使いたいMODがIcebergを要求する	そのMODの動作条件に含まれる	要求された版の範囲を満たす
IcebergがNeoForgeを要求する	今回のファイルを読み込むための条件	対応するローダーで起動する
Iceberg側でほかのMODがoptional	Icebergから見て追加必須ではない	任意連携をまとめて入れる必要はない
エラーに複数のMOD名がある	複数の条件が関係している場合がある	要求元と不足・不一致の対象を分けて読む

たとえば対象版の定義では、Advancement Plaques、Legendary Tooltips、Equipment CompareなどはIceberg側から見てoptionalです。Icebergを入れるために、それらを全部追加する必要はありません。

反対に、それらのMODを使う場合に必要なライブラリや版の条件は、そのMODの選択ファイルで確認します。Iceberg側の任意指定だけを見て、相手側でもIcebergが不要だと判断しないでください。

設定や表示の変化はIcebergを使うMOD側で確認する

Icebergの役割は共通処理の提供です。導入後に専用の操作キーを探したり、画面が変わらないことだけで失敗と判断したりする必要はありません。目的の表示や操作は、Icebergを利用しているMOD側で確認します。

作者のItem Selectorsの資料には、アイテムを条件で選ぶ仕組みが説明されています。これは、対応するMODの設定などから利用するための資料です。Minecraft内で入力すればどこでも動くコマンドとして扱うものではありません。

設定を変えるときは、まず利用しているMODの説明で設定項目と保存先を確認してください。ライブラリの資料に例があるからといって、無関係な設定ファイルへそのまま貼り付けないようにします。古いゲーム版の記述を、現在のアイテムデータへ無条件に当てはめることも避けましょう。

起動エラーの切り分けと更新・削除前の確認

起動しないときは、エラーに書かれた要求元のMOD、Icebergの必要版、現在読み込まれた版、ローダーを確認します。ログにIcebergの名前があるだけで、原因が必ずIceberg単体にあるとは限りません。

症状	確認する点	見直す方向
Icebergが不足していると出る	導入先と通常JARの有無	起動した環境のmodsへ入れる
必要な版を満たさないと出る	要求元が指定する範囲	同じゲーム版で条件を満たすファイルを選ぶ
ローダーやゲーム版が違う	Fabric・Forge・NeoForge、本体の版	今回ならNeoForge1.21.1用へそろえる
重複したMODがあると出る	複数のIceberg JAR	保管したうえで使用する1つの版へ整理する
更新後に動かなくなった	Icebergと利用するMODの対応	動いていた構成と変更箇所を比較する

更新時は、ワールド・mods・configと、動いていた各ファイルの版を保管します。Icebergだけを番号の大きいものへ替えるのではなく、それを使うMODの必要条件も確認してください。コピー環境で起動と目的の機能を確認してから普段の環境へ反映します。

削除する場合は、Icebergを必須とするMODが残っていないか先に確認します。依存するMODを残したままIcebergだけを外すと、起動条件を満たさなくなることがあります。

依存するMODも外すなら、そのMODが追加したアイテムやワールドへの影響も調べてください。ライブラリを整理する作業だからといって、関連MODのデータまで安全に残るとは限りません。元の構成へ戻せるバックアップを残して進めます。

まとめ：Icebergは依存先と対応版をそろえて使う

Icebergは、ほかのMODを支える前提ライブラリです。今回のNeoForge1.21.1向け1.3.2では、NeoForge21.1.54以上という実行条件を確認し、使いたいMODの要求範囲も合わせて導入します。

起動エラーは依存関係の向きと版を分けて読み、更新・削除前にはIcebergを必要とするMODも確認してください。表示の変化は利用するMOD側で確かめ、動いていた構成を保管して進めましょう。