目录结果整理

2024-11-07 17:50:05 +08:00
parent 336c89c2b2
commit 4d7cb65f5c
799 changed files with 353 additions and 542 deletions
--- a/docs/103.4理解Json/7-重温：自定义方块/1-基本属性.md
+++ b/docs/103.4理解Json/7-重温：自定义方块/1-基本属性.md
@@ -0,0 +1,113 @@
+# 基本属性
+
+在下面这几节中我们一起来回顾学习方块相关的自定义JSON文件。首先，我们在编辑器中新建一个自定义方块作为示例并观察他的JSON结构。
+
+## 在编辑器中创建
+
+![image-20240923133828819](./assets/image-20240923133828819.png)
+
+我们创建一个空的标识符为`test:test_block`的方块。
+
+![image-20240923135831634](./assets/image-20240923135831634.png)
+
+我们在行为包组件中添加一些最基本的常用组件作为示例。
+
+![image-20240923135844089](./assets/image-20240923135844089.png)
+
+以上是添加了行为包组件之后的编辑器中显示效果。
+
+![image-20240923135117305](./assets/image-20240923135117305.png)
+
+我们再在“方块属性列表”栏中添加一些属性。
+
+![image-20240923135148504](./assets/image-20240923135148504.png)
+
+![image-20240923135201136](./assets/image-20240923135201136.png)
+
+我们如图所示添加一些内容。
+
+## 实际文件
+
+虽然只有行为包中有存储方块定义的`netease_blocks`文件夹，但实际上方块也需要在客户端中进行定义。在客户端中定义方块的是一个独立文件`blocks.json`文件，这个文件就位于客户端的根目录中。我们先查看`blocks.json`文件：
+
+```json
+{
+    "format_version": [
+        1,
+        1,
+        0
+    ],
+    "test:loot": {
+        "textures": "test:barrel_side"
+    },
+    "test:test_block": {
+        "isotropic": {
+            "down": false,
+            "east": false,
+            "north": false,
+            "south": false,
+            "up": false,
+            "west": false
+        },
+        "sound": "stone",
+        "textures": "test:custom_dirt"
+    }
+}
+```
+
+可以看到，我们定义过的所有方块其实都会出现在这同一文件中，该文件中可以定义方块的一系列客户端属性。`textures`用于定义方块使用的纹理，`sound`用于定义方块使用的音效，`isotropic`用于定义方块是否具有“各向异性”效果，即贴图随着坐标不同随机旋转或变化。
+
+我们再来观察方块的行为包定义文件。方块的行为包定义文件位于行为包的`netease_blocks`文件夹下，打开之后如下所示：
+
+```json
+{
+    "format_version": "1.10.0",
+    "minecraft:block": {
+        "components": {
+            "minecraft:destroy_time": {
+                "value": 0.0
+            },
+            "minecraft:explosion_resistance": {
+                "value": 0.0
+            },
+            "minecraft:map_color": {
+                "color": "#000000"
+            },
+            "minecraft:max_stack_size": {
+                "value": 64
+            },
+            "netease:aabb": {
+                "clip": [
+
+                ],
+                "collision": [
+
+                ]
+            },
+            "netease:fuel": {
+                "duration": 0
+            },
+            "netease:pathable": {
+                "value": true
+            },
+            "netease:render_layer": {
+                "value": "opaque"
+            },
+            "netease:solid": {
+                "value": false
+            }
+        },
+        "description": {
+            "identifier": "test:test_block"
+        }
+    }
+}
+```
+
+整个结构与物品、实体非常类似，只是组件有所不同。
+
+`minecraft:destroy_time`用于指定方块的硬度，原版方块的硬度可以在Minecraft Wiki的[方块挖掘时间](https://zh.minecraft.wiki/w/%E6%8C%96%E6%8E%98/%E6%96%B9%E5%9D%97%E6%8C%96%E6%8E%98%E6%97%B6%E9%97%B4)页面找到。`minecraft:explosion_resistance`用于指定方块的爆炸抗性。`minecraft:map_color`用于指定方块在地图上显示的颜色。
+
+`netease:aabb`是中国版自定义的组件，可以指定方块的碰撞箱和击中箱。`netease:fuel`可以用来指定方块成为熔炉燃料。`netease:pathable`用于指定是否可被生物寻路。`netease:render_layer`用于指定该方块在渲染时的渲染图层，也即渲染时的透明性。`netease:solid`用于指定方块是否有固体属性。
+
+关于更多的方块组件内容及使用方法，可以参考官方文档自定义方块的[JSON组件](https://mc.163.com/dev/mcmanual/mc-dev/mcguide/20-%E7%8E%A9%E6%B3%95%E5%BC%80%E5%8F%91/15-%E8%87%AA%E5%AE%9A%E4%B9%89%E6%B8%B8%E6%88%8F%E5%86%85%E5%AE%B9/2-%E8%87%AA%E5%AE%9A%E4%B9%89%E6%96%B9%E5%9D%97/1-JSON%E7%BB%84%E4%BB%B6.html?catalog=1)章节。