「Crafting and Smelting」を編集中

このページはForge wiki内の[http://www.minecraftforge.net/wiki/Crafting_and_Smelting Crafting and Smelting Tutorial]の翻訳記事です。多くが意訳で、雑な翻訳であること、見やすさに応じて太字などは独自に変えられている場合がありますのでご注意ください。Javaの一般的な知識に関する項目、Minecraftの上で一般的な知識は訳していません。

=Havvy's Minecraft Forge Tutorials(Crafting and Smelting)=
BaseModクラスの準備ができたら、レシピの追加は簡単に出来ます。レシピには３つのクラスがあります。形のあるもの、形のないもの、そして精錬のレシピです。

==一般的なクラフティングの知識==
レシピの追加は@Initアノテーションの追加されたメソッドで行われます。GenericModでは、tutorial.generic.Genericのloadメソッドに当たります。この章の最後では、完成形のGenericクラスと、クラフティングレシピのクラスのファイルをご覧に入れましょう。

クラフティングに関するメソッドはスタティックメソッドです。GameRegistryの中にあり、CraftingManagerにデータを渡します。

===アイテムスタック===
ItemStackは、スタックできる量と、使った際にダメージを持つかどうか(ピッケルなど)による、いくつかのコンストラクターを持っています。

====単数所持、ダメージを持たない====
１つのみスタックできて、ダメージを持たないアイテムの場合、設定は簡単なので、１つしか引数は取りません。
<source lang="java">
ItemStack dirtStack = new ItemStack(Block.dirt);
</source>
上のコードは一つのブロックを持つDirtのサンプルです。

====複数所持、ダメージを持たない====
複数スタックできるアイテムの場合は、以下の様なコードで設定出来ます。
<source lang="java">
ItemStack diamondsStack = new ItemStack(Item.diamond, 64);
</source>
これは、フルスタックのダイアモンドを指します。

====ダメージを保つ場合====
もしダメージもしくはメタデータの値を含ませたいのならば、量を含ませる必要があります。
<source lang="java">
ItemStack blackWoolStack = new ItemStack(Block.cloth, 42, 15);
</source>
ウールはMinecraftのコードの中ではclothと呼ばれています。この例の場合、15というメタデータが黒を指すので、42個の黒いウールとなります。

====item idしか知らない場合====
ブロックのインスタンスへの参照がわからなくても、ブロックIDがわかれば、別のコンストラクタが使えます。しかし、おすすめはしません。
<source lang="java">
ItemStack unknownItemStack = new ItemStack(1, 3, 0);
</source>
3つで構成されるスタックで、ブロックのidが1のDirtを指します。しかし、インスタンスへの参照をとることを試みるべきでしょう。バニラの全てのアイテムとブロックは、net.minecraft.block.Blockもしくは、net.minecraft.item.Item内に見つかります。

==形のないクラフティング==
形のないクラフティングは、アイテムの並び方を気にしません。一般的な例は、きのこスープと本でしょう。一般的に形のないレシピの追加は以下を使います。
<source lang="java">
GameRegistry.addShapelessRecipe(ItemStack result, Object... recipe)
</source>
例えば、以下のようにして土をダイヤモンドに交換出来ます。
<source lang="java">
GameRegistry.addShapelessRecipe(new ItemStack(Item.diamond, 64), new ItemStack(Block.dirt));
</source>
もしレシピに複数のアイテムを要求したいのであれば、より多くのItemStacksをクことができます。同じアイテムを複数置きたいなら、ItemStackをまた置けばいいだけなのです。以下に例として、砂とじゃりと丸石と６個の土を使ったレシピの追加法を示します。
<source lang="java">
ItemStack dirtStack = new ItemStack(Block.dirt);
GameRegistry.addShapelessRecipe(new ItemStack(Item.diamond, 64),
                dirtStack, dirtStack, dirtStack,
                dirtStack, dirtStack, dirtStack,
                new ItemStack(Block.sand), gravelStack, cobbleStack);
</source>

==形のあるクラフティング==
1*1から3*3の全てのレシピには、文字列がレシピの形とアイテムの種類を使い、以下のメソッドを用います。
<source lang="java">
GameRegistry.addRecipe(String row1, [String row2[, String row3]]
        char itemType1, ItemStack itemStackType1[, ... char itemTypeN, ItemStack itemStackTypeN]);
</source>
おそらく、混乱するでしょう、そこでいくつかの例を上げわかりやすくして行きたいと思います。2*2の土とじゃりをそれぞれのカドに配置したレシピを作る際は以下のようになります。
<source lang="java">
ItemStack dirtStack = new ItemStack(Block.dirt);
ItemStack gravelStack = new ItemStack(Block.gravel);

GameRegistry.addRecipe(new ItemStack(Block.cobblestone), "xy", "yx", 
        'x', dirtStack, 'y', gravelStack);
</source>
改行されたあとのコードはレシピのアイテムを読める形で示しています。レシピの中に使わない場所を設ける際にはどうしたら良いでしょうか。スペース(" ")がこの役割を担います。
このことを示すために、土とじゃりでかこんだレシピは以下になります。
<source lang="java">
GameRegistry.addRecipe(new ItemStack(Block.stone), "xyx", "y y", "xyx",
        'x', dirtStack, 'y', gravelStack);
</source>
==精錬のレシピ==
精錬のレシピは３つの中で最も簡単です。これは、１ついれたら１つ出てくるというわかりやすい方式だからです。精錬に対するメソッドは以下のようになります。
<source lang="java">
GameRegistry.addSmelting(int inputItemID, ItemStack result, float experience);
</source>
ここで解説しなければならないのは２つの値です。ItemIDとexperienceです。itemIDはブロックのidを指します。ブロックのインスタンスがあるなら、すべてのブロックはblockIDフィールドを持つので利用できます。