Differences

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

--- tutorial:tooltip [2021/02/22 00:32] – Fix another fomatting error proudmuslim
+++ tutorial:tooltip [2025/07/09 01:55] (current) – typo fix cassiancc
@@ Line 1: / Line 1: @@
 ====== Adding a tooltip ======
-In your [[tutorial:items|item]] class, override ''appendTooltip'' like so (see [[tutorial:lang]] for how to translate the tooltip) :
+===== Item tooltip =====
-<code java>
+Sometimes you want to add some extra information when showing the tooltip of the [[items|item]]. To achieve this, you should override your own ''<yarn method_7851>'' like so (see [[tutorial:lang]] for how to translate the tooltip).
-@Override
-public void appendTooltip(ItemStack itemStack, World world, List<Text> tooltip, TooltipContext tooltipContext) {
-    // default white text
+Here we assume you have created your own class (see [[items]]), for example, ''CustomItem'':
-    tooltip.add( new TranslatableText("item.tutorial.fabric_item.tooltip") );
+For versions 1.18.2 and before:
+<yarncode java>
+public class CustomItem extends Item {
+    // ...
+    @Override
+    public void method_7851(class_1799 itemStack, class_1937 world, List<class_2561> tooltip, class_1836 tooltipContext) {
-    // formatted red text
+        // default white text
-    tooltip.add( new TranslatableText("item.tutorial.fabric_item.tooltip").formatted(Formatting.RED) );
+        tooltip.add(new TranslatableText("item.tutorial.custom_item.tooltip"));
+        // formatted red text
+        tooltip.add(new TranslatableText("item.tutorial.custom_item.tooltip").method_27692(class_124.field_1061));
+    }
 }
-</code>
+</yarncode>
-You can also append your tooltip in the [[tutorial:blocks|block]] class by overriding a similar method :
-<code java>
+For versions since 1.19:
-@Override
+<yarncode java>
-public void appendTooltip(ItemStack itemStack, BlockView world, List<Text> tooltip, TooltipContext tooltipContext) {
+public class CustomItem extends Item {
-    tooltip.add( new TranslatableText("block.tutorial.fabric_block.tooltip") );
+    // ...
+    @Override
+    public void method_7851(class_1799 itemStack, class_1937 world, List<class_2561> tooltip, class_1836 tooltipContext) {
+        tooltip.add(Text.translatable("item.tutorial.custom_item.tooltip"));
+    }
 }
+</yarncode>
+For versions since 1.20.5:
+<yarncode java>
+public class CustomItem extends Item {
+    // ...
+    @Override
+    public void method_7851(class_1799 itemStack, TooltipContext context, List<class_2561> tooltip, TooltipType type) {
+        tooltip.add(Text.translatable("item.tutorial.custom_item.tooltip"));
+    }
+}
+</yarncode>
+> :!: The method is deprecated since 1.21.5. To add item tooltips for 1.21.5, please use Fabric API.
+===== Block tooltip =====
+You can also append your tooltip in the [[blocks|block]] class by overriding a similar method:
+For versions below 1.20.5:
+<yarncode java>
+public class CustomBlock extends Block {
+    // ...
+    @Override
+    public void method_9568(class_1799 itemStack, class_1922 world, List<class_2561> tooltip, class_1836 tooltipContext) {
+        // for versions 1.18.2 and before
+        tooltip.add(new TranslatableText("block.tutorial.custom_block.tooltip"));
+        // for versions since 1.19
+        tooltip.add(Text.translatable("block.tutorial.custom_block.tooltip"));
+    }
+}
+</yarncode>
+For versions since 1.20.5, before 1.21.5:
+<yarncode java>
+public class CustomBlock extends Block {
+    // ...
+    @Override
+    public void method_9568(class_1799 itemStack, Item.TooltipContext context, List<class_2561> tooltip, TooltipType options) {
+        tooltip.add(Text.translatable("block.tutorial.custom_block.tooltip"));
+    }
+}
+</yarncode>
+===== Adding tooltips in 1.21.5 =====
+Since 1.21.5, the implementation of item tooltips are rewritten. Most item tooltips are implemented with item components now, which may be influenced by ''tooltip_display'' item component to decide whether to display. However, you can still use Fabric API to add custom tooltips. Add the following code in the mod initializer in your code:
+<code java>
+    ItemTooltipCallback.EVENT.register((itemStack, tooltipContext, tooltipType, list) -> {
+      if (!itemStack.isOf(TutorialItems.CUSTOM_ITEM)) {
+        return;
+      }
+      list.add(Text.translatable("item.tutorial.custom_item.tooltip"));
+    });
 </code>
+The example adds a custom tooltip for the item we created in the [[items]] tutorial.