User Tools

Site Tools


tutorial:items

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
tutorial:items [2019/05/20 15:44]
draylar refactoring language
tutorial:items [2019/08/13 14:48] (current)
i509vcb Add section showing how to set maximum stack size on custom item
Line 3: Line 3:
 ==== Introduction ==== ==== Introduction ====
  
-One of the first things you'll want to do with Fabric is adding a new item. +Adding a basic item is one of the first steps in modding. You're going to need to create an ''​Item''​ object, register it, and give it a texture. To add additional behavior to the item you will need a custom Item class. ​In this tutorial and all future ones, the “tutorial” namespace is used as a placeholder. If you have a separate modid, feel free to use it instead.
- +
-You're going to need to create an ''​Item''​ object, register it, and give it a texture. To add additional behavior to the item you will need a custom Item class. +
-  ​+
 ==== Registering an Item ==== ==== Registering an Item ====
  
Line 14: Line 11:
 { {
     // an instance of our new item     // an instance of our new item
-    public static final Item FABRIC_ITEM = new Item(new Item.Settings().itemGroup(ItemGroup.MISC));​+    public static final Item FABRIC_ITEM = new Item(new Item.Settings().group(ItemGroup.MISC));​
     [...]     [...]
 } }
 </​code>​ </​code>​
-To register an ''​Item'', you can call register ​on the static ​Registry ​object. This takes in a registry type, Identifier, and an instance of what you'​re ​registering. This can be called anywhere as long as it occurs during initialization.+You'll use the vanilla registry system for registering new content. The basic syntax is ''​Registry#register(Registry ​Type, Identifier, Content)''​. Registry types are stored as static fields in the ''​Registry''​ object, and the identifier is what labels your content. Content is an instance of whatever ​you'​re ​adding. This can be called anywhere as long as it occurs during initialization.
 <code java [enable_line_numbers="​true"​]>​ <code java [enable_line_numbers="​true"​]>​
 public class ExampleMod implements ModInitializer public class ExampleMod implements ModInitializer
 { {
     // an instance of our new item     // an instance of our new item
-    public static final Item FABRIC_ITEM = new Item(new Item.Settings().itemGroup(ItemGroup.MISC));​+    public static final Item FABRIC_ITEM = new Item(new Item.Settings().group(ItemGroup.MISC));​
       ​       ​
     @Override     @Override
     public void onInitialize()     public void onInitialize()
     {     {
-        Registry.register(Registry.ITEM,​ new Identifier("​wikitut", "​fabric_item"​),​ FABRIC_ITEM);​+        Registry.register(Registry.ITEM,​ new Identifier("​tutorial", "​fabric_item"​),​ FABRIC_ITEM);​
     }      } 
 } }
Line 40: Line 37:
 Registering a texture for an item requires an item model .json file and a texture image. You're going to need to add these to your resource directory. The direct path of each is: Registering a texture for an item requires an item model .json file and a texture image. You're going to need to add these to your resource directory. The direct path of each is:
  
-    Item model: .../​resources/​assets/​wikitut/​models/​item/​fabric_item.json +    Item model: .../​resources/​assets/​tutorial/​models/​item/​fabric_item.json 
-    Item texture: .../​resources/​assets/​wikitut/​textures/​item/​fabric_item.png+    Item texture: .../​resources/​assets/​tutorial/​textures/​item/​fabric_item.png
  
-Note that wikitut is your modid. ​Our example texture can be found [[https://​i.imgur.com/​CqLSMEQ.png|here]].+Our example texture can be found [[https://​i.imgur.com/​CqLSMEQ.png|here]].
  
 If you registered your item properly in the first step, your game will complain about a missing texture file in a fashion similar to this: If you registered your item properly in the first step, your game will complain about a missing texture file in a fashion similar to this:
  
-    [Server-Worker-1/​WARN]:​ Unable to load model: 'wikitut:​fabric_item#​inventory'​ referenced from: wikitut:​fabric_item#​inventory:​ java.io.FileNotFoundException: ​wikitut:​models/​item/​fabric_item.json+    [Server-Worker-1/​WARN]:​ Unable to load model: 'tutorial:​fabric_item#​inventory'​ referenced from: tutorial:​fabric_item#​inventory:​ java.io.FileNotFoundException: ​tutorial:​models/​item/​fabric_item.json
 It conveniently tells you exactly where it expects your asset[s] to be found-- when in doubt, check the log. It conveniently tells you exactly where it expects your asset[s] to be found-- when in doubt, check the log.
  
 A basic item model template is: A basic item model template is:
- +<code JavaScript>​ 
-  +
-    "​parent":​ "​item/​generated",​ +  "​parent":​ "​item/​generated",​ 
-    "​textures":​ { +  "​textures":​ { 
-      "​layer0":​ "wikitut:​item/​fabric_item"​ +    "​layer0":​ "tutorial:​item/​fabric_item"​
-    }+
   }   }
-  ​+
 +</​code>​
 The parent of your item changes how it's rendered in the hand and comes in useful for things like block items in the inventory. "​item/​handheld"​ is used for tools that are held from the bottom left of the texture. textures/​layer0 is the location of your image file. The parent of your item changes how it's rendered in the hand and comes in useful for things like block items in the inventory. "​item/​handheld"​ is used for tools that are held from the bottom left of the texture. textures/​layer0 is the location of your image file.
  
Line 78: Line 75:
 </​code>​ </​code>​
  
-An example application ​would be making the item play a sound when you click with it:+A practical use-case for a custom item class would be making the item play a sound when you click with it:
 <code java [enable_line_numbers="​true"​]>​ <code java [enable_line_numbers="​true"​]>​
 public class FabricItem extends Item public class FabricItem extends Item
Line 96: Line 93:
 </​code>​ </​code>​
  
-Replace the old Item object with an instance of your new Item:+Replace the old Item object with an instance of your new item class:
 <code java [enable_line_numbers="​true"​]>​ <code java [enable_line_numbers="​true"​]>​
 public class ExampleMod implements ModInitializer public class ExampleMod implements ModInitializer
 { {
     // an instance of our new item     // an instance of our new item
-    public static final FabricItem FABRIC_ITEM = new FabricItem(new Item.Settings().itemGroup(ItemGroup.MISC));​+    public static final FabricItem FABRIC_ITEM = new FabricItem(new Item.Settings().group(ItemGroup.MISC));​
     [...]     [...]
 } }
 </​code>​ </​code>​
 If you did everything correctly, using the item should now play a sound. If you did everything correctly, using the item should now play a sound.
 +
 +==== What if I want to change the stack size of my item? ====
 +
 +For this you would use ''​maxCount(int size)''​ inside ItemSettings to specify the max stack size. Note that if your item is damageable you cannot specify a maximum stack size or the game will throw a RuntimeException.
 +<code java [enable_line_numbers="​true"​]>​
 +public class ExampleMod implements ModInitializer
 +{
 +    // an instance of our new item, where the maximum stack size is 16
 +    public static final FabricItem FABRIC_ITEM = new FabricItem(new Item.Settings().group(ItemGroup.MISC).maxCount(16));​
 +    [...]
 +}
 +</​code>​
 +==== Next Steps ====
 +[[tutorial:​itemgroup|Add your item to your own ItemGroup]].
tutorial/items.1558367068.txt.gz · Last modified: 2019/05/20 15:44 by draylar