PoBDS文档
Englishv1.0.0
POBDS / 14

节点 API:输入、输出与使用示例

按节点查阅连接契约、参数和真实使用场景,不需要猜一个节点应该怎么接。

先看节点契约,再连线

每个条目说明输入、输出和可验证的例子。执行线负责推进流程,数据线负责给参数提供值;颜色只是辅助,具体类型和单位才是依据。未连接的输入可在节点里填默认值,连接后字段禁用。

流程与调用

节点输入与配置输出 / 完成例子
入口 / Entry执行起点;声明名称、类型、默认值的入参。执行输出;声明的入参作为图内数据。入口 → Action;Target : Actor 从调用方传入。
Action进入执行线;一个或多个 Action 的参数。全部完成后 FINISHED;失败走 FAILED。靠近和开火放同一个节点持续 Update;装填放到后续节点。
State进入执行线;配置 Enter、Update、Exit 事件图。匹配事件或条件时离开,先执行 Exit。在巡逻 State 中持续更新,收到 Alert 时切换。
事件监听 / Event Listener事件名;可开启全局监听。收到匹配事件后走执行出口。监听 Alert → 警戒 State。
发送事件 / Event Sender进入执行线;事件名和发送范围。可配置继续执行或完成当前图。向当前图发送 Reloaded。
BDS 调用 / BDS call执行输入、BDS 配置引用。选择并执行 Ability;结束后交回父流程。入口 → Acquire;Acquire 的候选可直接调用 Combat 子 BDS。
子节点流 / Child Flow执行输入、子图引用、签名对应参数。完成后继续执行;返回参数可接线或存变量。Target 与 Speed 传给 Approach;Result 写入当前图变量。
并行 / Parallel进入执行线;配置多个子图引用。全部分支退出后继续。移动与射击各用一条子图。
图退出事件 / Graph Exit内嵌清理动作或直接连接一个动作节点。本图停止时自动触发。动作只执行 Enter 和 Exit。清除 Global/IsFiring 或释放占用资源。
函数返回 / Return执行输入及返回定义对应的结果值。结束当前调用,向调用方交付结果。Action FINISHED → Return;Result = 移动结果。

候选、评分与执行

节点输入与配置输出 / 完成例子
AbilityBool 门槛;基础分;零个或多个加分 Context。外层输出评分 Context;内部关联 Execution。攻击门槛距离 ≤ 2000;基础分 10。
Evaluation多个 Ability 的评分 Context。每个候选对应的执行分支。攻击 / 走近 / 跑近 → Evaluation → 各自 Execution。
Execution选择一个或多个节点流;第一条可绑定入参及结果。并行时等待所有子图结束;抢占时停止所有分支。在同一个节点流执行配置中添加 Orbit 和射击子图。
条件加分 / BonusBool 条件;Int 或相应数值分值。加分 Context,接到 Ability 的加分口。有掩体时 +20;普通 Int 变量接分值输入,非 Context 输出。

条件与逻辑

节点输入与配置输出 / 完成例子
比较 / Compare同类型左值、右值;选择该类型允许的运算符。Bool。DistanceMm ≤ 2000 → 攻击门槛。
存在 / ExistsActor 或支持存在判断的对象值。Bool。Target Actor → Exists → 候选门槛;不是数值大小比较。
AND / OR / NOT多个 Bool 条件,或单个 Bool 取反。Bool。距离 > 2000 AND 距离 ≤ 5000 → 走近。

数据来源与角色成员

节点输入与配置输出 / 完成例子
常量 / Constant在节点内直接填写具体类型值。所选类型值。整数 2000 接整数比较;不要与米单位 Position.X 混用。
变量读取 / Variable read作用域与变量定义。该变量的具体类型。角色全局 CurrentEnemy : Actor → 属性节点角色输入。
自身 / 目标角色当前 Agent 的角色或目标引用。Actor 引用,可以为空。目标角色 → Exists;或目标角色 → Position。
属性读取 / PropertyActor 角色输入;角色类型与属性成员选择。属性声明的类型;复合值可展开组件。Self → Health(Int);Target → Position(Vector3)。
方法查询 / Method query可暴露的查询方法及受支持参数。方法声明的结果类型。纯查询用于条件;会改变状态的方法放 Action 中调用。

基础数值与空间运算

节点输入与配置输出 / 完成例子
加减乘除 / Add, Subtract, Multiply, Divide同类标量 A、B,可接线或直接填值。相应 Int / Float。伤害 = 攻击力 - 护甲;整数除法注意截断,除数不要为 0。
最小 / 最大值 / Min, Max同类标量 A、B。相应 Int / Float。Min(当前血量 + 治疗, 最大血量)。
随机整数 / Random IntegerInt Min、Max;均可直接填写或接线。Int,包含上下限。1–1000 的随机值 ≤ 350 表示千分之 350;不要接旧概率 Bool 节点。
向量加减 / Vector Add, SubtractVector3 A、B。Vector3。Target.Position - Self.Position 得到位移。
距离 / DistanceVector3 A、B。Float,沿用输入坐标单位。两个 Position(米)→ Distance(米);整数毫米规则优先读整数距离。
长度 / Length;点积 / Dot一个向量;或两个 Vector3。Float。Length(位移);Dot(归一化方向, 前向) 判断朝向关系。
归一化 / Normalize;取 X/Y/ZVector3。Normalize 输出 Vector3;组件输出 Float。位移 → Normalize;Position 展开 XYZ 可省略独立取组件节点。

配置示例见图退出事件与清理和让多个子图并行运行。

常用 Action 怎么选

操作配置要点结束语义
设置角色属性选 Actor 来源、可写属性和同类型值。一次修改完成后结束。
调用角色方法从方法列表选择,绑定各入参;不要猜字符串。依据 Action / 方法的约定完成,不把任意长行为当瞬时查询。
设置变量选当前图 / 角色全局、变量、同类型值。写入后结束。
等待选时间单位与时长;确定性规则使用整数逻辑时间。到期 Finish。
角色移动 / 攻击目标、范围、速度、伤害 / 间隔;持续行为按条件结束。未完成的持续 Action Update;被打断时 Exit。

方法参数与返回值接线

在 Action 中选择具体的角色方法后,节点按方法签名生成带类型的入参针脚;非 void 的受支持返回值生成结果输出。入口参数、变量读取、子节点流入参和返回值共用 FlowDataPort 契约。拖动变量卡片的名称可以创建读取节点并接到匹配的输入;重新接线替换旧连接,旧节点保留。断线后恢复检查器中的默认值。

支持多个关键词与 / 路径组合 · Enter 打开第一项 · Esc 关闭