渲染流程

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
public void renderStatic(ItemStack arg, ItemDisplayContext arg2, int i, int j, PoseStack arg3, MultiBufferSource arg4, @Nullable Level arg5, int k) {
    this.renderStatic((LivingEntity)null, arg, arg2, false, arg3, arg4, arg5, i, j, k);
}

public void renderStatic(@Nullable LivingEntity arg, ItemStack arg2, ItemDisplayContext arg3, boolean bl, PoseStack arg4, MultiBufferSource arg5, @Nullable Level arg6, int i, int j, int k) {
    if (!arg2.isEmpty()) {
        BakedModel bakedmodel = this.getModel(arg2, arg6, arg, k);
        this.render(arg2, arg3, bl, arg4, arg5, i, j, bakedmodel);
    }

}

public BakedModel getModel(ItemStack arg, @Nullable Level arg2, @Nullable LivingEntity arg3, int i) {
    BakedModel bakedmodel;
    if (arg.is(Items.TRIDENT)) {
        bakedmodel = this.itemModelShaper.getModelManager().getModel(TRIDENT_IN_HAND_MODEL);
    } else if (arg.is(Items.SPYGLASS)) {
        bakedmodel = this.itemModelShaper.getModelManager().getModel(SPYGLASS_IN_HAND_MODEL);
    } else {
        bakedmodel = this.itemModelShaper.getItemModel(arg);
    }

    ClientLevel clientlevel = arg2 instanceof ClientLevel ? (ClientLevel)arg2 : null;
    BakedModel bakedmodel1 = bakedmodel.getOverrides().resolve(bakedmodel, arg, clientlevel, arg3, i);
    return bakedmodel1 == null ? this.itemModelShaper.getModelManager().getMissingModel() : bakedmodel1;
}

我们从渲染调用链一步步向下看，会在renderStatic中调用getModel方法以获取模型，这里mc对三叉戟和望远镜进行了特判。让我们看看mc中三叉戟的json文件

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
{
    "parent": "builtin/entity",
    "gui_light": "front",
    "textures": {
        "particle": "item/trident"
    },
    "overrides": [
        {
            "predicate": {
                "throwing": 1
            },
            "model": "item/trident_throwing"
        }
    ]
}

这里发现他的父类型是builtin/entity，意味着它getModel返回的将是一个BuiltInModel对象，这是一个占位符空模型，意味着在以下的渲染流程中会特殊判别，其中isCustomRenderer默认返回true

接下来对普通的物品，调用getItemModel获取一个一般的物品模型，然后看看模型中有没有overrides字段，对当前模型进行替换，比如如上的三叉戟中，当符合throwing条件时，替换为item/trident_throwing模型，最后，如果前面都获取失败了，返回默认的紫黑块模型。

当然如果想要替换原版的紫黑块，可以mixin这个getMissingModel()方法

看起来mc只对三叉戟和望远镜进行了特判，但是在net.minecraft.client.renderer.entity.ItemRenderer#renderStatic中的下一步，在render方法中，麻将再次展现了他无与伦比的硬编码技术

在neoforge对render方法进行了patch，加入了net.neoforged.neoforge.client.extensions.IBakedModelExtension#getRenderPasses以便开发者可以自定义多层级模型。

1
2
3
4
5
6
7
8

boolean flag = displayContext == ItemDisplayContext.GUI || displayContext == ItemDisplayContext.GROUND || displayContext == ItemDisplayContext.FIXED;

if (!p_model.isCustomRenderer() && (!itemStack.is(Items.TRIDENT) || flag)) {
    //常规渲染
}

IClientItemExtensions.of(itemStack).getCustomRenderer().renderByItem(itemStack, displayContext, poseStack, bufferSource, combinedLight, combinedOverlay);

这里我们发现麻将再次对三叉戟进行了特判，加入到了CustomRender的行列中，在特殊的CustomRender中，将不返回模型回正常渲染流程，而是直接将模型烘焙完成后上传。

在net.minecraft.client.renderer.BlockEntityWithoutLevelRenderer#renderByItem在我们可以看到一大堆各种各样的硬编码特判，麻将你赢了。