「無機能のアイテムを追加する」を編集中

{{前提MOD|reqmod="ModLoader 1.2.3以降"}}
;作成するファイル
:mod_Tutorial.java　mod本体のソース
:ttritem.png　追加アイテムのテクスチャ画像

==mod_Tutorial.javaの内容==
<source lang="java">
 package net.minecraft.src;
 
 public class mod_Tutorial extends BaseMod {
 
    public String getVersion() {
       return "1.0.0";
    }
 
    public static Item ttrItem;
 
    public void load() {
 
       ttrItem = new Item(5000).setItemName("ttrItem");
       ttrItem.iconIndex = ModLoader.addOverride("/gui/items.png", "/ttr/ttritem.png");
       ModLoader.addName(ttrItem, "Tutorial Item");
       ModLoader.addRecipe(new ItemStack(ttrItem, 4),
                           new Object[]{ "X","X",
                           Character.valueOf('X'),Block.dirt });
    }
 }
</source>


==解説==

===パッケージ、クラス設定、バージョン設定===
<source lang="java">
 package net.minecraft.src;
</source>

*ここでパッケージを読み込みます。必ず必要になります。


<source lang="java">
 public class mod_Tutorial extends BaseMod {
</source>

*ModLoaderのクラス BaseMod を継承したクラスを作ります。mod_の後の部分はmod名で、ファイル名と同じにします。


<source lang="java">
 public String getVersion() {
 　　return "1.0.0";
 }
</source>

*ＭＯＤのバージョンをModLoaderに渡しています。
**'''中の文字列Minecraftのバージョンではなく、modのバージョンです。適当でも構いません。'''
**modリスト一覧でのバージョン表記などで表示されます。


===アイテムを追加する===
<source lang="java">
 public static Item ttrItem;
</source>

*ここで Itemクラスの新規アイテム "ttrItem" のフィールドを用意しています。


<source lang="java">
 public void load() {
</source>

*ModLoaderにmodが読み込まれた際に実行される部分です。必ず追加する必要があります。


<source lang="java">
 ttrItem = new Item(5000).setItemName("ttrItem");
</source>
;例2）
<source lang="java">
 ttrItem = new Item(5000).setItemName("ttrItem").setIconCoord(0, 0);
</source>

*アイテム"ttrItem"にＩＤと名前を渡しています。数字は任意に変えてください。
**この数字はアイテムＩＤなので、他のＭＯＤや既存アイテムとかぶると競合します。注意してください。
**アイテムを追加する場合、<b style="color:red;">実際に登録されるＩＤは指定した数値の＋２５６</b>になることに注意。特に設定ファイルからIDを取得する際には注意が必要です。
*ここで入れてる名前はゲーム内で表示される名前ではなく、ゲーム内でアイテムの判別に利用される名前です。
**既存のアイテムやMODの追加アイテムと被ると、問題が発生します。決して被らない名前を付けるようにして下さい。
*例2）のように指定すると、既存のテクスチャ（gui/items.png）を使用できます。
**.setIconCoord(横座標, 縦座標) で指定します。0,0 なら皮のヘルメット、5,3 なら木の棒になります。
*.setMaxStackSize(1)を追加することで、スタックサイズを1にできます。未指定時のスタックサイズは64になります。


<source lang="java">
 ttrItem.iconIndex = ModLoader.addOverride("/gui/items.png", "/ttritem.png");
</source>

*アイテムttrItemにModLoaderの機能でテクスチャを上書きしています。用意していたttritem.pngが反映されます。
**画像が見つからない場合、エラーが出ます。
**MCPを使っている場合、画像を入れるのは　eclipse/client/bin/　のnetフォルダと同じところに置きます。
**フォルダで画像をまとめたい場合、指定を"/フォルダ名/画像名"というようにします。


<source lang="java">
 ModLoader.addName(ttrItem, "Tutorial Item");
</source>

*ここではアイテムのゲーム内で表示する名前を設定しています。
**addName(アイテム名,"表示したい名前"）　と記述します。
*以下のようにすると、各言語設定に対応した名前を設定できます。
<source lang="java">
 ModLoader.addName(ttrItem, "Tutorial Item");
 ModLoader.addName(ttrItem, "ja_JP", "チュートリアルアイテム");
</source>


===レシピを設定する===
<source lang="java">
 ModLoader.addRecipe(new ItemStack(ttrItem, 4), 
                     new Object[]{ "X","X",
                     Character.valueOf('X'),Block.dirt });
</source>

*ModLoader.addRecipeで定型レシピを設定します。詳しくは[[レシピの追加]]をご覧下さい。


===クラスの終わり===
<source lang="java">
 　 ｝
 ｝
</source>
*最後に足りない　}　が入ります。このチュートリアルの場合２つになります。

[[Category:アイテムの追加|む]]
@@ 15行目: / 15行目: @@
      public static Item ttrItem;
-    @MLProp(info="ttrItemID", min = 4096, max = 32000)
-    public static int ttrItemID = 5000;
      public void load() {
-        ttrItem = new Item(ttrItemID-256).setItemName("ttrItem");
+        ttrItem = new Item(5000).setItemName("ttrItem");
         ttrItem.iconIndex = ModLoader.addOverride("/gui/items.png", "/ttr/ttritem.png");
         ModLoader.addName(ttrItem, "Tutorial Item");
@@ 55行目: / 53行目: @@
 *ＭＯＤのバージョンをModLoaderに渡しています。
-**中の文字列Minecraftのバージョンではなく、modのバージョンです。適当でも構いません。
+**'''中の文字列Minecraftのバージョンではなく、modのバージョンです。適当でも構いません。'''
 **modリスト一覧でのバージョン表記などで表示されます。
@@ 75行目: / 73行目: @@
 <source lang="java">
- @MLProp(info="assign an ItemID", min = 4096, max = 32000)
+  ttrItem = new Item(5000).setItemName("ttrItem");
- public static int ttrItemID = 5000;
-  ttrItem = new Item(ttrItemID-256).setItemName("ttrItem");
 </source>
 ;例2）
 <source lang="java">
-  ttrItem = new Item(ttrItemID-256).setItemName("ttrItem").setIconCoord(0, 0);
+  ttrItem = new Item(5000).setItemName("ttrItem").setIconCoord(0, 0);
 </source>
-*ttrItemID でアイテムのIDを設定し、その前の @MLProp でcfgファイルから変更可能にしています。
+*アイテム"ttrItem"にＩＤと名前を渡しています。数字は任意に変えてください。
-**アイテムIDなので、設定範囲を4096-32000にしています。
+**この数字はアイテムＩＤなので、他のＭＯＤや既存アイテムとかぶると競合します。注意してください。
-***<b style="color:red;">ID 256-4095はブロックで使われる可能性があります。アイテムIDは4096以上が望ましいです。</b>
+**アイテムを追加する場合、<b style="color:red;">実際に登録されるＩＤは指定した数値の＋２５６</b>になることに注意。特に設定ファイルからIDを取得する際には注意が必要です。
-**cfgファイルについての詳細は、[[設定ファイル作成方法]]を参照して下さい。
+*ここで入れてる名前はゲーム内で表示される名前ではなく、ゲーム内でアイテムの判別に利用される名前です。
-**IDで記述するのはデフォルトIDになります。数字は任意に変更してください（競合注意）。
-***<b style="color:red;">ID被りによる競合は常に発生しうるものなので、IDは極力、設定ファイルで変更可能にしましょう。</b>
-*最後の文でアイテム"ttrItem"にＩＤと名前を渡しています。
-**Item(ttrItemID-256) がアイテムIDを設定している部分です。
-**アイテムを追加する場合、実際に登録されるＩＤは指定した数値の＋２５６になるため、設定ファイルの数字をそのまま反映できるように、-256して登録しています。
-*次に、setItemName("ttrItem") でアイテムに名前を設定しています。
-**ここで入れてる名前は画面上に表示される名前ではなく、ゲーム内でアイテムの判別に利用される名前です。
 **既存のアイテムやMODの追加アイテムと被ると、問題が発生します。決して被らない名前を付けるようにして下さい。
 *例2）のように指定すると、既存のテクスチャ（gui/items.png）を使用できます。
@@ 119行目: / 107行目: @@
 **addName(アイテム名,"表示したい名前"）　と記述します。
 *以下のようにすると、各言語設定に対応した名前を設定できます。
-**注意：２バイト文字（日本語など）を使う場合は、ファイルをUTF-8で保存してください。
 <source lang="java">
   ModLoader.addName(ttrItem, "Tutorial Item");
@@ 143行目: / 130行目: @@
 *最後に足りない　}　が入ります。このチュートリアルの場合２つになります。
-[[Category:アイテムの追加|む]]　[[category:アイテム]]
+[[Category:アイテムの追加|む]]