Differences

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

--- zh_cn:tutorial:tooltip [2024/04/15 01:31] – solidblock
+++ zh_cn:tutorial:tooltip [2025/04/01 08:15] (current) – solidblock
@@ Line 1: / Line 1: @@
-====== 添加一个物品提示 ======
+====== 添加物品提示 ======
+===== 物品的物品提示 =====
 在您的[[zh_cn:tutorial:items|物品]]类中，像这样重写 ''appendTooltip''（有关如何翻译提示，请参见[[zh_cn:tutorial:lang]]）。
@@ Line 31: / Line 32: @@
 </yarncode>
+> :!: 该方法自从 1.21.5 开始被弃用。要在 1.21.5 添加物品提示，请使用 Fabric API。
+===== 方块的物品提示 =====
 你也可以在[[zh_cn:tutorial:blocks|方块]]类中通过重写类似方法来添加物品提示：
 <yarncode java>
@@ Line 43: / Line 46: @@
 </yarncode>
-对于 1.20.5 之后的版本：
+对于 1.20.5 之后、1.21.5 之前的版本：
 <yarncode java>
 @Override
@@ Line 50: / Line 53: @@
 }
 </yarncode>
+===== 在 1.21.5 中添加物品提示 =====
+自 1.21.5 开始，物品提示的实现方式被重写。大多数物品提示改为使用物品组件实现，其是否显示会受到 ''tooltip_display'' 物品组件的影响。不过，还是可以借助 Fabric API 添加自定义的物品提示。可以在代码的模组初始化器部分加入以下代码：
+<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>
+这个例子将为我们在 [[items]] 教程中创建的物品添加自定义的物品提示。