版本：1.0.0

使用节点图生成蝴蝶

信息

本教程适用于 Party Game Kit 用户。

节点图（Node graphs）利用基于节点的工作流，帮助你轻松快速地创建出色的玩法功能。本教程将演示如何使用节点图，在玩家靠近灌木丛时生成一只飞出的蝴蝶。

前置条件

已安装 Visual Studio Code 并与 Studio 集成。如果尚未完成，请参照如何开始编程（How to start coding）进行下载和集成。

在资产库（Asset Library）中找到灌木模型和蝴蝶模型并添加到你的资产。在本例中，我们添加了 BushBig_A 作为灌木，Butterfly Monarch 作为蝴蝶。
通过选择 资产箱（Asset Box） > 模型（Models） 将两个模型放入场景。要调整模型的位置、旋转或缩放，可在 变换（Transform） 面板中设置，或直接拖动模型。

注意：蝴蝶模型可以放在场景的任意位置。实际生成的是该模型的副本，模型本身的位置不会影响生成点。

为了让蝴蝶能在灌木周围飞出，需要为蝴蝶添加 Behavior_SpawnableObjectMarker 组件。该组件使对象可被生成（spawnable）。

在资产库中找到 Behavior_SpawnableObjectMarker 组件并添加到你的资产。
选中蝴蝶，点击 更多（More） 图标，打开其 属性（Properties） 窗口。
通过 + 功能（Feature） > 资产（Assets） > Behavior_SpawnableObjectMarker，将组件添加到蝴蝶上。
给该组件命名。本例中命名为 bug。

为了触发生成事件，选中灌木，通过 + 触发器（Trigger） > 球体（Sphere） 添加触发盒。可调整球体触发器的中心和半径。

选中灌木，通过 + 功能（Feature） > 添加节点图（Add node graph） > + 新建节点图（New node graph） 附加一个新图文件。可命名为 Spawner。更多细节见添加节点图（adding a node graph）。

然后点击 Edit button 打开代码编辑器，开始添加节点。

首先，需要将灌木设置为触发器，触发条件为玩家进入触发盒。

点击 添加节点（Add Node） 或在 编辑器（Editor） 空白处右键，调出 添加节点 搜索框。输入 onTriggerEnter 并选择第一个搜索结果。注意，第二个搜索结果包含两个实体参数，此处不适用。

在 OnTriggerEnter 节点中，trigger 代表带有触发盒的对象，entity 代表进入触发盒的对象。
此节点会在场景中任意触发盒被进入时触发。为限定只在玩家靠近灌木时触发，需通过 添加节点 搜索 GetEntityId，筛选出 BushBig_A 作为实体。
同理，使用 GetEntityId 设置 self（当前对象）为另一个实体，并用 Integer Equal 节点将两者连接。
接下来，用 IsPlayerCharacter、Branch 和 And 节点设置进入触发盒的对象为玩家。
按下图方式连接所有已创建节点，完成触发器和触发条件的设置（白线为执行连接）：

为了让蝴蝶在灌木正上方生成，需要设置蝴蝶为生成对象，并指定生成位置。

选择 YaScene 下第一个带有 global position 变量的 Spawn 节点。输入 bug 作为 SpawnableObjectMarker 组件名。
蝴蝶的目标生成位置可通过获取灌木的位置并在 Y 轴上加一个值实现。找到 YaMovableComponent 下的 GetGlobalPosition，将结果连接到 Split Float3 节点。
在 节点管理（Node Management） 面板中创建变量。点击 变量（Variables） 区域的 添加（Add） 按钮，输入名称并选择数据类型，点击 完成（Done）。

点击刚创建的变量，打开 详情（Detail） 面板，设置默认值。

可将变量拖入图中，拖放时选择 获取（Get）。
为了将变量加到 Y 轴上并生成蝴蝶位置，并将新位置保存为 float3 值，先在 float3 下添加 新建（New） 节点和 Float Add 运算节点，然后连接这些节点：
将新 float3 的结果与 Spawn 节点的 globalPosition 相连，功能即设置完成：