🟰 物品模型

简介

自 1.21.4 版本起，Minecraft 开始支持更复杂的物品模型。这允许你为物品创建更具动态性的变体。本文档专为 1.21.4 及以上版本编写。对于旧版本，插件将自动降级相应的模型文件（注意：这并非 100% 兼容旧版本，因为许多条件和模型类型在旧版本中并不存在）。

入门指南 | 教程🏹 物品模型展示

信息

如果你发现 CraftEngine 在最新的 Minecraft 版本中缺少某些功能，可以在 GitHub 上提交提议，以引起开发者的注意。

旧版模型

旧版模型特指 1.21.3 及更早版本中使用的物品模型格式。你可以通过 legacy-model 部分来指定旧版物品模型格式。然而，在大多数情况下，你无需这样做，因为插件会尽可能自动将 1.21.4 的物品模型转换为旧版格式。只有当旧版模型格式出现问题时，你才应该使用此配置部分。

items#topaz_gears:
  default:topaz_rod:
    material: fishing_rod
    item-model: default:topaz_rod
    custom-model-data: 1000
    settings:
      tags:
        - "default:topaz_tools"
    data:
      item-name: "<!i><#FF8C00><i18n:item.topaz_rod>"
      tooltip-style: minecraft:topaz
    model:
      template: default:model/simplified_fishing_rod_2d
      arguments:
        path: minecraft:item/custom/topaz_rod
        cast_path: minecraft:item/custom/topaz_rod_cast
    # 如果你在 legacy-model 部分中指定了模型，
    # 插件将使用你手动定义的模型，
    # 而不是依赖自动转换的旧版格式。
    legacy-model:
      path: minecraft:item/custom/topaz_rod
      overrides:
        - path: minecraft:item/custom/topaz_rod_cast
          predicate: 
            cast: 1

提示

如果你不需要支持 1.21.4 以上的版本，你可以只配置 legacy-model 部分，并完全省略 model 部分。