This is an old revision of the document!

使用方块实体渲染器动态渲染方块和物品

这是本教程的1.15版本。对于1.14版本，请参见使用方块实体渲染器动态渲染方块和物品（1.14）。

阅读本教程之前，请确保您已添加方块实体！

介绍

方块本身并不是那么有趣，它们只是在某个位置和某个大小保持静止直到损坏。我们可以使用方块实体渲染器来更加动态地渲染与方块实体相关联的项目和方块-渲染多个不同的项目，在不同的位置和大小，甚至更多。

例子

在本教程中，我们将通过向其添加BlockEntityRenderer来构建所创建的方块实体。渲染器将显示一个唱片机，漂浮在方块上方，上下移动并旋转。

我们需要做的第一件事是创建我们的BlockEntityRenderer类：

public class MyBlockEntityRenderer extends BlockEntityRenderer<DemoBlockEntity> {
    // 唱片机物品栏位
    private static ItemStack stack = new ItemStack(Items.JUKEBOX, 1);
 
    public MyBlockEntityRenderer(BlockEntityRenderDispatcher dispatcher) {
        super(dispatcher);
    }
 
    @Override
    public void render(DemoBlockEntity blockEntity, float tickDelta, MatrixStack matrices, VertexConsumerProvider vertexConsumers, int light, int overlay) {
    }
}

我们将需要注册我们的BlockEntityRenderer，但仅针对客户端。在单人游戏设置中这无关紧要，因为服务器与客户端在同一进程中运行。但是，在多人游戏设置中，服务器在与客户端不同的进程中运行，服务器代码没有BlockEntityRenderer的概念，因此不接受注册。要仅为客户端运行初始化代码，我们需要设置一个client入口点（entrypoint）。

在实现ClientModInitializer的主类旁边创建一个新类：

public class ExampleModClient implements ClientModInitializer {
    @Override
    public void onInitializeClient() {
        // 这里我们放置只在客户端注册的代码
    }
}

将此类设置为fabric.mod.json中的“client”入口点（根据需要修改路径）：

"fabric.mod.json"

"entrypoints": {
    [...]
    "client": [
      {
        "value": "到ExampleModClient的路径"
      }
    ]
}

在我们的ClientModInitializer中注册BlockEntityRenderer：

@Override
public void onInitializeClient() {
    BlockEntityRendererRegistry.INSTANCE.register(DEMO_BLOCK_ENTITY, MyBlockEntityRenderer::new);
}

我们重写在每一帧都会被调用的render方法，我们将在其中进行渲染——对于初学者，请调用matrices.push();，这在进行GL调用时是必需的（我们将在紧接之后进行）：

    public void render(DemoBlockEntity blockEntity, float tickDelta, MatrixStack matrices, VertexConsumerProvider vertexConsumers, int light, int overlay) {
       matrices.push();
    }

然后，我们对唱片机进行平移（matrices.translate）和旋转（matrices.multiply）。转换分为两部分：将其转换为高于方块中心的0.5、1.25和0.5。第二部分是更改的部分：y值的偏移量。偏移量是任何给定框架的项目高度。每次我们都要重新计算，因为我们希望它可以动画上下跳跃。我们通过以下方式计算：

获取当前世界时间，该时间会随着时间而变化。
添加部分刻度。（部分刻度线是一个小数值，代表最后一次完整刻度线和现在之间的时间间隔。我们使用此方法是因为否则动画会抖动，因为每秒的刻度数少于每秒的帧数。）
用8除以减慢运动速度。
以正弦值产生介于-1和1之间的值，类似于正弦波。
将其除以4可垂直压缩正弦波，因此该项目不会上下移动太多。

    public void render(DemoBlockEntity blockEntity, float tickDelta, MatrixStack matrices, VertexConsumerProvider vertexConsumers, int light, int overlay) {
        [...]
        // Calculate the current offset in the y value
        double offset = Math.sin((blockEntity.getWorld().getTime() + tickDelta) / 8.0) / 4.0;
        // Move the item
        matrices.translate(0.5, 1.25 + offset, 0.5);
 
        // Rotate the item
        matrices.multiply(Vector3f.POSITIVE_Y.getDegreesQuaternion((blockEntity.getWorld().getTime() + tickDelta) * 4));
    }

最后，我们将获得Minecraft的ItemRenderer，并使用renderItem渲染唱片机物品。我们还将ModelTransformation.Type.GROUND传递给renderItem，因为我们希望有类似与物品置于地上的效果。尝试尝试使用此值，看看会发生什么（这是一个枚举）。

在这些GL调用之后，我们还需要调用matrices.pop();：

    public void render(DemoBlockEntity blockEntity, float tickDelta, MatrixStack matrices, VertexConsumerProvider vertexConsumers, int light, int overlay) {
        [...]
        MinecraftClient.getInstance().getItemRenderer().renderItem(stack, ModelTransformation.Type.GROUND, light, overlay, matrices, vertexConsumers);
 
        // Mandatory call after GL calls
        matrices.pop();
    }

您现在就可以尝试新创建的方块实体渲染器。但是，如果您没有使方块透明，您会发现有些不对劲——浮动的方块，唱片机是黑色的！这是因为默认情况下，无论您在方块实体中渲染什么，都将接收该方块实体所在位置的光照度。所以浮动的方块接收这个不透明方块内部的光照，这意味着接收不到光。为了解决此问题，我们会让Minecraft接收方块实体上方位置的光照强度。

要获取光照，我们在方块实体上方的位置调用WorldRenderer#getLightmapCoordinates();，并在renderItem()使用这个光照。

    @Override
    public void render(DemoBlockEntity blockEntity, float tickDelta, MatrixStack matrices, VertexConsumerProvider vertexConsumers, int light, int overlay) {
        [...]
 
        int lightAbove = WorldRenderer.getLightmapCoordinates(blockEntity.getWorld(), blockEntity.getPos().up());
        MinecraftClient.getInstance().getItemRenderer().renderItem(stack, ModelTransformation.Mode.GROUND, lightAbove, OverlayTexture.DEFAULT_UV, matrices, vertexConsumers);
 
        [...]
    }

唱片机现在应该得到了适当的光照。

Fabric Wiki

Table of Contents

使用方块实体渲染器动态渲染方块和物品

介绍

例子