提供: Minecraft Modding Wiki
移動先: 案内検索
(解説をできるだけソースコード内のコメントへ移動)
(解説を修正。サンプルのupgradeIDを変更。langファイルによる形容詞の翻訳を必須に)
 
(同じ利用者による、間の3版が非表示)
16行目: 16行目:
 
import net.minecraftforge.fml.common.Mod;
 
import net.minecraftforge.fml.common.Mod;
 
import net.minecraftforge.fml.common.Mod.EventHandler;
 
import net.minecraftforge.fml.common.Mod.EventHandler;
import net.minecraftforge.fml.common.event.FMLInitializationEvent;
+
import net.minecraftforge.fml.common.event.FMLPreInitializationEvent;
 
import dan200.computercraft.api.ComputerCraftAPI;
 
import dan200.computercraft.api.ComputerCraftAPI;
  
33行目: 33行目:
  
 
@EventHandler
 
@EventHandler
public void init(FMLInitializationEvent event) {
+
public void preInit(FMLPreInitializationEvent event) {
 
// Turtle Upgradeの登録
 
// Turtle Upgradeの登録
 
ComputerCraftAPI.registerTurtleUpgrade(new TurtleSample());
 
ComputerCraftAPI.registerTurtleUpgrade(new TurtleSample());
70行目: 70行目:
  
 
// Turtle UpgradeのID
 
// Turtle UpgradeのID
private ResourceLocation upgradeID = new ResourceLocation(SampleUpgradeCore.MOD_ID, "sample");
+
private final ResourceLocation upgradeID = new ResourceLocation(SampleUpgradeCore.MOD_ID, "sample_tool");
 
// Turtle Upgradeの装着に必要なアイテム。ここではバニラアイテムの棒
 
// Turtle Upgradeの装着に必要なアイテム。ここではバニラアイテムの棒
private ItemStack upgradeItem = new ItemStack(Items.stick);
+
private final ItemStack upgradeItem = new ItemStack(Items.stick);
  
 
// Turtle UpgradeのIDをResourceLocationで指定
 
// Turtle UpgradeのIDをResourceLocationで指定
88行目: 88行目:
 
}
 
}
  
// Turtle Upgradeを装着したTurtleのアイテム名に付加される形容詞を返す
+
// 装着したTurtleのアイテム名に付加される形容詞を返す(『○○ Turtle』の○○の部分)
 +
// 戻り値は(設定されていれば)langファイルによる翻訳を経てゲーム内に表示される
 
@Override
 
@Override
 
public String getUnlocalisedAdjective() {
 
public String getUnlocalisedAdjective() {
// この例では"Sample Turtle"になる
+
return "turtle.sample_tool.adjective";
return "Sample";
 
 
}
 
}
  
102行目: 102行目:
 
}
 
}
  
 +
// Turtle Upgradeの装着に必要なアイテムを返す
 
@Override
 
@Override
 
public ItemStack getCraftingItem() {
 
public ItemStack getCraftingItem() {
127行目: 128行目:
 
}
 
}
  
// 上に対応する動作が無かったとき「失敗」とメッセージを返す(CC1.76の時点でこのサンプルでは到達しないはず)
+
// 対応する動作が無かったとき「失敗」とメッセージを返す(CC1.76の時点でこのサンプルでは到達しないはず)
 
return TurtleCommandResult.failure("Undefined command");
 
return TurtleCommandResult.failure("Undefined command");
 
}
 
}
136行目: 137行目:
 
@SideOnly(Side.CLIENT)
 
@SideOnly(Side.CLIENT)
 
public Pair<IBakedModel, Matrix4f> getModel(ITurtleAccess turtle, TurtleSide side) {
 
public Pair<IBakedModel, Matrix4f> getModel(ITurtleAccess turtle, TurtleSide side) {
// アイテムモデルをTurtleの左または右側に描画するための変形行列を作成
+
// アイテムのモデルをTurtleの左または右側に描画するための変形行列を作成
 
float xOffset = (side == TurtleSide.Left) ? -0.40625F : 0.40625F;
 
float xOffset = (side == TurtleSide.Left) ? -0.40625F : 0.40625F;
 
Matrix4f transform = new Matrix4f(
 
Matrix4f transform = new Matrix4f(
144行目: 145行目:
 
0.0F, 0.0F, 0.0F, 1.0F);
 
0.0F, 0.0F, 0.0F, 1.0F);
 
Minecraft mc = Minecraft.getMinecraft();
 
Minecraft mc = Minecraft.getMinecraft();
// ItemStackからアイテムモデルを取得
+
// アイテムのモデルを取得
 
IBakedModel model = mc.getRenderItem().getItemModelMesher().getItemModel(upgradeItem);
 
IBakedModel model = mc.getRenderItem().getItemModelMesher().getItemModel(upgradeItem);
 +
// 返したモデルはTurtleのTileEntitySpecialRenderer内で描画される
 
return Pair.of(model, transform);
 
return Pair.of(model, transform);
 
}
 
}
152行目: 154行目:
 
@Override
 
@Override
 
public void update(ITurtleAccess turtle, TurtleSide side) {
 
public void update(ITurtleAccess turtle, TurtleSide side) {
 
+
// 毎tickこのクラスで定義したTurtle Upgradeの装着数×2(Server側とClient側の分)回呼び出される
 +
// どのTurtle Upgradeに対するupdateなのかはパラメータのturtleとsideで判別可能
 +
// またServerとClientのどちら側の呼び出しなのかはturtle.getWorld().isRemoteの値で判別可能
 
}
 
}
  
172行目: 176行目:
  
 
</source>
 
</source>
 +
 +
==== en_US.lang ====
 +
アメリカ英語(デフォルト言語)のlangファイル<br />
 +
assets\sampleupgrademod\lang ディレクトリに設置します。
 +
<source lang="ini">
 +
 +
turtle.sample_tool.adjective=Sample
 +
</source>
 +
 +
このTurtle UpgradeをTurtleに装着した際、そのTurtleのアイテム名が「Sample Turtle」のようになります。
  
 
=== 解説 ===
 
=== 解説 ===
 
==== TurtleSample.java ====
 
==== TurtleSample.java ====
このクラスで定義されTurtleに装着されたTurtle Upgradeの処理はすべてComputerCraftに登録された単一のインスタンス内で行われます。
+
*ComputerCraftに登録したTurtle UpgradeのインスタンスとTurtle Upgradeの処理について
 +
ここで定義したTurtle Upgradeの処理は、すべてComputerCraftに登録した単一のインスタンス内で行われます(ブロックやアイテムの定義クラスと似たような感じです)。<br />
 +
Turtleに装着した個々のTurtle Upgradeごとにインスタンスが作られるわけではないので、一部のメソッドではパラメータのITurtleAccessとTurtleSideの値からどのTurtle Upgradeに対する呼び出しなのかを判別して処理を行う必要があります。<br />
 +
個々のTurtle Upgrade固有のデータを保存するためには[[ComputerCraft_API/1.65/UpgradeNBTDataの利用|UpgradeNBTData]]を利用することもできます。
  
 
*getUnlocalisedAdjective()の戻り値と言語ファイルによる翻訳
 
*getUnlocalisedAdjective()の戻り値と言語ファイルによる翻訳
戻り値はゲーム内で表示される前にComputerCraftによってStatCollector#translateToLocalで処理されるため、langファイルによる翻訳も可能です。<br />
+
戻り値はlangファイルによる翻訳も可能です(ゲーム内で表示される前にComputerCraftによってStatCollector#translateToLocalで処理されるため)。<br />
例えば、以下のようなlangファイル(UTF-8で保存)を assets\<mod_id>\lang\ja_JP.lang に置いて"Sample"を返した場合、Minecraftの言語設定が日本語のときに「サンプル Turtle」のように表示されます。
+
例えば、以下のようなlangファイル(UTF-8で保存)を assets\<mod_id>\lang\ja_JP.lang に置いて"turtle.sample_tool.adjective"を返した場合、Minecraftの言語設定が日本語のときに「サンプル Turtle」のように表示されます。
 
  &nbsp;
 
  &nbsp;
  Sample=サンプル
+
  turtle.sample_tool.adjective=サンプル
  
*useTool()の戻り値について
+
*useTool()と戻り値について
戻り値は行動成功時にはTurtleCommandResult.success()、失敗時にはTurtleCommandResult.failure()を返します。<br>
+
useTool()はゲーム内で実行されたluaプログラムに従って呼び出されますが、例えばブロックを掘ったりmobを攻撃したりというような処理はすべて自分で実装する必要があります(逆に言えば、「掘る」「攻撃する」にとらわれず自由に実装できるということでもあります)。<br />
TurtleCommandResult.success()ではObject[]で追加パラメータ(値はIPeripheral#callMethodと同様にLuaの型へ変換されます)を、TurtleCommandResult.failure()では文字列で失敗理由を同時に返すことも可能です。
 
  
*update()
+
戻り値は行動成功時にはTurtleCommandResult.success()、失敗時にはTurtleCommandResult.failure()を返します。<br />
Turtle UpgradeがTurtleに装着されている間、毎tick呼び出されます。<br>
+
TurtleCommandResult.success()ではObject[]で追加のパラメータ(値はIPeripheral#callMethodと同様にLuaの型へ変換されます)を、TurtleCommandResult.failure()では文字列で失敗理由を同時に返すことも可能です。
前述の通り、ロードされているチャンク内で装着されている数だけ呼び出されますが、各パラメータでどれに対する呼び出しなのかが判別可能です。<br>
 
また、サーバ側とクライアント側でそれぞれ別に呼び出されますが、どちら側の呼び出しなのかはturtle.getWorld().isRemoteの値で判別可能です。
 

2016年5月4日 (水) 11:27時点における最新版

ComputerCraft API >

この記事は"Minecraft Forge Universal 10.14.4.x~"及び"ComputerCraft 1.76~"を前提MODとしています。

ツールタイプTurtleの追加[編集]

ツールタイプのTurtle Upgradeを追加します。

  • ITurtleUpgrade(ツールタイプ)の実装
  • TurtleUpgradeの登録

ソースコード[編集]

SampleUpgradeCore.java[編集]

Modのコアとなるクラス

package mods.sample.upgrade;

import net.minecraftforge.fml.common.Mod;
import net.minecraftforge.fml.common.Mod.EventHandler;
import net.minecraftforge.fml.common.event.FMLPreInitializationEvent;
import dan200.computercraft.api.ComputerCraftAPI;

@Mod(	modid = SampleUpgradeCore.MOD_ID,
	name = SampleUpgradeCore.MOD_NAME,
	version = SampleUpgradeCore.MOD_VERSION,
	dependencies = SampleUpgradeCore.MOD_DEPENDENCIES,
	acceptedMinecraftVersions = SampleUpgradeCore.MOD_ACCEPTED_MC_VERSIONS)
public class SampleUpgradeCore {

	public static final String MOD_ID = "sampleupgrademod";
	public static final String MOD_NAME = "Sample Upgrade Mod";
	public static final String MOD_VERSION = "1.0";
	public static final String MOD_DEPENDENCIES = "required-after:ComputerCraft";	// 前提MODとしてComputerCraftを要求
	public static final String MOD_ACCEPTED_MC_VERSIONS = "[1.8,1.8.9]";	// Minecraft 1.8~1.8.9でのみ起動可能

	@EventHandler
	public void preInit(FMLPreInitializationEvent event) {
		// Turtle Upgradeの登録
		ComputerCraftAPI.registerTurtleUpgrade(new TurtleSample());
	}

}

TurtleSample.java[編集]

Turtle Upgradeの機能を定義するクラス

package mods.sample.upgrade;

import javax.vecmath.Matrix4f;

import net.minecraft.client.Minecraft;
import net.minecraft.client.resources.model.IBakedModel;
import net.minecraft.init.Items;
import net.minecraft.item.ItemStack;
import net.minecraft.util.EnumFacing;
import net.minecraft.util.ResourceLocation;
import net.minecraftforge.fml.relauncher.Side;
import net.minecraftforge.fml.relauncher.SideOnly;

import org.apache.commons.lang3.tuple.Pair;

import dan200.computercraft.api.peripheral.IPeripheral;
import dan200.computercraft.api.turtle.ITurtleAccess;
import dan200.computercraft.api.turtle.ITurtleUpgrade;
import dan200.computercraft.api.turtle.TurtleCommandResult;
import dan200.computercraft.api.turtle.TurtleSide;
import dan200.computercraft.api.turtle.TurtleUpgradeType;
import dan200.computercraft.api.turtle.TurtleVerb;

public class TurtleSample implements ITurtleUpgrade {

	// Turtle UpgradeのID
	private final ResourceLocation upgradeID = new ResourceLocation(SampleUpgradeCore.MOD_ID, "sample_tool");
	// Turtle Upgradeの装着に必要なアイテム。ここではバニラアイテムの棒
	private final ItemStack upgradeItem = new ItemStack(Items.stick);

	// Turtle UpgradeのIDをResourceLocationで指定
	// 他のTurtle Upgradeと重複しないようにする
	@Override
	public ResourceLocation getUpgradeID() {
		return upgradeID;
	}

	// Minecraft 1.7.10やそれ以前のワールドからTurtle Upgradeを引き継ぐ場合は、そのTurtle Upgradeと同じIDを返す
	// 引き継ぐ必要がない場合は-1を返す
	@Override
	public int getLegacyUpgradeID() {
		return -1;
	}

	// 装着したTurtleのアイテム名に付加される形容詞を返す(『○○ Turtle』の○○の部分)
	// 戻り値は(設定されていれば)langファイルによる翻訳を経てゲーム内に表示される
	@Override
	public String getUnlocalisedAdjective() {
		return "turtle.sample_tool.adjective";
	}

	// Turtle Upgradeの種類の指定
	@Override
	public TurtleUpgradeType getType() {
		// ツールタイプを指定
		return TurtleUpgradeType.Tool;
	}

	// Turtle Upgradeの装着に必要なアイテムを返す
	@Override
	public ItemStack getCraftingItem() {
		return upgradeItem;
	}

	// 周辺機器クラスのインスタンスを生成して返す
	@Override
	public IPeripheral createPeripheral(ITurtleAccess turtle, TurtleSide side) {
		// ツールタイプではnullを返す
		return null;
	}

	// ツールタイプTurtle Upgradeの処理
	// ゲーム内でturtle.dig()やturtle.attack()が呼び出された時に呼ばれる
	@Override
	public TurtleCommandResult useTool(ITurtleAccess turtle, TurtleSide side,
			TurtleVerb verb, EnumFacing direction) {
		// 呼び出された動作それぞれの処理を行う
		switch(verb) {
		case Dig:	// turtle.dig系
			return dig(turtle, direction);
		case Attack:	// turtle.attack系
			return attack(turtle, direction);
		}

		// 対応する動作が無かったとき「失敗」とメッセージを返す(CC1.76の時点でこのサンプルでは到達しないはず)
		return TurtleCommandResult.failure("Undefined command");
	}

	// Turtle Upgradeのモデルと変形行列のペアを返す
	// Turtle Upgradeの外見を描画するためクライアント側で毎描画フレーム呼び出される
	@Override
	@SideOnly(Side.CLIENT)
	public Pair<IBakedModel, Matrix4f> getModel(ITurtleAccess turtle, TurtleSide side) {
		// アイテムのモデルをTurtleの左または右側に描画するための変形行列を作成
		float xOffset = (side == TurtleSide.Left) ? -0.40625F : 0.40625F;
		Matrix4f transform = new Matrix4f(
				0.0F, 0.0F, -1.0F, 1.0F + xOffset,
				1.0F, 0.0F, 0.0F, 0.0F,
				0.0F, -1.0F, 0.0F, 1.0F,
				0.0F, 0.0F, 0.0F, 1.0F);
		Minecraft mc = Minecraft.getMinecraft();
		// アイテムのモデルを取得
		IBakedModel model = mc.getRenderItem().getItemModelMesher().getItemModel(upgradeItem);
		// 返したモデルはTurtleのTileEntitySpecialRenderer内で描画される
		return Pair.of(model, transform);
	}

	// Tick毎の処理
	@Override
	public void update(ITurtleAccess turtle, TurtleSide side) {
		// 毎tickこのクラスで定義したTurtle Upgradeの装着数×2(Server側とClient側の分)回呼び出される
		// どのTurtle Upgradeに対するupdateなのかはパラメータのturtleとsideで判別可能
		// またServerとClientのどちら側の呼び出しなのかはturtle.getWorld().isRemoteの値で判別可能
	}

	// ゲーム内からturtle.dig系が呼び出された時の処理
	// 動作が成功した時はTurtleCommandResult.successを、失敗した時はTurtleCommandResult.failureを返す
	private TurtleCommandResult dig(ITurtleAccess turtle, EnumFacing direction) {
		// このサンプルでは単に「成功」と動作の方向を表す文字列を返す
		return TurtleCommandResult.success(new Object[] {"DIG to " + direction.getName()});
	}

	// ゲーム内からturtle.attack系が呼び出された時の処理
	// 動作が成功した時はTurtleCommandResult.successを、失敗した時はTurtleCommandResult.failureを返す
	private TurtleCommandResult attack(ITurtleAccess turtle, EnumFacing direction) {
		// このサンプルでは単に「成功」と動作の方向を表す文字列を返す
		return TurtleCommandResult.success(new Object[] {"ATTACK to " + direction.getName()});
	}

}

en_US.lang[編集]

アメリカ英語(デフォルト言語)のlangファイル
assets\sampleupgrademod\lang ディレクトリに設置します。

turtle.sample_tool.adjective=Sample

このTurtle UpgradeをTurtleに装着した際、そのTurtleのアイテム名が「Sample Turtle」のようになります。

解説[編集]

TurtleSample.java[編集]

  • ComputerCraftに登録したTurtle UpgradeのインスタンスとTurtle Upgradeの処理について

ここで定義したTurtle Upgradeの処理は、すべてComputerCraftに登録した単一のインスタンス内で行われます(ブロックやアイテムの定義クラスと似たような感じです)。
Turtleに装着した個々のTurtle Upgradeごとにインスタンスが作られるわけではないので、一部のメソッドではパラメータのITurtleAccessとTurtleSideの値からどのTurtle Upgradeに対する呼び出しなのかを判別して処理を行う必要があります。
個々のTurtle Upgrade固有のデータを保存するためにはUpgradeNBTDataを利用することもできます。

  • getUnlocalisedAdjective()の戻り値と言語ファイルによる翻訳

戻り値はlangファイルによる翻訳も可能です(ゲーム内で表示される前にComputerCraftによってStatCollector#translateToLocalで処理されるため)。
例えば、以下のようなlangファイル(UTF-8で保存)を assets\<mod_id>\lang\ja_JP.lang に置いて"turtle.sample_tool.adjective"を返した場合、Minecraftの言語設定が日本語のときに「サンプル Turtle」のように表示されます。

 
turtle.sample_tool.adjective=サンプル
  • useTool()と戻り値について

useTool()はゲーム内で実行されたluaプログラムに従って呼び出されますが、例えばブロックを掘ったりmobを攻撃したりというような処理はすべて自分で実装する必要があります(逆に言えば、「掘る」「攻撃する」にとらわれず自由に実装できるということでもあります)。

戻り値は行動成功時にはTurtleCommandResult.success()、失敗時にはTurtleCommandResult.failure()を返します。
TurtleCommandResult.success()ではObject[]で追加のパラメータ(値はIPeripheral#callMethodと同様にLuaの型へ変換されます)を、TurtleCommandResult.failure()では文字列で失敗理由を同時に返すことも可能です。