合并物品模型

合并物品模型

合并所有已启用资源包中的物品模型定义

合并物品模型

Discord 问题追踪器

自 1.21.4 起,资源包通过 物品模型定义(assets/<namespace>/items/<item>.json)来自定义物品:重命名、自定义模型数据、变体等等。原版只从最顶层的资源包读取这个文件,因此当两个资源包修改同一个物品时,下面那个资源包添加的一切都会消失。

Merged Item Models 会以正确的方式合并所有已启用资源包中的这些文件。

来自两个资源包的重命名

来自两个资源包的食物

工作原理

资源包按从上到下的顺序合并。凡是上层资源包回退到物品默认外观的地方,就改为使用下层资源包的定义。当出现以下情况时会自动检测为回退:

  • 物品的默认模型,例如 {"type": "minecraft:model", "model": "minecraft:item/diamond_sword"},除非该资源包用自己的模型替换了它;
  • 与原版定义完全相同的副本,资源包经常对指南针、时钟、盾牌等复杂物品这样做。

此外:

  • 物品属性(hand_animation_on_swap、oversized_in_gui、swap_animation_scale)取自设置了它们的最高合并资源包;
  • 某个资源包中的损坏文件会被跳过,下层资源包仍可正常工作。

已使用下载量前 10 的物品资源包进行测试

这是 Modrinth 上 1.21.11 版本下载量最高的 10 个会修改物品模型的资源包,同时启用。在原版中,每个物品只能被一个资源包修改,因此无论顺序如何,它们共计 247 处物品修改中最多只有 160 处会显示出来。使用本模组后可显示 242 处。剩下的 5 处是资源包以不同方式绘制同一内容,例如三个资源包各有自己的附魔书纹理。

下载量前 10 的物品资源包,全部启用

  1. Enchantment Outlines,作者 tixul
  2. Even Better Enchants,作者 mythitorium
  3. Visual: Armor Trims,作者 thanos
  4. Fresh Waystones Texture,作者 zozozrob
  5. Theone's Eating Animation Pack,作者 theoness1
  6. Fresh Food,作者 cyber
  7. Patrix 32x,作者 patrixcraft
  8. Enchanted Books: Re-covered,作者 carl_classic
  9. Ashen 16x,作者 Aim_Boot
  10. Beautiful Enchanted Books,作者 Lupin

致资源包作者

大多数情况下无需做任何事。若要显式控制合并,可为任意模型添加 mim:properties:

{
  "type": "minecraft:model",
  "model": "minecraft:item/my_sword",
  "mim:properties": { "merge": true }
}
  • "merge": true 会用下层资源包的定义替换此模型;
  • "merge": false 会保持原样,即使它看起来像回退。

未安装本模组时,该字段会被直接忽略。

致模组开发者

MergedItemModelsApi.getSourcePack(model) 返回读取该模型所用资源包的 id,例如 vanilla 或 file/Pack.zip。可用于显示某个重命名来自哪个资源包。

兼容性

本模组的设计目标是尽量不干扰其他模组。它只改变物品模型文件的读取方式,结果仍是常规的原版物品模型,因此读取、修改或渲染物品模型的模组可照常工作。

  • 仅客户端,无依赖。
  • 仅合并物品模型定义。OptiFine CIT 的 .properties 文件不受影响。

截图中的资源包:Excalibur,作者 Maffhew;KSEPSP,作者 NotAWhale;Fresh Food,作者 cyber。