
合并物品模型
合并所有已启用资源包中的物品模型定义
自 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 处是资源包以不同方式绘制同一内容,例如三个资源包各有自己的附魔书纹理。

- Enchantment Outlines,作者 tixul
- Even Better Enchants,作者 mythitorium
- Visual: Armor Trims,作者 thanos
- Fresh Waystones Texture,作者 zozozrob
- Theone's Eating Animation Pack,作者 theoness1
- Fresh Food,作者 cyber
- Patrix 32x,作者 patrixcraft
- Enchanted Books: Re-covered,作者 carl_classic
- Ashen 16x,作者 Aim_Boot
- 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。
正在加载版本记录…
正在加载评论…
评论在新手盒子客户端中发表,这里同步展示。