Fabric Wiki

User Tools

Site Tools

Trace: • Manipulating a Block's appearance • Fabric Loader • Publishing mods on CurseForge with CurseGradle
zh_cn:tutorial:blockentityrenderers

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision		Previous revision
Last revisionBoth sides next revision
zh_cn:tutorial:blockentityrenderers [2021/09/28 14:13] – solidblockzh_cn:tutorial:blockentityrenderers [2023/08/29 09:59] – [例子] wjz_p
Line 1: Line 1:
 ====== 使用方块实体渲染器动态渲染方块和物品 ====== ====== 使用方块实体渲染器动态渲染方块和物品 ======
 // //
-这是本教程的1.15和1.16版本。对于1.14版本，请参见[[zh_cn:tutorial:1.14:blockentityrenderers|使用方块实体渲染器动态渲染方块和物品（1.14）]]。//+这是本教程的 1.15 以上版本。对于 1.14 版本，请参见[[zh_cn:tutorial:1.14:blockentityrenderers|使用方块实体渲染器动态渲染方块和物品（1.14）]]。//
  
-阅读本教程之前，请确保您已[[zh_cn:tutorial:blockentity|添加方块实体]]！+阅读本教程之前，请确保您已[[blockentity|添加方块实体]]！
 ===== 介绍 ===== ===== 介绍 =====
 方块本身并不是那么有趣，只是在某个位置和某个大小保持静止直到损坏。我们可以使用方块实体渲染器（block entity renderer）更加动态地渲染与方块实体有关的物品和方块——在不同的位置、以不同的大小渲染多个物品。 方块本身并不是那么有趣，只是在某个位置和某个大小保持静止直到损坏。我们可以使用方块实体渲染器（block entity renderer）更加动态地渲染与方块实体有关的物品和方块——在不同的位置、以不同的大小渲染多个物品。
Line 11: Line 11:
 我们需要做的第一件事是创建我们的 ''BlockEntityRenderer'' 类： 我们需要做的第一件事是创建我们的 ''BlockEntityRenderer'' 类：
 <code java> <code java>
-public class DemoBlockEntityRenderer extends BlockEntityRenderer<DemoBlockEntity> {+@Environment(EnvType.CLIENT) 
 +public class DemoBlockEntityRenderer implements BlockEntityRenderer<DemoBlockEntity> {
     // 唱片机物品堆     // 唱片机物品堆
     private static ItemStack stack = new ItemStack(Items.JUKEBOX, 1);     private static ItemStack stack = new ItemStack(Items.JUKEBOX, 1);
          
-    public DemoBlockEntityRenderer(BlockEntityRenderDispatcher dispatcher) { +    public DemoBlockEntityRenderer(BlockEntityRendererFactory.Context ctx) {}
-        super(dispatcher); +
-    }+
          
     @Override     @Override
Line 30: Line 29:
  
 <code java> <code java>
 +@Environment(EnvType.CLIENT)
 public class ExampleModClient implements ClientModInitializer { public class ExampleModClient implements ClientModInitializer {
     @Override     @Override
Line 49: Line 49:
 </code> </code>
  
-在我们的ClientModInitializer中注册 ''BlockEntityRenderer''：+在我们的 ClientModInitializer 中注册 ''BlockEntityRenderer''：
  
 <code java> <code java>
-@Override +    @Override 
-public void onInitializeClient() { +    public void onInitializeClient() { 
-    BlockEntityRendererRegistry.INSTANCE.register(DEMO_BLOCK_ENTITY, DemoBlockEntityRenderer::new); +        BlockEntityRendererRegistry.register(DEMO_BLOCK_ENTITY, DemoBlockEntityRenderer::new); 
-}+        //不行就试试BlockEntityRendererRegistry.INSTANCE.register(DEMO_BLOCK_ENTITY, DemoBlockEntityRenderer::new); 
 +    }
 </code> </code>
 我们重写在每一帧都会被调用的 ''render'' 方法，我们将在其中进行渲染——对于初学者，请调用 ''matrices.push();''，这在进行GL调用时是必需的（我们将在紧接之后进行）： 我们重写在每一帧都会被调用的 ''render'' 方法，我们将在其中进行渲染——对于初学者，请调用 ''matrices.push();''，这在进行GL调用时是必需的（我们将在紧接之后进行）：
Line 64: Line 65:
     }     }
 </code> </code>
-然后，我们对唱片机进行平移（matrices.translate）和旋转（matrices.multiply）。平移分为两部分：将其平移到高于方块中心的0.5、1.25和0.5。第二部分是变化的部分：y值的偏移量。偏移量是任何给定帧的物品高度。每次我们都要重新计算，因为我们希望它可以动画上下跳跃。我们通过以下方式计算：+然后，我们对唱片机进行平移（matrices.translate）和旋转（matrices.multiply）。平移分为两部分：将其平移到高于方块中心的 0.5、1.25 和 0.5。第二部分是变化的部分：y 值的偏移量。偏移量是任何给定帧的物品高度。每次我们都要重新计算，因为我们希望它可以动画上下跳跃。我们通过以下方式计算：
    *获取当前世界时间，该时间会随着时间而变化。    *获取当前世界时间，该时间会随着时间而变化。
    *添加部分刻。（部分刻是一个小数值，代表最后一次完整刻和现在之间的时间间隔。我们使用此方法，要不然动画会抖动，因为每秒的刻数少于每秒的帧数。）    *添加部分刻。（部分刻是一个小数值，代表最后一次完整刻和现在之间的时间间隔。我们使用此方法，要不然动画会抖动，因为每秒的刻数少于每秒的帧数。）
Line 79: Line 80:
  
         // 旋转物品         // 旋转物品
-        matrices.multiply(Vector3f.POSITIVE_Y.getDegreesQuaternion((blockEntity.getWorld().getTime() + tickDelta) * 4));+        matrices.multiply(Vec3f.POSITIVE_Y.getDegreesQuaternion((blockEntity.getWorld().getTime() + tickDelta) * 4));
     }     }
 </code> </code>
-最后，我们将获得Minecraft的 ''ItemRenderer''，并使用 ''renderItem'' 渲染唱片机物品。我们还将 ''ModelTransformation.Type.GROUND'' 传递给 ''renderItem''，因为我们希望有类似与物品置于地上的效果。尝试对此值进行试验，看看会发生什么（这是一个枚举）。在这些 GL 调用之后，我们还需要调用''matrices.pop();''：+最后，我们将获得 Minecraft 的 ''ItemRenderer''，并使用 ''renderItem'' 渲染唱片机物品。我们还将 ''ModelTransformation.Type.GROUND'' 传递给 ''renderItem''，因为我们希望有类似与物品置于地上的效果。尝试对此值进行试验，看看会发生什么（这是一个枚举）。在这些 GL 调用之后，我们还需要调用''matrices.pop();''：
 <code java> <code java>
     public void render(DemoBlockEntity blockEntity, float tickDelta, MatrixStack matrices, VertexConsumerProvider vertexConsumers, int light, int overlay) {     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);+        MinecraftClient.getInstance().getItemRenderer().renderItem(stack, ModelTransformation.Mode.GROUND, light, overlay, matrices, vertexConsumers, 0);
  
         // GL 调用之后的必要调用         // GL 调用之后的必要调用
Line 95: Line 96:
 您现在就可以尝试新创建的方块实体渲染器。但是，如果您没有使方块透明，您会发现有些不对劲——这个浮动的方块，即唱片机，是黑色的！这是因为默认情况下，//无论您在方块实体中渲染什么，都将接收该方块实体所在位置的光照度//。所以浮动的方块接收这个不透明方块内部的光照，这意味着接收不到光。为了解决此问题，我们会让Minecraft接收方块实体上方位置的光照强度。 您现在就可以尝试新创建的方块实体渲染器。但是，如果您没有使方块透明，您会发现有些不对劲——这个浮动的方块，即唱片机，是黑色的！这是因为默认情况下，//无论您在方块实体中渲染什么，都将接收该方块实体所在位置的光照度//。所以浮动的方块接收这个不透明方块内部的光照，这意味着接收不到光。为了解决此问题，我们会让Minecraft接收方块实体上方位置的光照强度。
  
-要获取光照，我们在方块实体上方的位置调用''WorldRenderer#getLightmapCoordinates();''，并在''renderItem()''使用这个光照。+要获取光照，我们在方块实体上方的位置调用 ''WorldRenderer#getLightmapCoordinates();''，并在 ''renderItem()'' 使用这个光照。
 <code java> <code java>
     @Override     @Override
Line 102: Line 103:
                  
         int lightAbove = WorldRenderer.getLightmapCoordinates(blockEntity.getWorld(), blockEntity.getPos().up());         int lightAbove = WorldRenderer.getLightmapCoordinates(blockEntity.getWorld(), blockEntity.getPos().up());
-        MinecraftClient.getInstance().getItemRenderer().renderItem(stack, ModelTransformation.Mode.GROUND, lightAbove, OverlayTexture.DEFAULT_UV, matrices, vertexConsumers);+        MinecraftClient.getInstance().getItemRenderer().renderItem(stack, ModelTransformation.Mode.GROUND, lightAbove, OverlayTexture.DEFAULT_UV, matrices, vertexConsumers, 0);
                  
         [...]         [...]
Line 109: Line 110:
  
 唱片机现在应该得到了适当的光照。 唱片机现在应该得到了适当的光照。
 +
 +===== 根据方块实体数据进行渲染 =====
 +有时候你需要根据方块实体的数据（nbt）进行渲染，结果发现这些数据全是空的，尽管通过 ''/data get block'' 命令可以正常访问数据。这是因为你没有将服务器的数据同步至客户端。参见[[zh_cn:tutorial:blockentity#将服务器数据同步至客户端]]。
zh_cn/tutorial/blockentityrenderers.txt · Last modified: 2023/08/29 10:31 by wjz_p