Differences

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

--- zh_cn:tutorial:model_predicate_providers [2021/07/25 01:55] – created solidblock
+++ zh_cn:tutorial:model_predicate_providers [2024/08/23 14:05] (current) – 更新翻译 solidblock
@@ Line 1: / Line 1: @@
 ====== 模型谓词提供器 =======
-==== 介绍 ====
+===== 介绍 =====
-模型谓词提供器用于动态改变Model providers are used to dynamically change the model of items based on data from ''ItemStack''s. A common example is the bow, which has different textures based on how long the bow has been pulled. All providers are then used in the model file for the item, in the ''overrides'' section.
+模型谓词提供器用于给予 ''ItemStack'' 的数据动态改变物品的模型。一个简单的例子是弓，其在不同的拉伸度下会有不同的纹理。所有的提供器都会用在物品的模型文件中，位于 ''overrides'' 部分。
-==== 可行示例 ====
+===== 可行示例 =====
-在此例中，我们假定有了自定义的弓，叫做''EXAMPLE_BOW''。
+在此例中，我们假定有了自定义的弓，叫做 ''TutorialItems.EXAMPLE_BOW''。
-在其方法中，使用其物品和一个''Identifier''注册一个''ModelPredicateProvider''。对于''Identifier''的使用，不需要提供命名空间，因为这些不会与Minecraft的提供器冲突。这些必须在你的''ClientModInitializer''的''onInitializeClient''方法中完成。如果你没有''ClientModInitializer''，可以看看[[zh_cn:documentation:entrypoint|入口点]]教程以添加一个。
+在其方法中，使用其物品和一个 ''Identifier'' 注册一个 ''ModelPredicateProvider''。对于 ''Identifier'' 的使用，不需要提供命名空间，因为这些不会与 Minecraft 的提供器冲突。这些必须在你的 ''ClientModInitializer'' 的 ''onInitializeClient'' 方法中完成。如果你没有 ''ClientModInitializer''，可以看看[[zh_cn:documentation:entrypoint|入口点]]教程以添加一个。
 <code java [enable_line_numbers="true"]>
+@Environment(EnvType.CLIENT)
+public class ExampleModClient implements ClientModInitializer {
+  public static void registerModelPredicateProviders() {
+    //对于 1.21 之前的版本，将 'Identifier.ofVanilla' 替换为 'new Identifier'。
+    ModelPredicateProviderRegistry.register(EXAMPLE_BOW, Identifer.ofVanilla("pull"), (itemStack, clientWorld, livingEntity, seed) -> {
+      if (livingEntity == null) {
+        return 0.0F;
+      }
+      return livingEntity.getActiveItem() != itemStack ? 0.0F : (itemStack.getMaxUseTime(livingEntity) - livingEntity.getItemUseTimeLeft()) / 20.0F;
+    });
-FabricModelPredicateProviderRegistry.register(EXAMPLE_BOW, new Identifier("pull"), (itemStack, clientWorld, livingEntity) -> {
+    ModelPredicateProviderRegistry.register(EXAMPLE_BOW, Identifier.ofVanilla("pulling"), (itemStack, clientWorld, livingEntity, seed) -> {
-	if (livingEntity == null) {
+      if (livingEntity == null) {
-		return 0.0F;
+        return 0.0F;
-	}
+      }
-	return livingEntity.getActiveItem() != itemStack ? 0.0F : (itemStack.getMaxUseTime() - livingEntity.getItemUseTimeLeft()) / 20.0F;
+      return livingEntity.isUsingItem() && livingEntity.getActiveItem() == itemStack ? 1.0F : 0.0F;
-});
+    });
+  }
-FabricModelPredicateProviderRegistry.register(EXAMPLE_BOW, new Identifier("pulling"), (itemStack, clientWorld, livingEntity) -> {
-	if (livingEntity == null) {
+  @Override
-		return 0.0F;
+  public void onInitializeClient() {
-	}
+    // ...
-	return livingEntity.isUsingItem() && livingEntity.getActiveItem() == itemStack ? 1.0F : 0.0F;
+    registerModelPredicateProviders();
-});
+  }
+}
 </code>
-''ModelPredicateProvider''时功能性的接口，需要一个''ItemStack''作为当前被渲染的物品堆，一个''ClientWorld''作为客户端所在的当前世界，以及一个''LivingEntity''作为物品的用户（在1.17+，还需要接收一个''int''）。
+如果 ''ModelPredicateProviderRegistry'' 在某些版本不存在，考虑使用 ''FabricModelPredicateProviderRegistry''。
-所有的''ModelPredicateProvider''返回浮点数，用来代表模型的不同状态，或者通过返回''1.0f''和''0f''来分别表示真假值。
+''ModelPredicateProvider'' 是函数型接口，需要一个 ''ItemStack'' 作为当前被渲染的物品堆，一个 ''ClientWorld'' 作为客户端所在的当前世界，以及使用该物品的玩家 ''LivingEntity''（在1.17+，还需要接收一个''int''）。
-仔细看看''pull''谓词，我们会看到我们首先检查实体是否无效（null），因为物品可以在其使用的环境之外渲染（例如掉落在地上）。我们确保实体使用我们的物品，否则物品会让模型谓词在不被使用的时候应用。最后，我们将''itemStack.getMaxUseTime()''减去''livingEntity.getItemUseTimeLeft()''以表示物品所被持有的刻数。因为完全拉满一把弓需要20刻即1秒的时间，所以我们将这个数字除以''20.0f''以使其介于''0f''到''1.0f''之间来表示正常的拉伸进度。
+所有的 ''ModelPredicateProvider'' 返回浮点数，用来代表模型的不同状态，或者通过返回 ''1.0f'' 和 ''0f'' 来分别表示真假值。返回的值会被限制在 0.0f 到 1.0f 之间。
+仔细看看 ''pull'' 谓词，我们会看到我们首先检查实体是否为 null，因为物品可以在其使用的环境之外渲染（例如掉落在地上）。我们确保实体使用我们的物品，否则物品会让模型谓词在不被使用的时候应用。最后，我们将 ''itemStack.getMaxUseTime(livingEntity)'' 减去 ''livingEntity.getItemUseTimeLeft()'' 以表示物品所被持有的刻数。因为完全拉满一把弓需要 20 刻即 1 秒的时间，所以我们将这个数字除以 ''20.0f'' 以使其介于 ''0f'' 到 ''1.0f'' 之间来表示正常的拉伸进度。
 所有这些都是有用的，但为了让我们的物品改变其模型，我们只需要实现其一部分的特性。
-<code json [enable_line_numbers="true"]>
+<code javascript resources/data/tutorial/models/item/example_bow.json>
-"overrides": [
+{
-    {
+    // [...]
-        "predicate": {
+    "overrides": [
-            "pulling": 1
+        {
-        },
+            "predicate": {
-        "model": "tutorial:item/example_bow_pulling_0"
+                "pulling": 1
-    },
+            },
-    {
+            "model": "tutorial:item/example_bow_pulling_0"
-        "predicate": {
-            "pulling": 1,
-            "pull": 0.65
         },
-        "model": "tutorial:item/example_bow_pulling_1"
+        {
-    },
+            "predicate": {
-    {
+                "pulling": 1,
-        "predicate": {
+                "pull": 0.65
-            "pulling": 1,
+            },
-            "pull": 0.9
+            "model": "tutorial:item/example_bow_pulling_1"
         },
-        "model": "tutorial:item/example_bow_pulling_2"
+        {
-    }
+            "predicate": {
-]
+                "pulling": 1,
+                "pull": 0.9
+            },
+            "model": "tutorial:item/example_bow_pulling_2"
+        }
+    ]
+}
 </code>
-Minecraft运作的方式是，在指定的值中，检查模型大于等于的值的最后一个值。所以拉伸值为''0.8''时，会使用''tutorial:item/example_bow_pulling_1''，而值为''0.5''时使用''tutorial:item/example_bow_pulling_0''。
+Minecraft 运作的方式是，在指定的值中，检查模型大于等于的值的最后一个值。所以拉伸值为 ''0.8'' 时，会使用 ''tutorial:item/example_bow_pulling_1''，而值为 ''0.5'' 时使用''tutorial:item/example_bow_pulling_0''。