Fabric開発環境の構築方法

ファブリックのモッド開発環境を構築するには、以下の4つのステップが必要です。Java開発キットをインストールし、公式のサンプルモッドテンプレートから始め、Yarnのマッピングを設定し、最後にGradleを実行します。FabricのビルドプラグインはMinecraftをダウンロードし、残りの部分を接続します。JDKとMinecraftのバージョンを最初に一致させておけば、ビルドシステムが残りの処理を処理します。

まず必要なもの

コードを書く前に：

• Minecraftのバージョンに合ったJDK。 新しいMinecraftのリリースでは、新しいJDKが必要です。インストールする前に、対象バージョン要件を確認してください。
• IDE。 IntelliJ IDEA Community（無料）またはEclipseはどちらも問題なく動作します。ほとんどのFabric開発者は、Gradleとの統合がスムーズなIntelliJを使用しています。
• Git。 テンプレートリポジトリをクローンし、自分のコードを管理します。

Gradleをインストールする必要はありません。テンプレートには、初回実行時に正しいバージョンをダウンロードするラッパー スクリプトが含まれています。

ステップバイステップ

1. JDKをインストールする

   AdoptiumまたはOracleから、ターゲットのMinecraftバージョンに合ったJDKをダウンロードしてください。Minecraft 1.21の場合、Java 21をインストールします。IDEの設定で、このJDKを指定してください.

2. 例のMODテンプレートを入手してください

   公式のFabric GitHubサンプルModリポジトリに移動し、クローンするか、テンプレートとして使用してください。パッケージ名とMod IDを独自のものに変更してください.

3. Gradle.propertiesにバージョンを設定する

   Gradle.properties を開き、以下の3行を更新してください。

   • minecraft_version — ターゲットとする Minecraft のバージョン (例: 1.21)
   • loader_version — Minecraft のビルドに一致する Fabric ローダーのバージョン
   • yarn_mappings — Minecraft リリースに使用する Yarn のバージョン

   この3つは一致している必要があります。そうでないとプロジェクトはビルドされません.

4. IDEで開き、同期してください

   IDEでプロジェクトフォルダを開いてください。Gradleが初期同期（依存関係のダウンロード、実行構成の生成）を実行します.

5. 逆コンパイルされたソースコードを生成する

   IDEのGradleパネルでgenSourcesを実行してください。これにより、Yarnの名前を使用してMinecraftを逆コンパイルし、ゲームのコードを読むことができます.

6. テストクライアントを起動する

   runClient を実行して、mod をロードした Minecraft を起動してください。開発クライアントには、完全なデバッグ機能が含まれています.

gradle.properties の理解

このファイルは、ビルド全体を設定します。3つのバージョンを常に同期させる必要があります。

minecraft_version=1.21
loader_version=0.15.11
yarn_mappings=1.21+build.32

Minecraft が 1.21 で Yarn が 1.20.1 の場合、Gradle の同期に失敗し、不可解なエラーが発生します。常に fabricmc.net/use またはサンプルテンプレートから一致するバージョンを取得してください。

ビルドプラグインの機能

Fabric Gradle プラグインは build.gradle で設定され、以下の処理を行います。

• Minecraft のダウンロード
• 選択したマッピングによる逆コンパイル
• 互換性のためにコードをインターメディアリにリマップ
• IDE の実行構成の生成

一度設定すれば、後は自動化されます。そのため、テンプレートが重要です。なぜなら、これにはすべてが正しく設定されているからです。

マッピングの説明

Minecraft は難読化された状態で提供されます（a、b、c のようなクラス名）。マッピングは、これらの名前を読みやすい名前に変換します。

• Yarn: Fabric のデフォルト。ドキュメントが含まれています。読みやすいです。
• Mojang マッピング: 公式ですが、ドキュメントが少ないです。より曖昧な名前です。

テンプレートでは Yarn を使用しています。genSources を実行すると、Minecraft は Yarn の名前を使用して逆コンパイルされるため、実際のコードを読むことができます。コンパイル時には、Fabric がそれをインターメディアリ（安定した基盤層）にリマップするため、mod はどの Minecraft バージョンでも動作します。

よくあるセットアップの問題

• ✓Gradle 同期がすぐに失敗します。gradle.properties を確認してください。Minecraft、ローダー、および Yarn のバージョンが一致している必要があります。Fabric サイトの既知の組み合わせを使用してください。
• ✓コンパイラのエラー：Javaのバージョンが古いようです。Minecraftのバージョンに対応した新しいJDKをインストールし、IDEでそれを指定してください。
• ✓Minecraftのソースコードが読めない場合：GradleパネルでgenSourcesを実行し、リロードしてください。初回実行は遅くなります。なぜなら、ゲーム全体を逆コンパイルするからです。
• ✓runClient は何も実行しません。初期の Gradle 同期が完了するまで待機します。実行構成は同期中に生成されます。
• ✓IDEがプロジェクトをインポートできません：設定でJDKが選択されているか確認してください。JREではありません。

セットアップ後の次のステップ

環境が正常に動作したら：

1. サンプルmodクラスを削除またはリネームする
2. 独自のmodパッケージを作成する
3. 簡単な機能（ブロック、アイテム、またはイベントリスナー）を実装する
4. runClientを実行し、開発クライアントでテストする
5. 反復する

開発クライアントは、完全なデバッグとホットリロードをサポートしているため、反復が高速です。

IDE固有の注意点

IntelliJ IDEA:

• Gradleプロジェクトとしてインポートする（単なるフォルダとしてではなく）
• どんなタスクを実行する前に、Gradleが完全に同期するのを待つ
• 実行構成は、ランダウンの「Gradle」に表示されます

Eclipse:

• 既存のGradleプロジェクトとしてインポートする
• プロジェクトを右クリック → Gradle → Gradleプロジェクトをリフレッシュ（同期後）
• Gradleタスクは、Gradleタスクビューに表示されます

よくある質問