細 (ソースコード修正) |
(解説を修正。サンプルのupgradeIDを変更。langファイルによる形容詞の翻訳を必須に) |
||
(同じ利用者による、間の9版が非表示) | |||
9行目: | 9行目: | ||
=== ソースコード === | === ソースコード === | ||
− | |||
− | |||
==== SampleUpgradeCore.java ==== | ==== SampleUpgradeCore.java ==== | ||
+ | Modのコアとなるクラス | ||
<source lang = "java"> | <source lang = "java"> | ||
− | + | package mods.sample.upgrade; | |
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. | + | import net.minecraftforge.fml.common.event.FMLPreInitializationEvent; |
import dan200.computercraft.api.ComputerCraftAPI; | import dan200.computercraft.api.ComputerCraftAPI; | ||
− | @Mod(modid=SampleUpgradeCore. | + | @Mod( modid = SampleUpgradeCore.MOD_ID, |
− | name=SampleUpgradeCore. | + | name = SampleUpgradeCore.MOD_NAME, |
− | version=SampleUpgradeCore. | + | version = SampleUpgradeCore.MOD_VERSION, |
− | dependencies = | + | dependencies = SampleUpgradeCore.MOD_DEPENDENCIES, |
+ | acceptedMinecraftVersions = SampleUpgradeCore.MOD_ACCEPTED_MC_VERSIONS) | ||
public class SampleUpgradeCore { | public class SampleUpgradeCore { | ||
− | public static final String | + | public static final String MOD_ID = "sampleupgrademod"; |
− | public static final String | + | public static final String MOD_NAME = "Sample Upgrade Mod"; |
− | public static final String | + | 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 | @EventHandler | ||
− | public void | + | public void preInit(FMLPreInitializationEvent event) { |
+ | // Turtle Upgradeの登録 | ||
ComputerCraftAPI.registerTurtleUpgrade(new TurtleSample()); | ComputerCraftAPI.registerTurtleUpgrade(new TurtleSample()); | ||
} | } | ||
39行目: | 42行目: | ||
==== TurtleSample.java ==== | ==== TurtleSample.java ==== | ||
+ | Turtle Upgradeの機能を定義するクラス | ||
<source lang = "java"> | <source lang = "java"> | ||
− | + | package mods.sample.upgrade; | |
import javax.vecmath.Matrix4f; | import javax.vecmath.Matrix4f; | ||
65行目: | 69行目: | ||
public class TurtleSample implements ITurtleUpgrade { | public class TurtleSample implements ITurtleUpgrade { | ||
− | private ResourceLocation upgradeID = new ResourceLocation(SampleUpgradeCore. | + | // Turtle UpgradeのID |
− | private ItemStack upgradeItem = new ItemStack(Items.stick); | + | 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 | @Override | ||
public ResourceLocation getUpgradeID() { | public ResourceLocation getUpgradeID() { | ||
73行目: | 81行目: | ||
} | } | ||
+ | // Minecraft 1.7.10やそれ以前のワールドからTurtle Upgradeを引き継ぐ場合は、そのTurtle Upgradeと同じIDを返す | ||
+ | // 引き継ぐ必要がない場合は-1を返す | ||
@Override | @Override | ||
public int getLegacyUpgradeID() { | public int getLegacyUpgradeID() { | ||
78行目: | 88行目: | ||
} | } | ||
+ | // 装着したTurtleのアイテム名に付加される形容詞を返す(『○○ Turtle』の○○の部分) | ||
+ | // 戻り値は(設定されていれば)langファイルによる翻訳を経てゲーム内に表示される | ||
@Override | @Override | ||
public String getUnlocalisedAdjective() { | public String getUnlocalisedAdjective() { | ||
− | return " | + | return "turtle.sample_tool.adjective"; |
} | } | ||
+ | // Turtle Upgradeの種類の指定 | ||
@Override | @Override | ||
public TurtleUpgradeType getType() { | public TurtleUpgradeType getType() { | ||
+ | // ツールタイプを指定 | ||
return TurtleUpgradeType.Tool; | return TurtleUpgradeType.Tool; | ||
} | } | ||
+ | // Turtle Upgradeの装着に必要なアイテムを返す | ||
@Override | @Override | ||
public ItemStack getCraftingItem() { | public ItemStack getCraftingItem() { | ||
93行目: | 108行目: | ||
} | } | ||
+ | // 周辺機器クラスのインスタンスを生成して返す | ||
@Override | @Override | ||
public IPeripheral createPeripheral(ITurtleAccess turtle, TurtleSide side) { | public IPeripheral createPeripheral(ITurtleAccess turtle, TurtleSide side) { | ||
+ | // ツールタイプではnullを返す | ||
return null; | return null; | ||
} | } | ||
+ | // ツールタイプTurtle Upgradeの処理 | ||
+ | // ゲーム内でturtle.dig()やturtle.attack()が呼び出された時に呼ばれる | ||
@Override | @Override | ||
public TurtleCommandResult useTool(ITurtleAccess turtle, TurtleSide side, | public TurtleCommandResult useTool(ITurtleAccess turtle, TurtleSide side, | ||
TurtleVerb verb, EnumFacing direction) { | TurtleVerb verb, EnumFacing direction) { | ||
+ | // 呼び出された動作それぞれの処理を行う | ||
switch(verb) { | switch(verb) { | ||
− | case Dig: | + | case Dig: // turtle.dig系 |
return dig(turtle, direction); | return dig(turtle, direction); | ||
− | case Attack: | + | case Attack: // turtle.attack系 |
return attack(turtle, direction); | return attack(turtle, direction); | ||
} | } | ||
+ | // 対応する動作が無かったとき「失敗」とメッセージを返す(CC1.76の時点でこのサンプルでは到達しないはず) | ||
return TurtleCommandResult.failure("Undefined command"); | return TurtleCommandResult.failure("Undefined command"); | ||
} | } | ||
+ | // Turtle Upgradeのモデルと変形行列のペアを返す | ||
+ | // Turtle Upgradeの外見を描画するためクライアント側で毎描画フレーム呼び出される | ||
@Override | @Override | ||
@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の左または右側に描画するための変形行列を作成 | ||
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( | ||
121行目: | 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(); | ||
+ | // アイテムのモデルを取得 | ||
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); | ||
} | } | ||
+ | // Tick毎の処理 | ||
@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の値で判別可能 | ||
} | } | ||
+ | // ゲーム内からturtle.dig系が呼び出された時の処理 | ||
+ | // 動作が成功した時はTurtleCommandResult.successを、失敗した時はTurtleCommandResult.failureを返す | ||
private TurtleCommandResult dig(ITurtleAccess turtle, EnumFacing direction) { | private TurtleCommandResult dig(ITurtleAccess turtle, EnumFacing direction) { | ||
+ | // このサンプルでは単に「成功」と動作の方向を表す文字列を返す | ||
return TurtleCommandResult.success(new Object[] {"DIG to " + direction.getName()}); | return TurtleCommandResult.success(new Object[] {"DIG to " + direction.getName()}); | ||
} | } | ||
+ | // ゲーム内からturtle.attack系が呼び出された時の処理 | ||
+ | // 動作が成功した時はTurtleCommandResult.successを、失敗した時はTurtleCommandResult.failureを返す | ||
private TurtleCommandResult attack(ITurtleAccess turtle, EnumFacing direction) { | private TurtleCommandResult attack(ITurtleAccess turtle, EnumFacing direction) { | ||
+ | // このサンプルでは単に「成功」と動作の方向を表す文字列を返す | ||
return TurtleCommandResult.success(new Object[] {"ATTACK to " + direction.getName()}); | return TurtleCommandResult.success(new Object[] {"ATTACK to " + direction.getName()}); | ||
} | } | ||
} | } | ||
+ | |||
</source> | </source> | ||
− | === | + | ==== en_US.lang ==== |
− | + | アメリカ英語(デフォルト言語)のlangファイル<br /> | |
− | + | assets\sampleupgrademod\lang ディレクトリに設置します。 | |
− | + | <source lang="ini"> | |
− | + | ||
− | <source lang = " | + | turtle.sample_tool.adjective=Sample |
− | |||
</source> | </source> | ||
− | |||
− | + | このTurtle UpgradeをTurtleに装着した際、そのTurtleのアイテム名が「Sample Turtle」のようになります。 | |
− | |||
− | |||
− | |||
− | |||
− | |||
+ | === 解説 === | ||
==== TurtleSample.java ==== | ==== TurtleSample.java ==== | ||
− | + | *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()の戻り値と言語ファイルによる翻訳 | |
+ | 戻り値はlangファイルによる翻訳も可能です(ゲーム内で表示される前にComputerCraftによってStatCollector#translateToLocalで処理されるため)。<br /> | ||
+ | 例えば、以下のようなlangファイル(UTF-8で保存)を assets\<mod_id>\lang\ja_JP.lang に置いて"turtle.sample_tool.adjective"を返した場合、Minecraftの言語設定が日本語のときに「サンプル Turtle」のように表示されます。 | ||
+ | | ||
+ | turtle.sample_tool.adjective=サンプル | ||
− | * | + | *useTool()と戻り値について |
− | + | useTool()はゲーム内で実行されたluaプログラムに従って呼び出されますが、例えばブロックを掘ったりmobを攻撃したりというような処理はすべて自分で実装する必要があります(逆に言えば、「掘る」「攻撃する」にとらわれず自由に実装できるということでもあります)。<br /> | |
− | |||
− | |||
− | + | 戻り値は行動成功時にはTurtleCommandResult.success()、失敗時にはTurtleCommandResult.failure()を返します。<br /> | |
+ | TurtleCommandResult.success()ではObject[]で追加のパラメータ(値はIPeripheral#callMethodと同様にLuaの型へ変換されます)を、TurtleCommandResult.failure()では文字列で失敗理由を同時に返すことも可能です。 |
2016年5月4日 (水) 11:27時点における最新版
この記事は"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()では文字列で失敗理由を同時に返すことも可能です。