2.6

docs/mconline/15-玩法组件教程/15-自定义特征和特征规则/4-了解自定义单方块特征规则.md

@@ -0,0 +1,117 @@
+---
+front: https://nie.res.netease.com/r/pic/20211104/69055361-2e7a-452f-8b1a-f23e1262a03a.jpg
+hard: 高级
+time: 15分钟
+---
+
+# 了解自定义单方块特征规则
+
+在本节中，我们继续来看另外一种特征，也就是单方块特征的生成。我们制作一个蓝色蕨方块来进行演示。
+
+## 使用编辑器配置蕨类方块
+
+![](./images/16.4_blue_fern.png)
+
+我们在编辑器中配置一个蓝色的蕨。注意，我们需要将其配置为非固体、透明且不吸收光线，同时具备一个裁剪体积却不具备碰撞体积的样子。我们将其标识符设置为`tutorial_demo:blue_fern`。
+
+然后，为了使其具备蕨类的形状，我们需要使用原版的方块形状来做到这一点。我们在资源包的`blocks.json`中手动配置如下：
+
+```json
+{
+    "format_version": [1, 1, 0],
+    "tutorial_demo:blue_fern": {
+        "blockshape": "cross_texture",
+        "textures": "tutorial_demo:blue_fern"
+    }
+}
+```
+
+这样，我们就成功使用了交叉纹理的方块形状，使其具备了如原版的草和树苗等方块的交叉形状。
+
+## 设置蕨类单方块特征
+
+我们在特征文件夹中新建一个`blue_fern_feature.json`文件，并填充如下：
+
+```json
+{
+  "format_version": "1.13.0",
+  "minecraft:single_block_feature": {
+    "description": {
+      "identifier": "tutorial_demo:blue_fern_feature"
+    },
+    "places_block": "tutorial_demo:blue_fern",
+    "enforce_survivability_rules": true,
+    "enforce_placement_rules": true,
+	"may_attach_to": {
+      "auto_rotate": false,
+      "min_sides_must_attach": 1,
+      "bottom": [
+        "minecraft:grass",
+        "minecraft:dirt"
+      ]
+    },
+    "may_replace": [
+      "minecraft:air"
+    ]
+  }
+}
+```
+
+我们希望我们的蓝色蕨只能在泥土和草方块上生成，并且只能替换空气，这是因为我们想避免其在空中、水中生成或者直接替换了其他的不该替换的方块比如树干方块，所以我们修改`may_attach_to`和`may_replace`来达到这一效果。
+
+单方块特征的输入和输出位置为同一个坐标，同时如若方块成功放置即可判定成功，方块放置失败即为判定失败。
+
+## 挂接特征规则
+
+我们在特征规则文件夹中建立`overworld_first_blue_fern_feature.json`文件，然后写入：
+
+```json
+{
+  "format_version": "1.13.0",
+  "minecraft:feature_rules": {
+    "description": {
+      "identifier": "tutorial_demo:overworld_first_blue_fern_feature",
+      "places_feature": "tutorial_demo:blue_fern_feature"
+    },
+    "conditions": {
+      "placement_pass": "first_pass",
+      "minecraft:biome_filter": [
+        {
+          "any_of": [
+            {
+              "test": "has_biome_tag",
+              "operator": "==",
+              "value": "overworld"
+            },
+            {
+              "test": "has_biome_tag",
+              "operator": "==",
+              "value": "overworld_generation"
+            }
+          ]
+        }
+      ]
+    },
+    "distribution": {
+      "iterations": 1,
+      "x": {
+        "distribution": "uniform",
+        "extent": [ 0, 16 ]
+      },
+      "y": "query.heightmap(variable.worldx, variable.worldz)",
+      "z": {
+        "distribution": "uniform",
+        "extent": [ 0, 16 ]
+      }
+    }
+  }
+}
+```
+
+习惯上我们命名特征规则时将生成的位置，比如主世界还是哪些生物群系放在最前面，然后生成的放置阶段放在中间，生成的物体名称放在阶段之后，最后和特征一样使用`feature`结尾。不过，每个开发者也有自己的命名习惯，不必拘泥于原版我的世界的命名习惯。
+
+我们在每个区块中生成一个我们的蓝色蕨方块来试验效果。所以我们将迭代次数`iterations`设为1。
+
+![](./images/16.4_blue_fern_in-game.png)
+
+可以看到，我们的蓝色蕨确实如我们希望的那样进行生成了！