Differences

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

--- tutorial:itemgroup [2023/06/11 08:46] – Update to 1.20 mcrafterzz
+++ tutorial:itemgroup [2024/08/23 13:03] (current) – solidblock
@@ Line 1: / Line 1: @@
+~~REDIRECT>https://docs.fabricmc.net/develop/items/custom-item-groups~~
 ====== Item Groups ======
 //This is the 1.20+ version of this tutorial. For the 1.19 version, see [[tutorial:1.19:itemgroup|Creating an itemgroup (1.19)]].//
-So far, you have used ''/give @s tutorial:custom_item'' to obtain your item. To make obtaining your item easier, you can add it to item groups within the creative inventory. You can also add your own item group. All items added to any group will also be searchable within the creative inventory.
+So far, you have used ''/give @s tutorial:custom_item'' to obtain your item. However, unlike most vanilla items, it exists in none of the item group, and you cannot easily obtain it in Creative Mode! There are two ways of achieving this:
+  * adding your item into an existing item group
+  * create your own item group and add items
-==== Adding to Item Groups ====
+All items added to any group will also be searchable within the creative inventory.
+===== Add items into existing item groups =====
 First, choose the item group that the item should be added to. For this example, that item group will be the building blocks group. The registry keys of vanilla item groups are stored in the ''<yarn class_7706>'' class.
@@ Line 12: / Line 18: @@
 <yarncode java [enable_line_numbers="true"]>
-ItemGroupEvents.modifyEntriesEvent(class_7706.field_40195).register(content -> {
+public class ExampleMod implements ModInitializer {
-	content.add(CUSTOM_ITEM);
+    @Override
-});
+    public void onInitialize() {
+        ItemGroupEvents.modifyEntriesEvent(class_7706.field_40195).register(content -> {
+            content.add(TutorialItems.CUSTOM_ITEM);
+        });
+    }
+}
 </yarncode>
@@ Line 24: / Line 35: @@
 <yarncode java [enable_line_numbers="true"]>
-ItemGroupEvents.modifyEntriesEvent(class_7706.field_40195).register(content -> {
+public class ExampleMod implements ModInitializer {
-	content.addAfter(class_1802.field_8691, CUSTOM_ITEM);
+    @Override
-});
+    public void onInitialize() {
+        ItemGroupEvents.modifyEntriesEvent(class_7706.field_40195).register(content -> {
+            content.addAfter(class_1802.field_8691, TutorialItems.CUSTOM_ITEM);
+        });
+    }
+}
 </yarncode>
-==== Creating an Item Group ====
+In practice, considering items you register may be in large quantities, it's recommended to place then in a particular method, instead of directly in your ''ModInitializer''. See the following example (if write like this, remember to undo the codes above):
+<yarncode java [enable_line_numbers="true"]>
+public final class TutorialItems {
+    // [...]
+    public static void registerToVanillaItemGroups() {
+        ItemGroupEvents.modifyEntriesEvent(class_7706.field_40195).register(content -> {
+            content.addAfter(class_1802.field_8691, CUSTOM_ITEM);
+        });
+    }
+}
+</yarncode>
+Then, remember to refer to that method in your ''ModInitializer'':
+<yarncode java [enable_line_numbers="true"]>
+public class ExampleMod implements ModInitializer {
+    @Override
+    public void onInitialize() {
+        TutorialItems.registerToVanillaItemGroups();
+    }
+}
+</yarncode>
+===== Create your own item group =====
 Before you create an item group, determine whether it would have enough content to warrant its own group. Your item group will be placed on a separate page of tabs, impacting its discoverability, and users may be confused if the item is not where similar items are in the creative inventory.
@@ Line 36: / Line 75: @@
 <yarncode java [enable_line_numbers="true"]>
-private static final class_1761 ITEM_GROUP = FabricItemGroup.builder()
+public final class TutorialItemGroups {
-	.icon(() -> new class_1799(CUSTOM_ITEM))
+    public static final class_1761 TEST_GROUP = FabricItemGroup.builder()
-        .displayName(Text.translatable("itemGroup.tutorial.test_group"))
+        .icon(() -> new class_1799(TutorialItems.CUSTOM_ITEM))
-	.build();
+        .displayName(class_2561.method_43469("itemGroup.tutorial.test_group"))
+        .entries((context, entries) -> {
+            entries.add(TutorialItems.CUSTOM_ITEM);
+        })
+        .build();
+}
 </yarncode>
+You can add entries to your item group within the ''entries'' callback method. Note that unlike vanilla item groups, where you can add items relative to existing items, you must add items to your own item group in order since there are no vanilla items to position your items relative to.
 It is important to set the display name, otherwise it will cause a crash.
-The next step is to register your itemGroup.
+The next step is to register your item group.
 <yarncode java [enable_line_numbers="true"]>
-	Registry.register(Registries.ITEM_GROUP, new Identifier("tutorial", "test_group"), ITEM_GROUP);
+public final class TutorialItemGroups {
+    // ....
+    public static void initialize() {
+        // Since 1.21:
+        class_2378.method_10230(class_7923.field_44687, Identifier.of("tutorial", "test_group"), ITEM_GROUP);
+        // Below 1.21:
+        class_2378.method_10230(class_7923.field_44687, new class_2960("tutorial", "test_group"), ITEM_GROUP);
+    }
+}
 </yarncode>
-You can use ''ITEM_GROUP'' to modify entries just like a vanilla item group. Note that you must add the items in order since there are no vanilla items to position them relative to:
+Of course, you can directly register them when assigning the fields:
+<yarncode java [enable_line_numbers="true"]>
+public final class TutorialItemGroups {
+    public static final class_1761 TEST_GROUP = class_2378.method_10230(class_7923.field_44687, new class_2960("tutorial", "test_group"), FabricItemGroup.builder()
+        .icon(() -> new class_1799(CUSTOM_ITEM))
+        .displayName(class_2561.method_43469("itemGroup.tutorial.test_group"))
+        .entries((context, entries) -> {
+            entries.add(TutorialItems.CUSTOM_ITEM);
+        })
+        .build());
+    public static void initialize() {
+    }
+}
+</yarncode>
+Remember to statically load the class in your ''ModInitializer'':
 <yarncode java [enable_line_numbers="true"]>
-ItemGroupEvents.modifyEntriesEvent(ITEM_GROUP).register(content -> {
+public class ExampleMod implements ModInitializer {
-	content.add(CUSTOM_ITEM);
+    @Override
-});
+    public void onInitialize() {
+        TutorialItemGroups.initialize();
+    }
+}
 </yarncode>
+:!: The screenshot below is outdated.
 {{:tutorial:item_group_append_items.png?nolink&400|}}