Opal×Terminus

Fabric開発環境の構築方法 (2026)

Fabric Mod 開発環境の構築：JDKをインストールし、サンプルModテンプレートをクローンし、Yarnのマッピングを選択し、gradle genSourcesとrunClientを実行します。完全ガイド.

Guidesby trqUpdated June 4, 2026
Key takeaways
  • セットアップは4つのステップです：JDK、サンプルModテンプレート、あなたのマッピング、そしてGradle。
  • FabricのビルドプラグインはMinecraftをダウンロードし、実行タスクを自動的に設定してくれます。
  • Gradleを自分でインストールする必要はありません。テンプレートにラッパーが同梱されています。
  • gradle.propertiesでのバージョン不一致が、新規プロジェクトが失敗する最も一般的な原因です.

Fabric開発環境の構築は4つのステップで行います。JDKをインストールし、公式のサンプルModテンプレートから始め、マッピング（通常はYarn）を選択し、Minecraftとテストクライアントをダウンロードし、起動するGradleタスクを実行します。ビルドプラグインが重い作業を処理します。JDKとMinecraftのバージョンを最初に一致させれば、あとはそれに続くだけです.

どこ Opal 合う

OpalはFabricのModで、GraalVM JavaScriptスクリプティングエンジン を搭載しているため、フルなModツールチェーンをセットアップすることなく、スクリプトで拡張できます。インストールして実行するだけで済ませたい場合は、セットアップガイド を参照してください。スクリプトの作成を始めるには、スクリプティングドキュメント をご覧ください

まずに必要なもの

コードを書く前に、Java Development Kit、IDE、そして Git の 3 つが必要です。

  • JDK。 ターゲットとする Minecraft のバージョンに合ったものを選択してください。新しい Minecraft のリリースでは、より新しい JDK が必要になるため、始める前にバージョンの要件を確認してください。
  • IDE。 IntelliJ IDEA または Eclipse のどちらでも構いません。多くの Fabric 開発者は、Gradle とデコンパイラの統合がスムーズなため、IntelliJ IDEA を使用しています。
  • Git。 テンプレートリポジトリをクローンし、自分の変更を追跡します。

Gradle はご自身でインストールする必要はありません。テンプレートには、初回実行時に適切なバージョンをダウンロードする Gradle ラッパー スクリプトが同梱されています。

ステップバイステップ

1

JDKをインストールする

ターゲットのMinecraftバージョンに合ったJDKをインストールし、IDEでそれを指定してください
2

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

Fabric は公式のスターターリポジトリを公開しました。クローンするか、テンプレートとして使用し、パッケージ名と mod ID をご自身のものに置き換えてください
3

マッピングを選択してください

デフォルトでは、Yarn が使用されます。Yarn は、Minecraft のクラスとメソッドに読みやすく、ドキュメント化された名前を付与します。gradle.properties で、Minecraft のバージョン、ローダーのバージョン、および Yarn マッピングのバージョンを設定してください
4

情報源を生成し、実行する

IDEでプロジェクトを開き、Gradleを同期させてから、genSourcesを実行して、Yarnの名前を使用してMinecraftを逆コンパイルします。runClientタスクを実行して、modをロードした開発クライアントを起動します

ビルドプラグインがあなたに提供するもの

Fabric 向けの Gradle ビルドプラグインは、Minecraft をダウンロードし、選択したマッピングにリマップし、実行設定を構築します。これは build.gradle 内の小さなブロックで構成します。

設定項目場所制御するもの
Minecraft のバージョンgradle.propertiesどのゲームビルドに対してコンパイルするか
ローダーのバージョンgradle.propertiesモードが動作する Fabric ローダー
Yarn のバージョンgradle.propertiesソースで使用されるマッピング名
依存関係build.gradleFabric API およびライブラリ

gradle.properties 内の 3 つのバージョンは一貫性を保ってください。Minecraft のバージョンと Yarn マッピングのバージョンの不一致は、新規プロジェクトが同期に失敗する最も一般的な理由です。

マッピングが重要である理由

Minecraft は難読化されているため、クラス名は a.a.a のようになっています。Yarn はそれらを読みやすい名前にマッピングし、安定した intermediary レイヤーの上に配置されます。genSources を実行すると、ビルドプラグインは Yarn 名を使用してゲームを逆コンパイルし、Minecraft コードを直接読み取って参照できるようにします。モードをコンパイルする際、Yarn 名のコードを intermediary にリマップし、マッピングの変更に関係なく、どの対応するインストールでも動作する最終的な jar を作成します.

プロジェクトがビルドできない場合

  • Gradle 同期がインポート直後に失敗します。通常、gradle.properties 内の Minecraft、ローダー、および Yarn のバージョンが一致しません。既知の一致するバージョンセットに設定してください.
  • Javaのバージョンが誤っています。Minecraftのバージョンが必要とするJDKよりも古い場合、ビルド時にサポートされていないクラスファイルバージョンに関するエラーが発生します。新しいJDKをインストールし、プロジェクトをそれに向けるように設定してください.
  • 逆コンパイルされたソースコードはありません。genSourcesを実行し、リロードしてください。初回実行は、ゲーム全体を逆コンパイルするため、時間がかかります.
  • runClient は何も実行しません。初期の Gradle 同期が完了するまで、タスクを実行しないでください。実行構成は同期中に生成されます.

よくある質問

OpalFabricクライアントを8.99ドルで手に入れよう