「MinecraftForge導入手順」の版間の差分

2017年2月20日 (月) 20:25時点における版

この記事は執筆中です。加筆してくださる人を募集しています。

MinecraftForge9.11.1.960以降での開発環境構築手順です。

必要なもの

MinecraftForgeのソースファイル
- http://files.minecraftforge.net/ から　Mdk　をダウンロード
- Forge-1.8-11.14.4 以前は Src' 。
JDK（JavaDevelopmentKit）
- http://www.oracle.com/technetwork/java/javase/downloads/index.html からPCに合わせてダウンロード
- 詳しくは「事前準備・MOD開発環境を作る」を参照。
Java統合開発環境（IDE）※任意
- Eclipseを入手する
- IDEAを入手する

Forge

前準備

JDKのダウンロード、およびインストール
Mod Development Kit (Mdk)のダウンロード、および解凍

手順

IDEAの場合

Import Projectからbuild.gradleを開く

その他の場合

gradlewファイルが存在するディレクトリで
```
gradlew setupDecompWorkspace
```
をシェル上で実行する。
しばらく待ち、「BUILD SUCCESSFUL」と表示されれば成功。
1. 「BUILD FAILURE」と表示された場合は
```
gradlew --refresh-dependencies
```
  を実行の後やり直す。
Eclipseの場合は、
```
gradlew eclipse
```
も併せて実行し、生成されるファイルからプロジェクトを開く。

マルチプロジェクトにする場合

複数のMODを同じワークスペースで開発する場合のみ必要な工程です。

build.gradleファイルを適当なテキストエディタで開き、build.gradle内の以下の部分

apply plugin: ...

version = "1.0"
group= "com.yourname.modid" // http://maven.apache.org/guides/mini/guide-naming-conventions.html
archivesBaseName = "modid"

minecraft {
    version = ...
    runDir = ...

    mappings = ...
}

を、次のように変更する。

allprojects {
    apply plugin: ...

    minecraft {
        version = ...
	runDir = ...

        mappings = ...
    }

    archivesBaseName = project.projectDir.name
}

build.gradleを同じディレクトリに「settings.gradle」ファイルを作成する。
「settings.gradle」を開いて、以下のように記述し保存。
Eclipseの場合
```
includeFlat 'Project1','Project2'
```
この時、Project1ディレクトリとProject2ディレクトリは以下に示すようにワークスペースと“同じ階層”に置くこと

親ディレクトリ
ワークスペース/

Project1/

Project2/
IDEAの場合
```
include 'Project1','Project2'
```
この時、Project1ディレクトリとProject2ディレクトリは以下に示すようにワークスペース“内”に置くこと

親ディレクトリ
ワークスペース/
Project1/

Project2/
各プロジェクトのディレクトリ内に「build.gradle」ファイルを作成する。
「build.gradle」を開いて、以下のように記述し保存。
sourceSets.main {

   java.srcDirs project.projectDir.name
   resources.srcDirs project.projectDir.name

}

version = "1.0"//バージョン

ソースに日本語が記述されている場合
「build.gradle」に以下を追加。
tasks.withType(Jar) {compileJava.options.encoding = 'UTF-8'}
APIに日本語が記述されている場合
「build.gradle」に以下を追加。
tasks.withType(Jar) {compileApiJava.options.encoding = 'UTF-8'}
依存関係がある場合、外部jarをビルド時に読ませたい場合
1. 「build.gradle」に以下を追加。

dependencies { compile fileTree(dir: 'lib', include: '*.jar') }

1. そのプロジェクトのディレクトリ内に「lib」ディレクトリを作成。
マルチプロジェクト内の他のプロジェクトに依存している場合

「build.gradle」に以下を追加。
```
dependencies { compile project(':ProjectName')}
```

以上のようにすると、以下のようになる。

Eclipseの場合

ワークスペース/

.gradle/

src/

build.gradle

settings.gradle

Project1/

.gradle/

src/

build.gradle

Project2/

.gradle/

src/

build.gradle

IDEAの場合

ワークスペース/

.gradle/

src/

build.gradle

settings.gradle

Project1/

.gradle/

src/

build.gradle

Project2/

.gradle/

src/

build.gradle

MOD

開発

この環境下でMODをビルドしたい場合、単独プロジェクトの場合は、開発環境の作業ディレクトリに
src/main/java
という階層でディレクトリを作成し、javaディレクトリ内に、自身のMODのパッケージに有ったディレクトリ構成でsourceファイルを配置すればよい。
画像や音声ファイル等のリソースファイルは
src/main/resources/assets
という階層でディレクトリを作成し、assetsディレクトリ内に指定されたディレクトリ構成でファイルを配置すればよい。リソースファイルの配置の仕方は、1.7のリソース（テクスチャ・サウンド・言語ファイル等）の置き場所を参照のこと。

マルチプロジェクトの場合

各プロジェクトディレクトリ内に、上のディレクトリ構成でファイルを配置する。

デバッグ

作成したMODのデバッグは、ForgeGradleを使うことで、1.6.4以前のMCP環境と同様に行うことが出来る。

単独プロジェクトの場合

作業ディレクトリ内に新規テキストファイルを作成し、中に以下のコードを書いて保存。ファイル名を「RunClient.bat」に変更する。

call gradlew runClient
pause

作業ディレクトリ内に新規テキストファイルを作成し、中に以下のコードを書いて保存。ファイル名を「RunServer.bat」に変更する。

call gradlew runServer
pause

build.gradle内のrunDirに指定したディレクトリ(MDKのデフォルトでは"run")がプロジェクトディレクトリ以下に存在しないと，runClientおよびrunServerがエラーで実行できないので注意．
マルチプロジェクトの場合

作業ディレクトリ（プロジェクトディレクトリではない）内に新規テキストファイルを作成し、中に以下のコードを書いて保存。ファイル名を「RunClient.bat」に変更する。

call gradlew :<PROJECT NAME>:runClient
pause

作業ディレクトリ（プロジェクトディレクトリではない）内に新規テキストファイルを作成し、中に以下のコードを書いて保存。ファイル名を「RunServer.bat」に変更する。

call gradlew :<PROJECT NAME>:runServer
pause

IDE上でデバッグする場合

Eclipse で開発する場合は、プロジェクトファイルを開き、起動クラスの設定を行う

起動クラスの設定はクライアントの場合GradleStart、サーバはGradleStartServer。プログラムの引数は空で良いが、「-username=<任意の文字列>」を指定しておくと、マルチプレイのテスト時にOPを付与しなおす必要がなくなる。
VM への引数として「-Xincgc -Xmx1024M -Xms1024M」を指定。（非力なマシンでデバッグする場合は適宜変更のこと）
作業ディレクトリに「${workspace_loc:(プロジェクト名)/jars}」を指定。GUI からワークスペースの jars ディレクトリを指定しても良い。
ワールド情報は jars/save の中に生成されるので、既存ワールドは適宜このディレクトリにコピーすること。一度ゲームを起動すれば jars ディレクトリ内に必要ディレクトリが作成される。

ビルドパスの修正

ForgeSrcのパスが不足している場合、C:\Users\ユーザー名\.gradle\caches\minecraft\net\minecraftforge\forge\(Forgeバージョン) に forgeSrc-(Forgeバージョン).jar が存在する。添付ソースは末尾が「-source.jar」のファイルなので一緒に設定すると良い

IDEAで開発する場合、起動構成は開発ディレクトリ上でのコマンドプロンプトで「gradlew genIntellijRuns」と実行すれば自動的に構成できる。

リリース

リリースビルド用バッチファイルの作成
（シングルプロジェクト用）

作業ディレクトリ内に新規テキストファイルを作成し、中に以下のコードを書いて保存。ファイル名を「Release.bat」に変更する。

call gradlew build --info > buildlog.txt 2>&1

今後、コンパイルを行う時はこの「Release.bat」を実行すれば、MCPでの「recompile.bat」「reobfuscate_srg.bat」を同時に行ってくれる
コンパイル中のログは、「buildlog.txt」に出力される
コンパイルされたclassファイルは、\build\libsディレクトリに圧縮された状態で出力される
- 「build.gradle」を弄っていなければ、「modid-1.0.jar」として出力されている。"archivesBaseName"-"version".jarという書式

（マルチプロジェクト用）

作業ディレクトリ内に新規テキストファイルを作成し、中に以下のコードを書いて保存。ファイル名を「Release-<ProjectName>.bat」に変更する。

call gradlew :<ProjectName>:build --info > build-<ProjectName>-log.txt 2>&1

今後、<ProjectName>のプロジェクトのコンパイルを行う時はこの「Release-<ProjectName>.bat」を実行すれば、MCPでの「recompile.bat」「reobfuscate_srg.bat」を同時に行ってくれる
コンパイル中のログは、「build-<ProjectName>-log.txt」に出力される
コンパイルされたclassファイルは、\build\libsディレクトリに圧縮された状態で出力される
- マルチプロジェクト用「build.gradle」を弄っていなければ、「<ProjectName>-1.0.jar」として出力されている。"<ProjectName>"-"version".jarという書式

Forgeのアップデート

Forgeの新しいビルドがアップデートされた時に、以下のようにして、開発環境のForgeをアップデートすることが出来る。

「build.gradle」ファイルを開く。
中程のminecraftブロック内の“version”を最新のビルドナンバーに書き換え、保存する。
「install.bat」を実行。

（注意）マルチプロジェクトをしている場合は、setupDevWorkspaceとsetupDecompWorkspaceを全てのプロジェクトで自動で行うが、setupDecompWorkspaceは大元のプロジェクトで行えば十分なので、「install.bat」の中身の「setupDecompWorkspace」を「:setupDecompWorkspace」に置き換えたほうが、作業が捗り、decomp時のJava heapエラーに悩まされることもなくなる。（1.7.10以降なら、そのままでも重複タスクはスキップされるので、Java heap エラーは起きにくくなった。）

動画

リンク

以前のバージョンでの手順

参考サイト

非公式フォーラム
 IDEA+Gradleでわいわい
 IntelliJ IDEAでModding
ForgeGradle＋IDEAでマルチプロジェクト

コメントの自動更新を有効化

当たり前ですが、install.bat実行時に対応するバージョンのminecraftの.jarが無いと失敗します。実行前に一度でも対応バージョンのminecraftを起動しておく旨を記載した方がよろしいかと --122.251.218.248 2016年12月14日 (水) 18:09 (JST)

マルチプロジェクトのほうの解説が少しわかりづらいのです --118.8.218.24 2016年7月23日 (土) 19:06 (JST)

install.batが失敗したので調べたらgradle.propertiesファイルを作成して内容をorg.gradle.jvmargs=-Xmx2048Mと書いてgradlewと同じディレクトリに入れておいたら成功しました。 --115.36.144.125 2016年2月25日 (木) 07:04 (JST)

@@ 1行目: / 1行目: @@
 {{stb}}
-Minecraft1.7.2以降で、MinecraftForge10.12.0.967以降を導入する場合の手順です。<br />
+MinecraftForge9.11.1.960以降での開発環境構築手順です。
-;動作確認
-:Minecraft1.7.2~1.8　Forge10.12.0.？？？ ～
-:Minecraft1.6.4 forge-1.6.4-9.11.1.960-964
-*動作の確認は基本的にRecommended[推奨版]のみ。Latest[最新版]はForge自体の動作が保証されていません。
-*Forgeのダウンロードは[http://files.minecraftforge.net/ こちら]から。
 ==必要なもの==
 *MinecraftForgeのソースファイル
-**http://files.minecraftforge.net/ から　Src　をダウンロード
+**http://files.minecraftforge.net/ から　Mdk　をダウンロード
-**Forge-1.8-11.14.4 以降は名称が '''Mdk''' （Mod Development Kit）に変更されている。また、gradleファイルの内容が変わっているので注意すること。
+**Forge-1.8-11.14.4 以前は ''Src''' 。
 *JDK（JavaDevelopmentKit）
 **http://www.oracle.com/technetwork/java/javase/downloads/index.html からPCに合わせてダウンロード
@@ 22行目: / 16行目: @@
 ===前準備===
 *JDKのダウンロード、およびインストール
-*MinecraftForgeSourceのダウンロード、および解凍
+*Mod Development Kit (Mdk)のダウンロード、および解凍
-===環境構築手順(install.bat作成まで)===
+===手順===
-Forge の src を展開する
+;IDEAの場合
-gradlew.batをメモ帳等で開き、JDKのパスをショートネームで追記しておく(12～18行目あたりのset ＊＊＊が並んでる付近でよい)
+:#Import Projectからbuild.gradleを開く
-*set JAVA_HOME=C:\PROGRA~1\Java\jdk1.8.0_121
+;その他の場合
-*ショートネームがわからなければ、コマンドプロンプトで「dir /x C:\」と打てば表示される。「Program Files」は「PROGRA~1」など
+:#gradlewファイルが存在するディレクトリで<source lang="winbatch">gradlew setupDecompWorkspace</source>をシェル上で実行する。
-インストール用バッチファイルの作成
+:#しばらく待ち、「BUILD SUCCESSFUL」と表示されれば成功。
-*作業ディレクトリ内に新規テキストファイルを作成し、中に以下のコードを書いて保存。ファイル名を「Install.bat」に変更する。
+:##「BUILD FAILURE」と表示された場合は<source lang="winbatch">gradlew --refresh-dependencies</source>を実行の後やり直す。
-(IDEを使わないでデバッグする人用)
+:#Eclipseの場合は、<source lang="winbatch">gradlew eclipse</source>も併せて実行し、生成されるファイルからプロジェクトを開く。
-<source lang="winbatch">
-call gradlew setupDecompWorkspace
-</source>
-(Eclipse用)
-<source lang="winbatch">
-call gradlew setupDecompWorkspace eclipse
-pause
-</source>
-(intellij IDEA用)
-<source lang="winbatch">
-call gradlew setupDecompWorkspace idea
-pause
-</source>
-（IDEAは標準でGradleファイルの読み込みができるので、バッチファイルを作る必要はそれほどない。）<br>
-Install.batを実行する。暫く待つと ディレクトリ内に必要なファイルが生成される。
-*「BUILD SUCCESSFUL」が表示されていれば成功。
-*失敗していたら「gradlew --refresh-dependencies」を実行させて依存ファイルの再作成を行わせ、再度install.batを実行してみること。
-===build.gradleファイルの編集===
+===マルチプロジェクトにする場合===
 複数のMODを同じワークスペースで開発する場合のみ必要な工程です。
-*ディレクトリ内にあるbuild.gradleファイルを適当なテキストエディタで開く
+# <div>build.gradleファイルを適当なテキストエディタで開き、build.gradle内の以下の部分
-**build.gradle内の以下の部分
+<source lang="groovy">
- <source lang="groovy">
+apply plugin: ...
-apply plugin: 'forge'
 version = "1.0"
@@ 62行目: / 38行目: @@
 minecraft {
-     version = "1.7.2-10.12.0.1024"//DLした時のForgeのバージョン
+     version = ...
-     assetDir = "eclipse/assets"
+     runDir = ...
-     mappings = "***"// MDKではMCPのマッピング指定がある
+     mappings = ...
 }
 </source>
@@ 71行目: / 47行目: @@
 <source lang="groovy">
 allprojects {
-     apply plugin: 'forge'
+     apply plugin: ...
      minecraft {
-         version = "1.7.2-10.12.0.1024"
+         version = ...
-	runDir = "eclipse/assets"
+	runDir = ...
-         mappings = "***"// MDKではMCPのマッピング指定がある
+         mappings = ...
      }
-    version = "1.0"//各プロジェクトで指定するだろうし、無くてもよい。
      archivesBaseName = project.projectDir.name
 }
-</source>
+</source></div>
-* 最新版では'''apply pluginの設定値が違うため変更しないように．'''
+#build.gradleを同じディレクトリに「settings.gradle」ファイルを作成する。
-* mappings(MCPの難読化割り当てパターンのようなもの)の初期設定値はForgeのバージョンによって異なるので，ソースをリポジトリ等に公開する場合は注意すること．マルチプロジェクト化の前後で不用意に変更しないように．
+#「settings.gradle」を開いて、以下のように記述し保存。
-*ディレクトリ内に新規テキストファイルを作成し、ファイル名を「settings.gradle」に変更。
+#;Eclipseの場合
-*「settings.gradle」を開いて、以下のように記述し保存。
+#:<source lang="groovy">includeFlat 'Project1','Project2'</source>
-*(Eclipseの場合)includeFlat 'Project1','Project2'
+#:この時、Project1ディレクトリとProject2ディレクトリは以下に示すようにワークスペースと“同じ階層”に置くこと
-**この時、Project1ディレクトリとProject2ディレクトリは作業しているディレクトリと“同じ階層”に置くこと
+#:親ディレクトリ
-作業フォルダ<br />Project1<br />Project2
+#:::ワークスペース/
-*(IDEAの場合)include 'Project1','Project2'
+#:::Project1/
-**この時、Project1ディレクトリとProject2ディレクトリは作業しているディレクトリ“内”に置くこと
+#:::Project2/
-作業フォルダ<br />|-Project1<br />|-Project2
+#;IDEAの場合
-*各プロジェクトのディレクトリ内に新規テキストファイルを作成し、「build.gradle」という名称に変更。
+#:<source lang="groovy">include 'Project1','Project2'</source>
-*「build.gradle」を開いて、以下のように記述し保存。
+#:この時、Project1ディレクトリとProject2ディレクトリは以下に示すようにワークスペース“内”に置くこと
-<source lang="groovy">
+#:親ディレクトリ
+#:::ワークスペース/
+#:::::Project1/
+#:::::Project2/
+#各プロジェクトのディレクトリ内に「build.gradle」ファイルを作成する。
+#「build.gradle」を開いて、以下のように記述し保存。
+#::<span><source lang="groovy">
 sourceSets.main {
      java.srcDirs project.projectDir.name
      resources.srcDirs project.projectDir.name
 }
+version = "1.0"//バージョン</source></span>
-version = "1.0"//各プロジェクトのバージョン
+#;ソースに日本語が記述されている場合
+#:「build.gradle」に以下を追加。
-</source>
+#:::<source lang="groovy">tasks.withType(Jar) {compileJava.options.encoding = 'UTF-8'}</source>
-*project.projectDir.nameは'''各プロジェクトのディレクトリに置き換わる'''ので'''変更する必要はない'''
+#;APIに日本語が記述されている場合
-*以下の記述でも同じように動くが、'''推奨しない。'''
+#:「build.gradle」に以下を追加。
-<source lang="groovy">
+#:::<source lang="groovy">tasks.withType(Jar) {compileApiJava.options.encoding = 'UTF-8'}</source>
-sourceSets.main {
+#;依存関係がある場合、外部jarをビルド時に読ませたい場合
-    java.srcDirs 'src/main/java'
+#:#「build.gradle」に以下を追加。
-    resources.srcDirs 'src/main/resources'
-}
-version = "1.0"//各プロジェクトのバージョン
-</source>
-*ソースファイル内に日本語が記述されている場合は、「build.gradle」に以下を追加。
-<source lang="groovy">
-tasks.withType(Jar) {compileJava.options.encoding = 'UTF-8'}
-</source>
-*日本語の記述されているAPIを利用する場合は、「build.gradle」に以下を追加。
-<source lang="groovy">
-tasks.withType(Jar) {compileApiJava.options.encoding = 'UTF-8'}
-</source>
-*依存関係がある場合、外部jarをビルド時に読ませたい場合は、「build.gradle」に以下を追加。<br />そして、そのプロジェクトのディレクトリ内に「lib」ディレクトリを作成。
 <source lang="groovy">
 dependencies { compile fileTree(dir: 'lib', include: '*.jar') }
 </source>
-*マルチプロジェクト内の他のプロジェクトに依存している場合は、「build.gradle」に以下を追加。
+#:#そのプロジェクトのディレクトリ内に「lib」ディレクトリを作成。
-<source lang="groovy">
+#;マルチプロジェクト内の他のプロジェクトに依存している場合
-dependencies { compile project(':ProjectName')}
+#:「build.gradle」に以下を追加。
-</source>
+#:<source lang="groovy">dependencies { compile project(':ProjectName')}</source>
-*以上のファイルを配置すると、以下のようになる。
+以上のようにすると、以下のようになる。
 ;Eclipseの場合
 :ワークスペース/

「MinecraftForge導入手順」の版間の差分

表示

2017年2月20日 (月) 20:25時点における版

目次

必要なもの

Forge

前準備

手順

マルチプロジェクトにする場合

MOD

開発

デバッグ

リリース

Forgeのアップデート

動画

リンク

以前のバージョンでの手順

参考サイト

案内メニュー

案内

検索

基本情報

チュートリアル

解説

リンク

その他

ツール

個人用ツール