環境構築 (1.12.2)

概要

MODを開発するための環境を整えます。Windows 10で確認しているので、MacやLinuxでは異なる部分があります。複数のMODを開発する時は、Forgeの手順3から繰り返してください。

2020年12月8日、IntelliJ IDEA 2020.3の更新に伴い、記事を書き換えました。以前の情報は「前提知識」「環境構築 1」「環境構築 2 (1.12.2)」をご覧ください。

動作確認

2020年12月8日

  • Windows 10 Home 20H2 (64 bit)
  • IntelliJ IDEA 2020.3
  • AdoptOpenJDK (HotSpot) 1.8.0_275
  • Minecraft 1.12.2
  • Forge 14.23.5.2854

手順

前提

Minecraft: Java Editionを公式サイトで購入してください。

MODを開発し配布する際は、MinecraftのEULAに従う必要があります。Minecraftのコードの公開禁止や商用利用に関する制限などが含まれているので、必ず自分で確認してください。

MODの開発は自己責任で行ってください。この講座により生じたいかなる損害についても、TNT Moddersは一切責任を負いません。

IntelliJ IDEA

  1. ダウンロードページから「コミュニティ」をダウンロードしてください。
  2. ダウンロードしたインストーラを実行し、デフォルト設定のまま画面に従ってインストールしてください。
  3. IntelliJ IDEAを起動し、タイトル画面で「New Project」を選択してください。
  4. 「Project SDK」から「Download JDK」を選択してください。
  5. 「Version」に「1.8」、「Vendor」に「Eclipse Temurin (AdoptOpenJDK HotSpot)」を指定し、「Download」を押してください。
  6. 「Project SDK」に「adopt-openjdk-1.8」が選択されていることを確認し、「Cancel」を押してください。

Forge

  1. ダウンロードページから1.12.2を選択し、「Download Recommended」の「Mdk」を押してください。
  2. 「AdFoc.us」という広告ページに移動し、5秒待つと右上に「SKIP」というボタンが出るので、これをクリックしてダウンロードしてください。下の方の「ダウンロード」などのボタンは広告です。
  3. ダウンロードしたzipファイルを解凍してください。日本語の入っていない場所がよいでしょう。今回は例としてC:/Modding/AluminiumModを使用します。今後、build.gradleのパスがC:/Modding/AluminiumMod/build.gradleであるとします。
  4. IntelliJ IDEAを起動して「Open」からC:/Modding/AluminiumModを選択します。自動で読み込みが始まるので、右下の進捗表示が完了するまで待ってください。
  5. ファイアウォールの警告が出た場合は、プライベートネットワークでのアクセスを許可してください。
  6. 10分以上待つと読み込みが終わります。読み込みに失敗したら「Build」のTool Windowにエラーが表示されます。
  7. 画面右側のTool Window Barにある「Gradle」を選択し、GradleのTool Windowを開いてください。1
  8. AluminiumMod > Tasks > fg_runsと階層を下りて「genIntellijRuns」をダブルクリックすると、実行構成が自動で作成されます。「BUILD SUCCESSFUL」の表示を確認してください。
  9. Gradle Tool Window左上の同期ボタン(Reload All Gradle Projects)を押してください。
  10. 画面右上の「AluminiumMod [genIntellijRuns]」などと表示されている実行構成選択ボタンを押して「runClient」を選択してください。
  11. 実行ボタンを押して、Minecraftが起動することを確認してください。

IntelliJ IDEAのスクリーンショット

Example Modの削除

  1. AluminiumMod/src/main/java/にあるcom.example.examplemodを削除してください。中にはコードの例が入っています。
  2. IntelliJ IDEAのProject Tool Windowで手順1を実行した場合、com.exampleが残るので削除してください。
  3. AluminiumMod/src/main/javaを右クリックし、New > Packageからcom.tntmodders.tutorialパッケージを作成してください。実際にMODを作るときは自分が保有するドメインを使います。ない場合は自分の名前など、他のプログラムと被らないものを使ってください。2com.tntmoddersをあなたのMODのパッケージとして使わないでください。
  4. com.tntmodders.tutorialを右クリックし、New > Java ClassからAluminiumModを作成してください。
  5. AluminiumMod/src/main/resources/mcmod.infoを削除してください。MODの情報を登録するファイルですが、この開発講座では使いません。
  6. AluminiumMod/にあるCREDITS.txtLICENSE.txt、2つのLICENSE-Paulscode ….txtREADME.txtを削除してください。Forgeの説明文書です。

build.gradleの編集

デバッグ環境でリソースが読み込まれない問題を回避するため、build.gradleの末尾に以下のコードを追加してください。詳しくはこちらをご覧ください。

copy {
    delete {
        delete "$buildDir/classes/java/main"
    }
    into "$buildDir/classes/java/main"
    from sourceSets.main.resources
}

画像編集ソフト

16×16ピクセルの画像をピクセル単位で編集でき、RGBA各チャンネル8 bitの色情報を透過PNGファイルとして保存できるソフトを用意してください。リソースパックの作り方などで調べると適したソフトが紹介されていると思います。

凪浜は「paint.net」の無料版を使っています。TomKateはPhotoshop Proを使っていますが、もっと軽いピクセル絵用のソフトのほうがいいと思います。

再インストールの手順

エラーが出た際などに正しく再インストールするための手順を説明します。

Forge

  1. C:/Modding/AluminiumModを削除してください。
  2. Forgeの手順3からもう一度行ってください。

IntelliJ IDEA

  1. スタートメニューなどからIntelliJ IDEAのアンインストールを選択してください。
  2. 「Please confirm if you would like to delete the caches and settings:」の枠内にある2つのチェックボックスにチェックを入れてください。
  3. %APPDATA%/JetBrains/%LOCALAPPDATA%/JetBrains/に何か残っていたら削除してください。
  4. 削除が終わったら通常のインストールと同じなので、IntelliJ IDEAの手順2からもう一度行ってください。

AdoptOpenJDK

デフォルトでは%USERPROFILE%/.jdks/にインストールされます。この記事の方法では環境変数の設定などは行わないので、このディレクトリを削除するだけです。

リンク

Pleiades

IntelliJ IDEAを日本語化するツールです。使いたい方は、公式ページの解説に従ってインストールしてください。

ただし、日本語化による不具合の発生や翻訳の更新による混乱を避けるため、できるなら英語のまま使うことをおすすめします。この開発講座ではIntelliJ IDEAの操作や表示の説明を英語版に準拠して行います。


次:アイテムの追加

  1. Tool Window Barが表示されていない場合、画面左下隅の四角いアイコンをクリックすると表示されます。 
  2. オファレンMODはtntmodders.comを取得する前に開発を始めたので、nahama.ofalenmodをパッケージ名にしています。 

24件のコメント

  1. うずまき

    手順11を行うとマイクラが立ち上がる途中に落ちてしまい、クラッシュレポートなどはなく、IntelliJに以下のような表示がされます。

    A detailed walkthrough of the error, its code path and all known details is as follows:

    -- System Details --
    Details:
    Minecraft Version: 1.12.2
    Operating System: Windows 10 (amd64) version 10.0
    Java Version: 1.8.0_392, Temurin
    Java VM Version: OpenJDK 64-Bit Server VM (mixed mode), Temurin
    Memory: 268394152 bytes (255 MB) / 889716736 bytes (848 MB) up to 3784310784 bytes (3609 MB)
    JVM Flags: 0 total;
    IntCache: cache: 0, tcache: 0, allocated: 0, tallocated: 0
    FML: MCP 9.42 Powered by Forge 14.23.5.2859 5 mods loaded, 5 mods active
    States: 'U' = Unloaded 'L' = Loaded 'C' = Constructed 'H' = Pre-initialized 'I' = Initialized 'J' = Post-initialized 'A' = Available 'D' = Disabled 'E' = Errored

    | State | ID | Version | Source | Signature | |:----- |:---------- |:------------ |:----------------------------------------------------------- |:--------- | | LC | minecraft | 1.12.2 | minecraft.jar | None | | LC | mcp | 9.42 | minecraft.jar | None | | LE | FML | 8.0.99.99 | forge-1.12.2-14.23.5.2859_mapped_snapshot_20171003-1.12.jar | None | | L | forge | 14.23.5.2859 | forge-1.12.2-14.23.5.2859_mapped_snapshot_20171003-1.12.jar | None | | L | examplemod | 1.0 | main | None | Loaded coremods (and transformers): GL info: ' Vendor: 'NVIDIA Corporation' Version: '4.6.0 NVIDIA 461.72' Renderer: 'GeForce RTX 3070/PCIe/SSE2'

    [02:51:03] [Client thread/INFO] [STDOUT]: [net.minecraft.init.Bootstrap:printToSYSOUT:553]: #@!@# Game crashed! Crash report saved to: #@!@# C:\Modding\AluminiumMod\run.\crash-reports\crash-2024-01-17_02.51.03-client.txt

    Process finished with exit code -1

    これは長い表示の一部分ですべてを乗せることができなかったので最後のほうの表示のみコピペしています。何か問題や必要な情報がありましたら教えてほしいです。

  2. 羽卒山風

    先ほどコメントした者です。
    無事解決したことを報告いたします。
    ありがとうございました。

Nougat3c へ返信するコメントをキャンセル

このサイトはスパムを低減するために Akismet を使っています。コメントデータの処理方法の詳細はこちらをご覧ください