2016年2月21日 (日) 15:05時点における版

無機能なIGNISアイテムを作る

早速新規Item制作に取りかかります。
この先のやり方は、各Modderによって千差万別だと思います。私の場合は、アイテムを作るならまず無機能なアイテムとして作り、レンダー周りを作成していきます。要するに、見た目から作る方向です。
機能を一つずつ追加していった方がデバッグプレイ時に確認しやすいためでもありますし、早い段階で面白おかしい物がゲーム中に出現した方がモチベーションが維持しやすいのでこうしています。自分が作った物をゲーム中で見られるようになるのは、やはり何度やっても面白いものです。

無機能アイテムの追加

アイテムを追加するための最低限のパーツは、

1. Item.class継承クラス
2. アイコン画像
3. langファイル

この3つです。
ただし今回は、アイテムの見た目はTechneで作るモデルを適用するつもりでいますので、アイコンは仮の物を適当にあてがいます。

ItemIgnis.class

今回、IGNISはバニラの弓のクラスであるItemBow.classを継承させます。 ItemBow.classのメソッドには依存しない造りにするつもりなので、本来であれば不要なのですが、アイテムに弓用のエンチャントが付けられるかの可否がItemBow.classを継承しているかで判定されているというバニラの処理の都合により、こうしています。

package defeatedcrow.flamethrower.item;

import net.minecraft.client.renderer.texture.IIconRegister;
import net.minecraft.item.ItemBow;
import cpw.mods.fml.relauncher.Side;
import cpw.mods.fml.relauncher.SideOnly;

public class ItemIgnis extends ItemBow {

	public ItemIgnisClone() {
		// スタックサイズ上限。スタック出来ないようにするので1にする。
		this.setMaxStackSize(1);
		// この武器はメタデータ(耐久値)を持たない。
		this.setMaxDamage(0);
		// クラフトでの修理を不可に。
		this.setNoRepair();
	}

	// Icon用テクスチャファイルの指定はここで行う。
	// ItemBowクラスでも、このメソッドでテクスチャパスを指定しているため、
	// オーバーライドして上書きしなければならない。(コンストラクタでのテクスチャパス指定は推奨しない。)
	@Override
	@SideOnly(Side.CLIENT)
	public void registerIcons(IIconRegister par1IconRegister) {
		this.itemIcon = par1IconRegister.registerIcon("dcsflame:flamethrower");
	}
}

テクスチャ

仮なので、最低限何か分かる程度の簡単なテクスチャで済ませています。

テクスチャの置き場は、src/main/resources/assets/dcsflame/textures/itemsフォルダのflamethrower.pngです。 "dcsflame"の部分はテクスチャ登録時に登録するドメイン。

余談ですが、テクスチャの数が多い場合、itemsフォルダの中でフォルダ分けしたい場合は、以下のように記述することで設定できます。

.registerIcon("dcsflame:tools/flamethrower");

このように、コロン(:)の後にフォルダ名を入れてスラッシュ(/)を入れれば、上記の場合は「tools」フォルダ内のテクスチャファイルを読み込ませることが出来ます。

Langファイル

1.6までは言語設定はソース内で設定できていました。 1.7からはそれが不可になり、別途langファイルを用意します。基本的には、英語(en_US)と日本語(ja_JP)を用意すれば十分ではないかと思います。

作り方は、

1. 新規のテキストファイルを作成
2. 一行目を空行にし、二行目以降に言語設定を記述していく
3. ファイルを保存し、「en_US.lang」など所定の名前・拡張子を.langに変更
4. できたファイルをsrc/main/resources/assets/MODのIDを小文字にしたもの/langに配置

注意点として、テクスチャなどと違いドメインを変えられません。MODIDを小文字にしたもの(IGNISの場合は「dcsflame」)固定です。 また、日本語等の2バイト文字を含む場合は、扱うソフトに注意して下さい。

• ja_JP.lang

item.dcsflame.flamethrower.name=火炎放射器

• en_US.lang

item.dcsflame.flamethrower.name=Flamethrower

作者の経験談：もらい物の中国語LangファイルをうっかりTerraPadで開いた際、中国語の漢字の大部分がバケ文字に変わってしまったことがありました。 化けないテキストエディタを探して、結局一番良かったのがeclipse内蔵のテキストエディタだったりします。 eclipse上のエクスプローラでファイルを右クリック→次で開く→テキストエディターを選択で、内蔵のテキストエディタから開けます。

ただ、TerraPadのように保存時の文字コードを選択できる点も有利になることがあるので、テキストエディタは用途によって使い分けるのが良さそうです。

登録処理

ここまでで最低限必要なパーツは揃いましたので、メインクラスに登録します。

メインクラスに、このItemのインスタンスと、preInitメソッドでの登録メソッドを追加します。

• FlameCore.class

package defeatedcrow.flamethrower;

import java.io.IOException;

import net.minecraft.creativetab.CreativeTabs;
import net.minecraftforge.common.MinecraftForge;
import net.minecraftforge.common.config.Configuration;
import net.minecraftforge.common.config.Property;

import org.apache.logging.log4j.LogManager;
import org.apache.logging.log4j.Logger;

import cpw.mods.fml.common.Mod;
import cpw.mods.fml.common.Mod.EventHandler;
import cpw.mods.fml.common.Mod.Instance;
import cpw.mods.fml.common.SidedProxy;
import cpw.mods.fml.common.event.FMLInitializationEvent;
import cpw.mods.fml.common.event.FMLPostInitializationEvent;
import cpw.mods.fml.common.event.FMLPreInitializationEvent;
import defeatedcrow.flamethrower.common.CommonProxyF;
import defeatedcrow.flamethrower.item.ItemIgnis;

/*
 * @Modアノテーションです。
 * MODのID、表示名、起動に必要な他MODなどを記述するところ。
 */
@Mod(modid = "DCsFlame", name = "Flamethrower", version = "1.7.10_1.0a",
		dependencies = "required*after:Forge@[10.13.2.1291,)")
public class FlameCore {

	@SidedProxy(clientSide = "defeatedcrow.flamethrower.client.ClientProxyF",
			serverSide = "defeatedcrow.flamethrower.common.CommonProxyF")
	public static CommonProxyF proxy;
	@Instance("DCsFlame")
	public static FlameCore instance;

	public static Logger logger = LogManager.getLogger("Flamethrower");

        // FlameThrowerアイテムのインスタンス。
	public static Item flamethrower;

	@EventHandler
	public void preInit(FMLPreInitializationEvent event) {

		// conf
		Configuration cfg = new Configuration(event.getSuggestedConfigurationFile());
		try {
			cfg.load();
		} catch (Exception e) {
			e.printStackTrace();
		} finally {
			cfg.save();
		}

		// itemの登録。
		this.flamethrower = new ItemIgnis().setCreativeTab(CreativeTabs.tabCombat).setUnlocalizedName(
				"dcsflame.flamethrower");
		GameRegistry.registerItem(flamethrower, "dcsflame.flamethrower");
		
	}

	@EventHandler
	public void init(FMLInitializationEvent event) throws IOException {
	}

	@EventHandler
	public void postInit(FMLPostInitializationEvent event) {

	}
}

変更点は2点です。

インスタンスを宣言することと、

public static Item flamethrower;

登録メソッド。

this.flamethrower = new ItemIgnis().setCreativeTab(CreativeTabs.tabCombat).setUnlocalizedName(
	"dcsflame.flamethrower");
GameRegistry.registerItem(flamethrower, "dcsflame.flamethrower");

ここで、flamethrowerインスタンスに中身(ItemIgnis.class)を入れ、GameRegistry.registerItem()メソッドで登録します。
UnlocalizedNameはLangファイル翻訳時に参照するアイテムの名前です。
.registerItem()メソッドの第二引数に入れるStringはアイテムの登録名で、GameRegistry.findItem()でアイテムを取得するときに使用します。

デバッグプレイで確かめてみよう!

さて、ここまでで無機能なItemの登録処理を書いてみたので、実際出来ているのか起動して確かめてみることが出来ます。

実行の設定は特に弄らなくても、実行ボタンを押せば動くと思います。 (GradleStartなどの、このあたりの指定を開発環境作成時に自動でやってくれるので。)

うまく起動できていれば、mod一覧画面に作成したFlameThrowerMOD、そしてライブラリとして導入したdeobf版MODが表示されます。

ゲーム内でアイテムを取り出してみて、クラッシュしなければひとまずOK。

アイテムの外見を作る

アイテムの機能を作るには、今回の場合発射する弾Entityを作る必要があります。
そちらには少し時間がかかるので、先にアイテムの外見を作ることにしました。

Techneモデル

モデルは、私はTechneですべて作っています。
今回は別ゲームのネタだったので、そちらを起動して武器を眺めつつ、モデルをゴリゴリ作っていきます。

• モデルを作ってみよう

プロジェクトの新規作成を選び、ModelName(出力時に変更するので適当でOK)、キューブの組み合わせで作るつもりなのでBaseClassはModelBaseを選択し、TextureWidthとHeightは必要に応じて選択して下さい。今回はパーツが細かいのでテクスチャは64x32にしていますが、大きなパーツが複数含まれる場合は64x64以上にした方が良いと思います。(後から変えようとするのが少々面倒なので。)
画面はこんな感じ。

①Dimensions

キューブのサイズです。

②Position

キューブの回転中心です。モデルを回転させる際にバラバラにならないよう、私は基本は中心点(0, 16, 0)に統一して、部分的に回転させたい場合だけ回転中心を変えています。ただ、回転中心が異なるモデルでもバラバラにならないよう一つのモデルとして回転する方法もあります。

③Offset

回転中心からの距離です。

④TextureOffset

テクスチャの展開図(⑥)上のテクスチャ参照位置です。異なるテクスチャを持つパーツのテクスチャが重ならないよう、ここで設定します。

⑤Rotation

XYZ軸それぞれの回転です。②の回転中心を中心として、③の影響をうけつつ回転させます。

⑥テクスチャマップ

テクスチャ展開図です。このモデルでは小さすぎてよく見えませんが、右下のキューブ(R等と書いてある)のように、面ごとにデフォルトで色が付いているのでテクスチャを描く際の参考になります。

⑦新規キューブ作成ボタン

これを押すと新しいキューブを追加します。

Techneでモデルを作る際は注意することがあります。
まず、RotationでZ軸回転させてはいけない。不具合か分からないのですが、Techneとゲーム上で回転処理が異なっています。Z軸回転を使うと、ゲーム中では予期せぬ方向に曲がってしまうので、Z軸は封印してX軸とY軸の回転だけでやりくりする必要があります。
もう一つは、Techne上とゲーム中で、テクスチャの向きが若干異なること。Techne上でもテクスチャを読み込んで確認は出来ますが、凝った物を作るのであればゲーム中でも確認や調整は必要です。

• モデルを出力してみる

モデルは、まず完成したら上部のタブのFiles→Save Asから名前を付けて保存しましょう。拡張子は.tcnです。起動中はあるていど自動保存機能がありますが、保存を忘れると辛いことになります。
次に、Files→Export As→JavaでJavaソースとして出力します。これをMODのソースに組み込みます。
また、Files→Export As→Texture Mapでテクスチャ展開図を出力します。

Moddingで利用するのはJavaソースとテクスチャマップの2つです。