Differences

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

--- zh_cn:tutorial:blockappearance [2019/12/19 05:53] – lightcolour
+++ zh_cn:tutorial:blockappearance [2025/06/10 16:40] (current) – solidblock
@@ Line 1: / Line 1: @@
 ====== 操纵方块的外观 ======
-===== 使方块透明 =====
+//这是教程的 1.15+ 版本。如需 1.14 版本，请参考[[tutorial:1.14:blockappearance|操纵方块的外观（1.14）（英文）]]。//
-您可能已经注意到，即使块的纹理是透明的，它仍然看起来是不透明的。
+===== 使方块透明或半透明 =====
-要解决此问题，请覆盖''getRenderLayer''并返回''BlockRenderLayer.TRANSLUCENT''：
+你可能已经注意到，即使方块的纹理是透明或半透明的，看起来仍是不透明的。如需解决，请将方块的渲染层设为 cutout 或 transparent。
-<code java>
-class MyBlock extends Block {
+在[[zh_cn:documentation:entrypoint|客户端模组初始化器]]中，添加：
-    @Override
-    public BlockRenderLayer getRenderLayer() {
+//对于 1.21.5 及以下版本：//
-        return BlockRenderLayer.TRANSLUCENT;
+<yarncode java ExampleModClient.java>
+@Environment(EnvType.CLIENT)
+public class ExampleModClient implements ClientModInitializer {
+    public void onInitializeClient() {
+        // 如果方块一些部分是透明的（例如玻璃、树苗、门）：
+        BlockRenderLayerMap.INSTANCE.putBlock(TutorialBlocks.MY_BLOCK, RenderLayer.getCutout());
+        // 如果方块一些部分是半透明的（例如冰、染色玻璃、传送门）：
+        BlockRenderLayerMap.INSTANCE.putBlock(TutorialBlocks.MY_BLOCK, RenderLayer.getTranslucent());
     }
+}
+</yarncode>
-    [...]
+//对于 1.21.6 及以上版本：//
+<yarncode java ExampleModClient.java>
+@Environment(EnvType.CLIENT)
+public class ExampleModClient implements ClientModInitializer {
+    public void onInitializeClient() {
+        // 如果方块一些部分是透明的（例如玻璃、树苗、门）：
+        BlockRenderLayerMap.putBlock(TutorialBlocks.MY_BLOCK, BlockRenderLayer.CUTOUT);
+        // 如果方块一些部分是半透明的（例如冰、染色玻璃、传送门）：
+        BlockRenderLayerMap.putBlock(TutorialBlocks.MY_BLOCK, BlockRenderLayer.TRANSLUCENT);
+    }
 }
+</yarncode>
-</code>
+您可能还想使方块非不透明。为此，可在方块设置中使用 ''<yarn method_22488>'' 方法，这也会使方块内部也渲染。
-您可能还想使方块透明。 为此，请使用Material构造函数将''blocksLight''设置为false。
+<yarncode java>
-<code java>
+     public static final Block MY_BLOCK = new Block(AbstractBlock.Settings.create().method_22488());
-class MyBlock extends Block {
+</yarncode>
-     private static Material myMaterial = new Material(
-            MaterialColor.AIR,   //materialColor,
-            false,   //isLiquid,
-            false, // isSolid,
-            true, // blocksMovement,
-            false,// blocksLight,  <----- Important part, the other parts change as you wish
-            true,//  !requiresTool,
-            false, //  burnable,
-            false,//  replaceable,
-            PistonBehavior.NORMAL//  pistonBehavior
-    );
-    public MyBlock() {
+如果你不像这样把方块标记为非不透明的，则方块后面的面不会渲染，你将会“看穿”整个世界（到虚空或渲染范围之外之类的）。
-        super(Settings.of(myMaterial);
-    }
-    [...]
+确保在 [[documentation:fabric_mod_json|fabric.mod.json]] 中添加了客户端入口点，你可以这样做：
+<code javascript>
+{
+  [...]
+  "entrypoints": {
+    "main": [
+      "net.fabricmc.example.ExampleMod"
+    ],
+    "client": [
+      "net.fabricmc.example.ExampleModClient"
+    ]
+  },
+  [...]
 }
 </code>
+注意：对于不透明但不完整的方块，你可能需要覆盖 ''<yarn method_9530>'' 方法并返回非完整的图形，以避免看穿整个世界。
 ===== 使方块不可见 =====
-首先，我们需要使该方块看起来不可见。
+首先，我们需要使该方块看起来不可见。为此，我们在方块类中重写 ''<yarn method_9604>'' 并返回 ''<yarn class_2464>.<yarn field_11455>''：
-为此，我们在块类中重写''getRenderType''并返回''BlockRenderType.INVISIBLE''：
+<yarncode java>
-<code java>
     @Override
-    public BlockRenderType getRenderType(BlockState blockState) {
+    public class_2464 method_9604(class_2680 state) {
-        return BlockRenderType.INVISIBLE;
+        return class_2464.field_11455;
     }
-</code>
+</yarncode>
-然后，我们需要通过使其''outlineShape''不存在来使我们的块不可选择。
-因此，覆盖''getOutlineShape''并返回一个空的''VoxelShape''：
+然后，我们需要通过使其形状不存在，从而使方块不能被选中。因此，覆盖 ''<yarn method_9530>'' 并返回一个空的 ''<yarn class_265>''：
-<code java>
+<yarncode java>
     @Override
-    public VoxelShape getOutlineShape(BlockState blockState, BlockView blockView, BlockPos blockPos, EntityContext entityContext) {
+    public class_265 method_9530(class_2680 state, class_1922 blockView, class_2338 pos, class_3726 context) {
-       return VoxelShapes.cuboid(0,0,0,0,0,0);
+       return class_259.method_1073();
     }
-</code>
+</yarncode>