Differences

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

--- tutorial:enchantments [2024/07/03 07:14] – solidblock
+++ tutorial:enchantments [2024/08/23 13:52] (current) – [Adding Translations] solidblock
@@ Line 1: / Line 1: @@
-===== Adding Enchantments =====
+====== Adding Enchantments ======
+===== Adding enchantments since 1.21 =====
+Since 1.21, enchantments has been data-driven, which means you should define them in data-packs, instead of in the codes. Please see [[https://minecraft.wiki/w/Enchantment_definition|Enchantment definition Minecraft page]] for details.
+To use the enchantments in code, you should just store ''RegistryKey'' objects of the enchantment.
+<code java TutorialEnchantments>
+public final class TutorialEnchantments {
+  public static final RegistryKey<Enchantment> FROST = of("frost");
+  private static RegistryKey<Enchantment> of(String name) {
+    return RegistryKey.of(RegistryKeys.ENCHANTMENT, Identifier.of("tutorial", name));
+  }
+  public static void initialize() {
+  }
+}
+</code>
+Remember to refer to the ''initialize'' method in your ''ModInitializer'':
+<code java ExampleMod>
+public class ExampleMod implements ModInitializer {
+  // [...]
+  @Override
+  public void onInitialize() {
+    // [...]
+    TutorialEnchantments.initialize();
+  }
+}
+</code>
+To add a translated name for your enchantment, see the bottom of the tutorial.
+===== Adding enchantments before 1.21 =====
+:!: This part of the tutorial only applies to older Minecraft versions.
 To add enchantments to your mod, you'll need to:
@@ Line 93: / Line 128: @@
 This registers our enchantment under the namespace ''tutorial:frost''. All non-treasure enchantments are available in an enchanting table, including the ones you register.
-==== Adding Translations & Testing ====
+===== Adding Translations =====
+=) This part works both versions since 1.21 and before 1.21.
 You'll need to add a translation to your enchantment as well. Head over to your [[tutorial:lang|mod lang file]] and add a new entry:
-<code json [enable_line_numbers="false"]>
+<code javascript resources/data/tutorial/lang/en_us.json>
 {
     "enchantment.tutorial.frost": "Frost"