首次上传

docs/netease-tutorial-103.4-main/6-重温：自定义生物/1-基本结构.md

@@ -0,0 +1,67 @@
+# 基本结构
+
+在下面这几节中我们一起来回顾学习实体相关的自定义JSON文件。和之前一样，我们首先来回顾编辑器中创建的实体。
+
+## 在编辑器中添加
+
+![image-20240923110420440](./assets/image-20240923110420440.png)
+
+我们在新建文件向导中新建一个实体配置。标识符设置为`test:test_entity`，模板选择空。
+
+![image-20240923110506668](./assets/image-20240923110506668.png)
+
+可以看到，虽然我们创建了一个空白的实体，但编辑器依旧为我们添加了“持久化保存”的行为包组件，该组件代表着实体在生成之后不会通过自动毁除（despawn）机制毁除，而是会保存至存档中。
+
+资源包组件中也添加了模型和纹理的相关内容。我们很快会看到在实际JSON文件中他们的表现。
+
+## 实际文件
+
+在行为包的`entities`文件夹中，我们可以找到实体的服务端定义文件：
+
+```json
+{
+    "format_version": "1.12.0",
+    "minecraft:entity": {
+        "component_groups": {
+
+        },
+        "components": {
+            "minecraft:persistent": {
+
+            }
+        },
+        "description": {
+            "identifier": "test:test_entity",
+            "is_experimental": false
+        },
+        "events": {
+
+        }
+    }
+}
+```
+
+在资源包的`entity`文件夹中，我们可以找到实体的资源包定义文件：
+
+```json
+{
+    "format_version": "1.10.0",
+    "minecraft:client_entity": {
+        "description": {
+            "geometry": {
+                "default": ""
+            },
+            "identifier": "test:test_entity",
+            "textures": {
+                "default": ""
+            }
+        }
+    }
+}
+```
+
+可以看到，在双端`description`的`identifier`下，定义了相同的实体标识符`test:test_entity`，这可以告诉引擎他们是同一个实体的不同部分。
+
+服务端定义中的`components`是服务端的组件，这里可以看到持久化组件`minecraft:persistent`已经被添加。`component_groups`是实体的组件组，这是用于控制实体在不同状态之间切换的对象，其中可以分组定义成组的组件，然后我们可以在这些分组之间切换，可以参见Minecraft Wiki的[定义](https://zh.minecraft.wiki/w/%E5%AE%9A%E4%B9%89)页面。`events`是实体的事件，我们可以通过事件来增删组件组。
+
+在客户端定义中，我们默认只有`description`对象，和`identifier`并列的`textures`用于控制纹理，`geometry`用于控制模型。此外，还有更多的其他属性，大家可以在编辑器中可视化添加这些属性并返回JSON文件查看。我们也会在后续的章节中对其中一部分进行讲解。