提供: Minecraft Modding Wiki
移動先: 案内検索
(内容整理)
(IDE等の記述を追記)
11行目: 11行目:
 
前提MODを利用しない環境
 
前提MODを利用しない環境
 
*[[MCPの環境構築手順]]
 
*[[MCPの環境構築手順]]
 
 
 
<div style="border:#900 2px solid;padding:1ex 1em;background:#f99;font-size:150%;font-weight:bold;line-height:100%;">前提MODについて</div>
 
<div style="border:#900 2px solid;padding:1ex 1em;background:#f99;font-size:150%;font-weight:bold;line-height:100%;">前提MODについて</div>
  
25行目: 23行目:
 
</div>
 
</div>
  
==ソースファイルの作成==
+
===JDK(Java SE Development Kit)をダウンロードする===
 
 
既存のクラスを変更する場合は C:\McRoot\src/minecraft/net/minecraft/src/ 内にあるソースコードを変更する。<br />
 
 
 
自作のクラスを追加する場合も、このフォルダに追加する。<br />
 
 
 
最初の内は無理をせず BlockXXX.java や ItemXXX.java などをコピーして練習すると感触をつかみやすい。<br />
 
 
 
欲しい機能がある場合は、その機能を持つソースを覗いてみよう。(爆発を起こしたい→クリーパーのソースを見る…など)<br />
 
 
 
既存のクラスを変更すると、他の MOD と競合することがあるので、レシピの追加などは ModLoader を使ったほうが無難。<br />
 
 
 
ModLoaderを使用する場合は、BaseModを継承したクラスを作成する。<br />
 
 
 
その際クラス名の先頭に"mod_"というプレフィックスをつけること。(つけないと ModLoader から認識されません)<br />
 
 
 
cleanup.bat を実行すると、'''decompile 時に生成されたフォルダ以下が全て削除'''されます。<br />
 
 
 
ソースコードは必ずバックアップを取ることを推奨 します。<br />
 
 
 
==リソースの作成と配置==
 
 
 
自作のテクスチャを使用する場合は、作成して好きな場所に保存しておくこと。<br />
 
 
 
自作のリソースは C:\McRoot\bin\minecraft\ に配置する。<br />
 
 
 
公式のファイルとの区別がつきやすいようなフォルダ名・ファイル名にするのが良い。<br />
 
 
 
(例 : C:\McRoot\bin\minecraft\mod\sample.png など)<br />
 
 
 
cleanup.batを実行すると、'''decompile時に生成されたフォルダ以下が全て削除'''されます。<br />
 
 
 
リソースのマスターデータは別のフォルダにバックアップをすることを推奨 します。<br />
 
 
 
Eclipseを使用している場合<br />
 
 
 
minecraft.jarにリソースファイル(主にテクスチャ等の画像)を入れる場合<br />
 
 
 
C:\McRoot\jars\bin\に入ってる'''minecraft.jar'''の中に配置する。<br />
 
 
 
.minecraftフォルダの中に入れる場合<br />
 
 
 
C:\Users\(ユーザー名)\AppData\Roaming\.minecraftの中の任意のフォルダに入れる。<br />
 
 
 
設定ファイルは'''.minecraft\configか.minecraft\mods'''に入れる。<br />
 
 
 
音声ファイルは'''.minecraft\resource\mods'''に入れる。<br />
 
 
 
==コンパイル==
 
 
 
recompile.batを実行する。<br />
 
 
 
エラーが出た場合は、コマンドプロンプトに詳細が表示されるので原因を取り除く。<br />
 
 
 
コンパイルに失敗した場合、テストプレイを実行できない。<br />
 
 
 
日本語のコメントを記述した場合、コンパイルに失敗するため、/MCPROOT/conf/mcp.cfg内のCmdRecompの末端に "-encoding utf-8" と記述することによりコンパイルすることができるようなる。<br />
 
 
 
==動作テスト==
 
 
 
startclient.bat を実行すると、変更を加えた状態でテストを行える。<br />
 
 
 
テストプレイ時は C:\McRoot\jars\ が .minecraft\に相当し、セーブファイルは C:\McRoot\jars\saves に作成される。<br />
 
 
 
テストのためのアイテムやブロックがないときは、既存のセーブデータのコピーによって対処するといいだろう。<br />
 
 
 
動作テストで満足できないときは、1に戻ってやり直そう。<br />
 
 
 
==配布ファイルの出力==
 
 
 
※MCP 3.X で大きく仕様が変更されたので注意。 <br />
 
 
 
配布するファイルを出力する場合は C:\McRoot\reobfuscate.bat を実行する。<br />
 
 
 
ファイル作成に成功すると MCPROOT/reobf に配布する class ファイルとリソースデータが出力される。<br />
 
 
 
MCP 2.X 以前の様にファイルを列挙する必要はない。<br />
 
 
 
==自作MODを実際に導入して最終テスト==
 
 
 
実際に minecraft.jar に導入してテストを行う。<br />
 
 
 
ModLoader を入れた場合、 ModLoader を導入 したあと class ファイルをZIP内に書き込む。<br />
 
 
 
もちろん META-INF は削除すること。<br />
 
 
 
最後に起動テストをして完了。<br />
 
 
 
うまくいったら好きな場所に公開してみよう。<br />
 
 
 
==バッチファイル一覧==
 
 
 
* decompile
 
 
 
minecraft.jar、minecraft_server.jar をデコンパイルして、ソースファイルを src フォルダに出力する
 
 
 
* recompile
 
 
 
src フォルダにあるソースファイルをコンパイルし、minecraft.jar、minecraft_server.jar を作成する
 
 
 
* startclient
 
 
 
コンパイルされた minecraft.jar を実行し、ゲームを実行する
 
 
 
* startserver
 
 
 
コンパイルされた minecraft_server.jar を実行し、サーバーを立てる
 
 
 
* reobfuscate
 
 
 
実行ファイルから差分ファイルを割り出し、配布用の class ファイルとリソースを出力する
 
  
* cleanup
+
JDK(Java SE Development Kit)をダウンロードするには、<br />
 +
http://www.oracle.com/technetwork/java/javase/downloads/index.html をクリックして下さい。<br />
 +
ダウンロードするバージョンは、JDKの最新版で問題ありません。<br />
 +
(ただし、開発時にはJava7以降の機能は使わないようにしましょう)<br />
  
デコンパイルで作成されたフォルダを全て削除する (削除されたファイルは元に戻せないので注意)
+
JDK DOWNLOADというボタンがあるのでそのリンクを押します。<br />
 +
そして Oracle Binary Code License Agreement for Java SE に同意するために、<br />
 +
Accept License Agreement(訳: ライセンスに同意する)のラジオボタンを選択(クリック)して、<br />
 +
その後、自分のプラットフォームに合わせたJDKのダウンロードリンクをクリックしましょう。 <br />
  
==動画==
+
windows x86 = 32bit/windwos x64 = 64bit<br />
  
[https://www.youtube.com/watch?v=Aw8zsaCmWQI&list=UUL01X_qhhXXR3IZDlxEi4Dg&index=3 Minecraft MODの作り方講座 【下準備編】 ]
+
<del>JDKのインストール後、環境変数の設定が必要なことがあります(ほぼ必ず)</del><br />
 +
<ins>(Windows7 + Java8u5 現在は環境変数の設定は必要ありません)</ins>
 +
==IDE(統合開発環境)の利用==
 +
MOD作成はテキストエディタでも可能ですが、コンパイルエラーやデバッグのしやすさ等でIDEを利用することが推奨されます。
 +
*Java統合開発環境(IDE)※任意
 +
**[[Eclipseを入手する]]
 +
**[[IDEAを入手する]]

2015年1月4日 (日) 20:34時点における版

Minecraft のMod開発環境を構築する

以下の構築環境は、主に「クライアントユーザ向け」のMOD構築です。

前提MOD利用する環境

ModLoaderを使用する場合は、 MCPの環境構築手順のSetup3の minecraft.jar(Modloader導入済)と minecraft_server.jar(ModLoaderを入れてない状態)の両方を用意して下さい。
前提MODを利用しない環境

前提MODについて
  • 1.8現在、前提MODはMinecraftForgeが主流になっています。

MinecraftForgeで出来ないことは、他の前提MODでも出来ないくらい、APIが充実しています。
他の前提MODとして、

  • LiteLoader(クライアントサイドのみ)
  • BlazeLoader

というMODが存在します。それぞれForgeよりもMODを作りやすいという特徴が有ります。

JDK(Java SE Development Kit)をダウンロードする

JDK(Java SE Development Kit)をダウンロードするには、
http://www.oracle.com/technetwork/java/javase/downloads/index.html をクリックして下さい。
ダウンロードするバージョンは、JDKの最新版で問題ありません。
(ただし、開発時にはJava7以降の機能は使わないようにしましょう)

JDK DOWNLOADというボタンがあるのでそのリンクを押します。
そして Oracle Binary Code License Agreement for Java SE に同意するために、
Accept License Agreement(訳: ライセンスに同意する)のラジオボタンを選択(クリック)して、
その後、自分のプラットフォームに合わせたJDKのダウンロードリンクをクリックしましょう。

windows x86 = 32bit/windwos x64 = 64bit

JDKのインストール後、環境変数の設定が必要なことがあります(ほぼ必ず)
(Windows7 + Java8u5 現在は環境変数の設定は必要ありません)

IDE(統合開発環境)の利用

MOD作成はテキストエディタでも可能ですが、コンパイルエラーやデバッグのしやすさ等でIDEを利用することが推奨されます。