レシピの追加

この記事は"ModLoader1.2.3以降"を前提MODとしています。

作成するソース
mod_Tutorial.java

全体の完成形

package net.minecraft.src;
 
 public class mod_Tutorial extends BaseMod {
    
    public String getVersion() {
       return "1.0.0";
    } 
    public void load() {       
       ModLoader.addRecipe(new ItemStack(Item.diamond, 4), 
                           "X","X","X",
                           'X',Block.dirt);

　　   /*
       ここは不定形レシピを作るときに使います。
       作らないのであれば削除してください。
       */
       ModLoader.addShapelessRecipe(new ItemStack(Item.diamond,1),
                           new ItemStack(Block.dirt, 1), new ItemStack(Block.sand, 1));

    }   
 }

レシピを作る

ModLoader.addRecipe(new ItemStack(Item.diamond, 4), 
                     new Object[]{ "X","X","X",
                     Character.valueOf('X'),Block.dirt });

レシピを指定してる部分はこの部分です。
ModLoader.addRecipeで形が決まったレシピでこれを作りますよ！というのを決めています。
(new itemStack(追加アイテム名,一度に作れる数))となっています。
今回の場合　土を縦に３つ並べるとダイヤモンドというアイテムを４個出すというプログラムになっています。

new Object[]{

この後の文がレシピの形を決めています。分かりやすく見せると、

"000"
 "000"
 "000"

このように配置が決まっています。
何も入れない部分は半角空白、素材を入れる部分は任意の文字を入れてください。同じ文字は同じパーツと判断されます。
空白を入れなかった場合、ワークベンチに収まればそれで作れるようになってしまいます。
"XX"とした場合、　"XX0"または"0XX"というように認識されます。指定は３段でなくても問題ありません。
そのように指定したら、次はその文字がどんなパーツかを指定します。

Character.valueOf('X'),Block.dirt });

valueOfの後の中の文字が指定したパーツの文字、その次が素材になります。
ブロックが素材の場合Block、置けないアイテムの場合Item、になります。
そのあとのアイテムの種類は、ゲームでよく呼ばれる名前とは違う場合があります。
Item.javaやBlock.javaにリストのような部分があったりしますので、そこに書いてある名前を参考にしてください。
複数素材がある場合、１つ指定した後に　,　で区切って次のパーツを指定してください。
また、ダメージ値(炭、羊毛など)を指定したい場合、

Character.valueOf('X'),new ItemStack(Item.coal, 1, 0) });

というように記述します。

例として、石ピッケルのレシピの形を作る場合、こうなります。

ModLoader.addRecipe(new ItemStack(ttrPickaxe,1),
                     new Object[]{"XXX"," Y "," Y ",
                     Character.valueOf('X'),Block.stone,Character.valueOf('Y'),Item.stick});

レシピ素材の省略表記

Minecraft1.2.5 にて Character.valueOf(char) の指定が不要になっています。
いつから省略可能だったかは不明ですが、1.3.x以降も省略表記可能です。

ModLoader.addRecipe(new ItemStack(Item.diamond, 4), 
                     new Object[]{ "X","X","X", 'X',Block.dirt });

不定形レシピを作る

上記のレシピに対して配置は関係ないレシピの作り方です。

ModLoader.addShapelessRecipe(new ItemStack(Item.diamond,1),
            new Object[]{
            new ItemStack(Block.dirt, 1), new ItemStack(Block.sand, 1)});

ここがレシピを指定している部分です。
ModLoader.addShapelessRecipeで不定形レシピを作ることを宣言しています。
ここでは、土ブロック(Block.dirt, 1)と砂ブロック(Block.sand, 1)でダイヤ(Item.diamond,1)ができるように書いてあります。

レシピはこれで終わりです。
追加アイテムがあればそれを作るレシピも作れます。詳しくは無機能のアイテムを追加するをご覧ください。

API例と解説

例）焼き石と木の棒から石ピッケルを作成

ModLoader.addRecipe(new ItemStack(Item.pickaxeStone,1),
    new Object[]{"XXX"," Y "," Y ",
    Character.valueOf('X'),Block.stone,Character.valueOf('Y'),Item.stick});

• 一般的な定型レシピ

例）赤羊毛と黒羊毛から、茶色羊毛を2個作成

ModLoader.addShapelessRecipe(new ItemStack(Block.cloth,2,12),
    new Object[]{
    new ItemStack(Block.cloth,1,14), new ItemStack(Block.cloth,1,15)});

例）木材1つと石炭（木炭）2個から、松明を8つ作成

ModLoader.addShapelessRecipe(new ItemStack(Block.torchWood,8),
    new Object[]{
    new ItemStack(Item.coal,1,-1), new ItemStack(Item.coal,1,-1), new ItemStack(Block.planks,1,-1)});

• ダメージ値を指定したレシピを作る場合、ItemStackクラスを使用する。
  • ItemStack(アイテム名,個数,ダメージ値)　ダメージ値は省略可能（省略時は0）、個数は材料指定時には無効。
    • 不定形レシピで同じアイテムを2個以上使いたい場合、個数1で2回指定する必要がある点に注意。
  • ダメージ値に関わらずレシピに使用する（例えば全ての木材で作成可能にする）には、ダメージ値に「-1」を指定する。
• ダメージ値は、ブロックは0～15、アイテムは0-32000まで設定可能。
  • 耐久力のあるアイテムの場合、ダメージ値は最大で耐久値までとなる。

例）木の棒のみで、壊れかけの（耐久値の減った）木ピッケルを作成

ModLoader.addRecipe(new ItemStack(Item.pickaxeWood,1,32),
    new Object[]{"YYY"," Y "," Y ",
    Character.valueOf('Y'),Item.stick});

• 耐久値のあるアイテムは、ダメージを指定すると、その分耐久力が減少して作成される。
• 耐久値と同じダメージを指定すれば、１回で壊れるアイテムも作成可能
  • これを応用して、木材から「数回で壊れるハサミ」なども作成することができる

例）石ピッケルを黒曜石８個で囲み、耐久値ほぼ無限の石ピッケルを作成

ModLoader.addRecipe(new ItemStack(Item.pickaxeStone,1,-32000),
    new Object[]{"XXX","XYX","XXX",
    Character.valueOf('X'),Block.obsidian,Character.valueOf('Y'),Item.pickaxeStone});

• 耐久値のあるアイテムをダメージマイナスで作成すると、そのダメージを使い切るまで耐久値が減らなくなる。
  • TooManyItemsを導入している環境では、マイナスを指定すると耐久が減らなくなる。
  • ただし防具は無限にならない（マイナスした分、ダメージを相殺する＝耐久力が増える）。

※Minecraft1.5以降では、ダメージ値にマイナスの値を設定する事はできません。

例）耐久値の減った石ピッケルと丸石から、新品の石ピッケルを作成

ModLoader.addShapelessRecipe(new ItemStack(Item.pickaxeStone,1),
    new Object[]{
    new ItemStack(Block.cobblestone,1), new ItemStack(Item.pickaxeStone,1,-1)});

• レシピに耐久値の減ったツール類を指定可能にする場合、ダメージを-1に設定する。
  • ダメージに1などを指定すると、1回だけ使ったツール、のように耐久値を指定することが可能（意味の有無は別として）。

※Minecraft1.5以降では、-1ではなく32767を設定する必要があります。

• このソースファイル内で定義しているアイテムやブロックを作成、使用する場合、ttrPickaxe のようにプリフィクス無しで記述する。
• 既存のアイテムや他のファイルで定義されているアイテムやブロックを作成、使用する場合、Item.stick、Block.stone のように、定義しているファイル名（ItemやBlock）をプリフィクスとしてつける（クラスのスコープを正しく指定する）。

Tips

牛乳入りバケツのように、クラフト後に別アイテムとして残るレシピ

• これはレシピで指定しているのではなく、アイテム側の設定となる。
• 例えば液体入りバケツをクラフトすると空バケツが戻るようにするなら、液体入りバケツのコンストラクタで以下のように指定する。

maxStackSize = 1;                   //液体入りバケツのスタックサイズは1でなければならない
    setContainerItem(Item.bucketEmpty); //戻ってくるアイテムを指定