2.6

docs/mconline/60-我的世界创造营教程/玩法组件进阶教程/2-逻辑编辑器基础/2-逻辑编辑器的基础概念（1）.md

@@ -0,0 +1,156 @@
+---
+front:
+hard: 高级
+time: 20分钟
+---
+# 逻辑编辑器的基础概念（1）
+
+从本节开始，将会系统地介绍逻辑编辑器的使用方法。
+
+这一节主要会介绍的内容如下：
+
+- 服务端和客户端的接口调用
+- 认识数据类型
+- 学会节点与节点之间的连接
+
+<iframe src="https://cc.163.com/act/m/daily/iframeplayer/?id=6328659bc6dfd1bb76f1d124" width="800" height="600" allow="fullscreen"/>
+
+## 服务器和客户端的接口调用
+
+在开始了解服务器和客户端的接口之前，我们首先需要明确客户端和服务器的概念。
+
+在我的世界游戏中，游戏的运算部分主要分为服务器和客户端两个部分，它们各自拥有各自的职责，负责游戏的不同部分的运算，并且两者之间可以互相通信，来同步一些信息。下面列出了一部分服务器、客户端负责的部分
+
+### 服务端
+
+- 伤害
+
+- 血量
+
+- 位置
+
+- 方块
+
+
+### 客户端
+
+- UI
+- 特效
+- 3D渲染
+
+不难看出，服务端主要负责处理所有实体，玩家的数据。而客户端主要负责处理本地玩家，实体以及视觉上的数据。
+
+因而，我们在逻辑编辑器的逻辑编辑时，所调用的接口，是因服务器和客户端的职责不同，而分开的。例如我们要做一个时装模组，我们服务端所需要处理的数据是每个玩家装备了什么时装，并将所有数据发送到客户端进行时装的渲染。
+
+接下来我们进入逻辑编辑器来实际操作。
+
+首先新建一个空白附加包，创建一个玩家预设，并创建蓝图零件，将其挂载在玩家预设中，操作步骤可以回顾[上一节](./0-制作第一个蓝图零件.html)。然后打开到逻辑编辑器。
+
+我们创建一个`设置是否下雨`的节点
+
+![](./images/14.png)
+
+可以看到，在创建节点的搜索框中，开头的部分是`服务端接口`，代表这个接口只有在服务端的相关逻辑中能被调用。相对应的，如果前面显示是`客户端接口`，则只能在客户端的逻辑中被调用。
+
+## 数据类型
+
+![](./images/15.png)
+
+逻辑编辑器中涉及到一些数据的传递，就像上方图片中的节点所示。这些数据都有规定的类型，见下表。
+
+|   数据类型    | 说明                                                         |
+| :-----------: | :----------------------------------------------------------- |
+| 布尔值(bool)  | 布尔值只有“真”“假”两种取值情况，关系判断、逻辑运算后产生的值都是布尔值。 |
+|   整数(int)   | 如-2、0、100等都是整数。                                     |
+| 浮点数(float) | 非整数均用浮点数来表示（这是通俗的理解方式），大部分时候开发者无需关心游戏中的数字是整数还是浮点数。 |
+|  字符串(str)  | 游戏中玩家在聊天频道的发言、文字提示等都是字符串。           |
+|  字典(dict)   | 一一对应的数据的映射，例如玩家和它们的所在坐标，就是可以用字典来表示，一个玩家对应一个坐标。 |
+|  列表(list)   | 一个或多个数据的集合，可重复，例如玩家的xyz坐标就可以使用列表来表示。 |
+| 对象(object)  | 所有类型的数据都是一个对象。                                 |
+
+## 节点之间的连接
+
+节点之间有两种连线方式，分别是**执行连线**（橙色）和**数据连线**（蓝色）。
+
+**执行连线**必须从一个节点的Out端口连到下一个节点的In端口。代表了节点之间的执行顺序，从第一个节点开始，向连线的方向依次执行。
+
+**数据连线**只代表数据的传递路径，不代表节点的执行顺序。连线的两端需要保证数据类型匹配，如果不匹配，需要在中间加上必要的类型转换。
+
+![](./images/08.png)
+
+> **注：**
+> 1. 不是所有的节点都需要执行连线。例如加法（+）节点，就只需要用数据连线传入两个值，然后右数据连线传出。它的加法逻辑在哪里被调用，就会在哪里被执行。
+> ![](./images/A.png)
+>
+>2. 不是每一个Out端口都需要有执行连线相连。例如条件节点会判断输入的布尔值为真还是假，如果是真，则执行“真”这个Out端口的逻辑；如果是假，则执行“假”这个Out端口的逻辑。若你只希望当布尔值为真的时候执行逻辑，但为假的时候不进行任何操作，你就可以将“假”这个Out端口留空，不需要连任何连线。
+> ![](./images/B.png)
+
+# 课后作业
+
+尝试在服务端初始化事件中，设置世界规则的玩家立即重生规则为真。
+
+## 操作步骤
+
+首先，我们希望实现的效果是：在服务端初始化之后设置世界规则（GameRules）。
+
+那么我们的节点连线，就应该从服务端初始化这里开始连接，并且只能调用服务器相关的接口。
+
+![](./images/16.png)
+
+我们在服务端初始化节点后连出一个执行连线，在搜索框中搜索`规则`，选择`SetGameRulesInfoServer(设置游戏规则)`，可以注意到，这个接口注明了是服务端接口。
+
+接下来我们去文档中查找这个节点中的详细参数解释。
+
+文档的地址: [点我](https://mc.163.com/dev/apidocs.html)
+
+![](./images/17.png)
+
+在文档中搜索这个接口相关的英文或者中文，找到对应的说明。
+
+> 1. 如果你还不清楚自己想要的效果应该用哪个节点来实现，你可以先在文档搜索框中输入关键词，浏览相关节点。找到之后，可以复制该接口名，比如这里的`SetGameRulesInfoServer`，然后粘贴到逻辑编辑器的节点输入框中。
+>
+>2. 在逻辑编辑器的节点列表中，【内置游戏节点】这一分类下有非常庞杂的节点供你选择。如果你创建了一个内置游戏节点，但不清楚它的具体用法，可以将鼠标悬浮在这个节点名称上，稍等片刻就会弹出一个tip，里面有节点对应的文档链接，直接点击链接就可以跳转到该节点的在线文档。
+>![](./images/C.png)
+
+
+![](./images/18.png)
+
+在文档中可以看到示例，也可以看到备注。
+
+> 其中游戏规则字典中每一项都为可选参数,但是设置option_info或者cheat_info其中一项子项后，必须加上option_info或者cheat_info。
+
+从示例中我们了解到如下信息：如果我们需要设置立即重生为真，首先需要构造一个**字典**，然后设置字典中的**值**，并将这个字典**传递给接口**。
+
+查询到如何编写之后，我们就可以在逻辑编辑器中右键新建节点，构造一个字典。不难看出，游戏规则字典是一个两个字典嵌套而成的字典。所以我们先在搜索框中搜索`构造字典`，然后填写对应参数。
+
+![](./images/19.png)
+
+根据我们所学的数据类型的指示，字典的key应该为str类型，值应该为bool类型。我们在字典中key1处选择str，填写`immediate_respawn`，value1选择为bool，并勾选为true。
+
+如果我们需要设置多个规则，就可以在右侧属性窗口中，修改这个字典的长度，让他产生多个一一对应的key和value。
+
+接下来再构造一个字典，key1选择为str，填写`option_info`，并将上一个字典的Dict输出，拖动到新字典的value1处进行连接。
+
+![](./images/20.png)
+
+这样我们就得到了一个字典，它的内容是
+
+```json
+{
+    "option_info": {
+      "immediate_respawn": True
+    }
+}
+```
+
+这样我们就完成了游戏规则字典的构造，找到`设置游戏规则`这个节点，还有需要一个参数，是存档ID。存档ID可以通过下面的接口获取。
+
+![](./images/21.png)
+
+可以看到，这是双端接口，代表是服务端和客户端双端都可以使用的。
+
+这样我们就得到了所有需要的参数，就可以按照下图方式进行连接。
+
+![](./images/22.png)
+
+随后我们就可以点击“保存”后再点击“运行”，进入游戏测试，看看是否会立即重生。