feat:上传mcguide-开发指南部份

mcguide/20-玩法开发/15-自定义游戏内容/2-自定义方块/3-特殊方块/6-自定义重力方块.md

@@ -0,0 +1,73 @@
+---
+front: 
+hard: 入门
+time: 分钟
+---
+
+# 自定义重力方块
+
+## 概述
+
+自定义重力方块可以模拟[下落的方块](https://zh.minecraft.wiki/w/%E4%B8%8B%E8%90%BD%E7%9A%84%E6%96%B9%E5%9D%97)，并且支持在组件中修改配置、python监听事件。
+
+
+## base_block设置
+
+- 自定义重力方块的base_block需要设为`custom_heavy_block`
+
+
+
+## netease:fall
+
+| 键           | 类型  | 默认值               | 解释                                                         |
+| ------------ | ----- | -------------------- | ------------------------------------------------------------ |
+| send_python_event | bool    | false | 可选，是否发送重力方块/下落方块实体相关事件至python         |
+| fall_acceleration | float   | 0.04 | 可选，下落的方块实体每次tick的垂直加速增量 |
+| adjust_percentage | float   | 0.98    | 可选，下落的方块实体每次tick移动完后移速乘的调整数值 |
+| hurt_entity | bool   | false    | 可选，下落的方块实体结束下落后是否要计算对碰撞实体的伤害 |
+| fall_damage_amount | float   | 2.0    | 可选，原版下落伤害计算完后乘的倍率 |
+| max_fall_damage | int   | 40    | 可选，下落伤害乘完倍率后也会被限制在该值的范围内 |
+| min_height_remove_tick | int   | 100    | 可选，当下落的方块实体低于区块最低高度后多少tick将其强制删除 |
+| force_break_tick | int   | 600    | 可选，下落的方块实体多少tick后会强制被破坏 |
+| cancel_drop | bool   | false    | 可选，下落的方块实体被破坏时是否取消方块物品的掉落 |
+
+- `send_python_event`主要影响HeavyBlockStartFallingServerEvent、FallingBlockCauseDamageBeforeServerEvent、FallingBlockBreakServerEvent、FallingBlockReturnHeavyBlockServerEvent、FallingBlockCauseDamageBeforeClientEvent几个事件。
+- 如果没有在mod程序中监听的需要，可以不将`send_python_event`设为true以优化性能（不发python事件也可以配置组件的其他值）。
+- 原版对于下落的方块实体计算下落的过程使用python伪代码表示大致为
+    ```python
+    while Tick:
+        falling_block.move_vector.y -= fall_acceleration # 当前移动向量增加一个向下的力
+        move(falling_block) # 按照当前的移动向量调整实体位置
+        falling_block.move_vector *= adjust_percentage # 移动完后将当前移速（移动向量）乘个数值回调
+    ```
+- 原版下落的方块实体并没有对实体实时的碰撞检测，这就意味着在调整下落的方块移动速度时可能会遇到两个问题：
+    - 如果两个下落的方块速度不一致，会看到一个方块实体从另一个方块实体传过去，并没有碰撞效果。
+    - 下落的方块对实体造成伤害的计算并不是在刚接触到实体时，而是在落地时才检测范围有无实体，把移速调整的慢点更容易观察到此现象。
+## 示例配置
+可参考[CustomBlocksMod](../../../13-模组SDK编程/60-Demo示例.md#CustomBlocksMod)中的customblocks:customblocks_test_heavy.json。
+```json
+{
+    "format_version": "1.10.0",
+    "minecraft:block": {
+        "description": {
+            "identifier": "customblocks:customblocks_test_heavy",
+            "register_to_creative_menu": true,
+            "is_experimental": false,
+            "base_block": "custom_heavy_block",
+            "category": "custom"
+        },
+        "components": {
+            "netease:fall": {
+                "send_python_event":true,
+                "fall_acceleration":0.04,
+                "adjust_percentage":0.98,
+                "hurt_entity":true,
+                "min_height_remove_tick":100,
+                "force_break_tick":600,
+                "fall_damage_amount":2.0,
+                "max_fall_damage":40
+            }
+        }
+    }
+}
+```