7月31日同步更新

mcguide/20-玩法开发/14-预设玩法编程/13-PresetAPI/预设对象/零件/世界属性零件WorldPart.md

@@ -0,0 +1,23 @@
+---
+sidebarDepth: 1
+---
+# 世界属性零件WorldPart
+
+
+
+## 概述
+
+- 描述
+
+    世界属性零件
+
+- 成员变量
+
+    | 变量名 | <div style="width: 4em">数据类型</div> | 说明 |
+    | :--- | :--- | :--- |
+    | gameMode | int | 游戏模式 |
+    | difficulty | int | 游戏难度 |
+    | cheat | bool | 作弊模式 |
+
+
+

mcguide/20-玩法开发/14-预设玩法编程/13-PresetAPI/预设对象/零件/传送门零件PortalPart.md

@@ -0,0 +1,24 @@
+---
+sidebarDepth: 1
+---
+# 传送门零件PortalPart
+
+
+
+## 概述
+
+- 描述
+
+    传送门零件
+
+- 成员变量
+
+    | 变量名 | <div style="width: 4em">数据类型</div> | 说明 |
+    | :--- | :--- | :--- |
+    | portalGateType | int | 传送门类型，0表示单向，1表示双向 |
+    | portalGateShape | int | 传送门形状，当前只能是立式方框0 |
+    | portalGateWidth | int | 传送门宽度 |
+    | portalGateHeight | int | 传送门高度 |
+
+
+

mcguide/20-玩法开发/14-预设玩法编程/13-PresetAPI/预设对象/零件/实体零件EntityBasePart.md

@@ -0,0 +1,75 @@
+---
+sidebarDepth: 1
+---
+# 实体零件EntityBasePart
+
+
+
+## 概述
+
+- 描述
+
+    实体零件
+
+- 成员变量
+
+    | 变量名 | <div style="width: 4em">数据类型</div> | 说明 |
+    | :--- | :--- | :--- |
+    | engineType | str | 实体类型 |
+    | autoCreate | bool | 是否在零件初始化时，自动创建关联实体，默认为True |
+    | persistence | bool | 创建的实体是否持久化，默认为False，设为True时，创建完实体会将autoCreate重置为False |
+
+
+
+## 索引
+
+| 接口 | <div style="width: 3em"></div> | 描述 |
+| --- | --- | --- |
+| [CreateVirtualEntity](#createvirtualentity) | <span style="display:inline;color:#ff5555">服务端</span> | 手动创建关联实体，如果已创建会直接返回 |
+| [DestroyVirtualEntity](#destroyvirtualentity) | <span style="display:inline;color:#ff5555">服务端</span> | 移除已创建的关联实体，引擎退出时会默认调用 |
+
+
+
+
+## CreateVirtualEntity
+
+<span style="display:inline;color:#ff5555">服务端</span>
+
+method in Preset.Parts.EntityBasePart.EntityBasePart
+
+- 描述
+
+    手动创建关联实体，如果已创建会直接返回
+
+- 参数
+
+    无
+
+- 返回值
+
+    | <div style="width: 4em">数据类型</div> | 说明 |
+    | :--- | :--- |
+    | str | 返回创建的实体ID |
+
+
+
+## DestroyVirtualEntity
+
+<span style="display:inline;color:#ff5555">服务端</span>
+
+method in Preset.Parts.EntityBasePart.EntityBasePart
+
+- 描述
+
+    移除已创建的关联实体，引擎退出时会默认调用
+
+- 参数
+
+    无
+
+- 返回值
+
+    无
+
+
+

mcguide/20-玩法开发/14-预设玩法编程/13-PresetAPI/预设对象/零件/导航路径零件NavPointsPart.md

@@ -0,0 +1,75 @@
+---
+sidebarDepth: 1
+---
+# 导航路径零件NavPointsPart
+
+
+
+## 概述
+
+- 描述
+
+    导航路径零件, 在编辑器内可以选定一系列相对于该零件的坐标点，当零件运行时可以获得这些坐标点的世界坐标列表
+
+- 成员变量
+
+    | 变量名 | <div style="width: 4em">数据类型</div> | 说明 |
+    | :--- | :--- | :--- |
+    | patrolsPath | list(tuple(float,float,float)) | 路径点列表 |
+
+
+
+## 索引
+
+| 接口 | <div style="width: 3em"></div> | 描述 |
+| --- | --- | --- |
+| [GetNavigationPoints](#getnavigationpoints) | <span style="display:inline;color:#7575f9">客户端</span>/<span style="display:inline;color:#ff5555">服务端</span> | 获得路径点的世界坐标列表 |
+| [GetNavigationRadius](#getnavigationradius) | <span style="display:inline;color:#7575f9">客户端</span>/<span style="display:inline;color:#ff5555">服务端</span> | 获得路径点的随机半径列表 |
+
+
+
+
+## GetNavigationPoints
+
+<span style="display:inline;color:#7575f9">客户端</span>/<span style="display:inline;color:#ff5555">服务端</span>
+
+method in Preset.Parts.NavPointsPart.NavPointsPart
+
+- 描述
+
+    获得路径点的世界坐标列表
+
+- 参数
+
+    无
+
+- 返回值
+
+    | <div style="width: 4em">数据类型</div> | 说明 |
+    | :--- | :--- |
+    | list(tuple(float,float,float)) | 路径点的世界坐标列表 |
+
+
+
+## GetNavigationRadius
+
+<span style="display:inline;color:#7575f9">客户端</span>/<span style="display:inline;color:#ff5555">服务端</span>
+
+method in Preset.Parts.NavPointsPart.NavPointsPart
+
+- 描述
+
+    获得路径点的随机半径列表
+
+- 参数
+
+    无
+
+- 返回值
+
+    | <div style="width: 4em">数据类型</div> | 说明 |
+    | :--- | :--- |
+    | list(float) | 路径点的随机半径列表 |
+
+
+

mcguide/20-玩法开发/14-预设玩法编程/13-PresetAPI/预设对象/零件/玩家基础属性零件PlayerBasicPart.md

@@ -0,0 +1,26 @@
+---
+sidebarDepth: 1
+---
+# 玩家基础属性零件PlayerBasicPart
+
+
+
+## 概述
+
+- 描述
+
+    玩家基础属性零件
+
+- 成员变量
+
+    | 变量名 | <div style="width: 4em">数据类型</div> | 说明 |
+    | :--- | :--- | :--- |
+    | attackDamage | float | 攻击力 |
+    | healthMax | float | 生命上限 |
+    | disableHunger | bool | 是否锁定饥饿值 |
+    | spawnPos | tuple(float,float,float) | 玩家复活点 |
+    | nameDeeptest | bool | 名字是否透视 |
+    | showName | bool | 是否在头顶显示名字 |
+
+
+

mcguide/20-玩法开发/14-预设玩法编程/13-PresetAPI/预设对象/零件/相机轨迹CameraTrackPart.md

@@ -0,0 +1,113 @@
+---
+sidebarDepth: 1
+---
+# 相机轨迹CameraTrackPart
+
+
+
+## 概述
+
+- 描述
+
+    相机轨迹零件
+
+- 成员变量
+
+    | 变量名 | <div style="width: 4em">数据类型</div> | 说明 |
+    | :--- | :--- | :--- |
+    | track | list(dict) | 路径点列表 |
+
+
+
+## 索引
+
+| 接口 | <div style="width: 3em"></div> | 描述 |
+| --- | --- | --- |
+| [PlayFromStart](#playfromstart) | <span style="display:inline;color:#7575f9">客户端</span> | 从头开始播放相机运动轨迹 |
+| [Pause](#pause) | <span style="display:inline;color:#7575f9">客户端</span> | 暂停播放相机轨迹 |
+| [Continue](#continue) | <span style="display:inline;color:#7575f9">客户端</span> | 继续播放相机轨迹 |
+| [Stop](#stop) | <span style="display:inline;color:#7575f9">客户端</span> | 停止播放相机轨迹 |
+
+
+
+
+## PlayFromStart
+
+<span style="display:inline;color:#7575f9">客户端</span>
+
+method in Preset.Parts.CameraTrackPart.CameraTrackPart
+
+- 描述
+
+    从头开始播放相机运动轨迹
+
+- 参数
+
+    无
+
+- 返回值
+
+    无
+
+
+
+## Pause
+
+<span style="display:inline;color:#7575f9">客户端</span>
+
+method in Preset.Parts.CameraTrackPart.CameraTrackPart
+
+- 描述
+
+    暂停播放相机轨迹
+
+- 参数
+
+    无
+
+- 返回值
+
+    无
+
+
+
+## Continue
+
+<span style="display:inline;color:#7575f9">客户端</span>
+
+method in Preset.Parts.CameraTrackPart.CameraTrackPart
+
+- 描述
+
+    继续播放相机轨迹
+
+- 参数
+
+    无
+
+- 返回值
+
+    无
+
+
+
+## Stop
+
+<span style="display:inline;color:#7575f9">客户端</span>
+
+method in Preset.Parts.CameraTrackPart.CameraTrackPart
+
+- 描述
+
+    停止播放相机轨迹
+
+- 参数
+
+    无
+
+- 返回值
+
+    无
+
+
+

mcguide/20-玩法开发/14-预设玩法编程/13-PresetAPI/预设对象/零件/触发器零件TriggerPart.md

@@ -0,0 +1,53 @@
+---
+sidebarDepth: 1
+---
+# 触发器零件TriggerPart
+
+
+
+## 概述
+
+- 描述
+
+    触发器零件，当实体进入时触发OnTriggerEntityEnter，当实体退出时触发OnTriggerEntityExit，当实体停留时触发OnTriggerEntityStay
+
+- 成员变量
+
+    | 变量名 | <div style="width: 4em">数据类型</div> | 说明 |
+    | :--- | :--- | :--- |
+    | isTriggerEnter | bool | 是否监听实体进入，默认为True |
+    | isTriggerExit | bool | 是否监听实体退出，默认为True |
+    | isTriggerStay | bool | 是否监听实体进入，默认为False |
+    | support | int | 支持客户端(1)/服务端(2)/双端(3)，默认为双端(3) |
+
+
+
+## 索引
+
+| 接口 | <div style="width: 3em"></div> | 描述 |
+| --- | --- | --- |
+| [GetEntitiesInTrigger](#getentitiesintrigger) | <span style="display:inline;color:#7575f9">客户端</span>/<span style="display:inline;color:#ff5555">服务端</span> | 获取当前在触发器区域的实体列表 |
+
+
+
+
+## GetEntitiesInTrigger
+
+<span style="display:inline;color:#7575f9">客户端</span>/<span style="display:inline;color:#ff5555">服务端</span>
+
+method in Preset.Parts.TriggerPart.TriggerPart
+
+- 描述
+
+    获取当前在触发器区域的实体列表
+
+- 参数
+
+    无
+
+- 返回值
+
+    无
+
+
+

mcguide/20-玩法开发/14-预设玩法编程/13-PresetAPI/预设对象/零件/零件事件PartEvent.md

@@ -0,0 +1,112 @@
+---
+sidebarDepth: 1
+---
+# 零件事件PartEvent
+
+## 索引
+
+| 接口 | <div style="width: 3em"></div> | 描述 |
+| --- | --- | --- |
+| [OnTriggerEntityEnter](#ontriggerentityenter) | <span style="display:inline;color:#7575f9">客户端</span>/<span style="display:inline;color:#ff5555">服务端</span> | 触发器范围有实体进入时触发，只适用于TriggerPart |
+| [OnTriggerEntityExit](#ontriggerentityexit) | <span style="display:inline;color:#7575f9">客户端</span>/<span style="display:inline;color:#ff5555">服务端</span> | 触发器范围有实体离开时触发，只适用于TriggerPart |
+| [OnTriggerEntityStay](#ontriggerentitystay) | <span style="display:inline;color:#7575f9">客户端</span>/<span style="display:inline;color:#ff5555">服务端</span> | 触发器范围有实体停留时触发，只适用于TriggerPart |
+
+
+
+
+## OnTriggerEntityEnter
+
+<span style="display:inline;color:#7575f9">客户端</span>/<span style="display:inline;color:#ff5555">服务端</span>
+
+method in Preset.Parts.PartEvent
+
+- 描述
+
+    触发器范围有实体进入时触发，只适用于TriggerPart
+
+- 参数
+
+    | 参数名 | <div style="width: 4em">数据类型</div> | 说明 |
+    | :--- | :--- | :--- |
+    | TriggerPart | PartBase | 发射事件的触发器零件 |
+    | EnterEntityIds | list(str) | 进入触发器范围的实体ID列表 |
+
+- 返回值
+
+    无
+
+- 示例
+
+```python
+part = self.GetParent().GetPartByType("TriggerPart")
+if not part:
+    return
+self.ListenPartClientEvent(part.id, "OnTriggerEntityEnter", self, self.OnTriggerEntityEnter)
+```
+
+
+
+## OnTriggerEntityExit
+
+<span style="display:inline;color:#7575f9">客户端</span>/<span style="display:inline;color:#ff5555">服务端</span>
+
+method in Preset.Parts.PartEvent
+
+- 描述
+
+    触发器范围有实体离开时触发，只适用于TriggerPart
+
+- 参数
+
+    | 参数名 | <div style="width: 4em">数据类型</div> | 说明 |
+    | :--- | :--- | :--- |
+    | TriggerPart | PartBase | 发射事件的触发器零件 |
+    | ExitEntityIds | list(str) | 离开触发器范围的实体ID列表 |
+
+- 返回值
+
+    无
+
+- 示例
+
+```python
+part = self.GetParent().GetPartByType("TriggerPart")
+if not part:
+    return
+self.ListenPartClientEvent(part.id, "OnTriggerEntityExit", self, self.OnTriggerEntityExit)
+```
+
+
+
+## OnTriggerEntityStay
+
+<span style="display:inline;color:#7575f9">客户端</span>/<span style="display:inline;color:#ff5555">服务端</span>
+
+method in Preset.Parts.PartEvent
+
+- 描述
+
+    触发器范围有实体停留时触发，只适用于TriggerPart
+
+- 参数
+
+    | 参数名 | <div style="width: 4em">数据类型</div> | 说明 |
+    | :--- | :--- | :--- |
+    | TriggerPart | PartBase | 发射事件的触发器零件 |
+    | StayEntityIds | list(str) | 停留在触发器范围的实体ID列表 |
+
+- 返回值
+
+    无
+
+- 示例
+
+```python
+part = self.GetParent().GetPartByType("TriggerPart")
+if not part:
+    return
+self.ListenPartClientEvent(part.id, "OnTriggerEntityStay", self, self.OnTriggerEntityStay)
+```
+
+
+