PoBDSDocs
简体中文v1.0.0
POBDS / 14

Node API: inputs, outputs and examples

Find each node’s connection contract, parameters and practical examples.

Read the contract before connecting

Each entry lists inputs, outputs and a concrete example. Execution wires advance control; data wires supply values. Check concrete types and units rather than relying on color. Inline inputs become read-only while connected.

Flow and calls

NodeInputs and configurationOutputs / completionExample
入口 / EntryExecution start and typed input declarations.Execution output and input values inside the graph.Entry → Action; Target : Actor comes from the caller.
ActionExecution input and parameters for one or more Actions.FINISHED when all complete; FAILED on failure.Approach and fire concurrently; put reload on a subsequent node.
StateExecution input and Enter, Update and Exit event graphs.Exit runs before transitioning on a matching event or condition.Update patrol while the state is active and transition on Alert.
事件监听 / Event ListenerEvent name and optional global subscription.Execution output when a matching event is processed.Listen for Alert and transition to the alert State.
发送事件 / Event SenderExecution input, event name and delivery scope.Configure a continuation or complete the current graph.Send Reloaded to the current graph.
BDS 调用 / BDS callExecution input and a BDS asset reference.Delegate to the selected Ability and return when complete.Entry → Acquire; an Execution may directly call Combat BDS.
子节点流 / Child FlowExecution input, child reference and signature arguments.Continuation plus returned values or result storage.Pass Target / Speed to Approach; store Result locally.
并行 / ParallelExecution input and multiple child graph references.Continues after all branches exit.Run movement and shooting as separate child flows.
图退出事件 / Graph ExitInline cleanup Actions or a direct connection to one Action node.Fires when the current graph stops. Actions run Enter and Exit only.Reset Global/IsFiring or release a reserved resource.
函数返回 / ReturnExecution input and typed result fields.End this call and deliver results to its caller.Action FINISHED → Return with a movement result.

Candidates, scores and execution

NodeInputs and configurationOutputs / completionExample
AbilityBoolean gate, base score and optional bonus Contexts.Scoring Context outside; associated Execution inside.Attack gate: distance ≤ 2000; base score 10.
EvaluationSeveral Ability scoring Contexts.Execution branch for each candidate.Attack / Walk / Run → Evaluation → their Executions.
ExecutionChoose one or more Flow Graphs. The first supports argument and result bindings.Waits for every parallel branch. Preemption stops all branches.Add Orbit and a shooting flow to the same Flow Graph execution.
条件加分 / BonusBoolean condition and a numeric score amount.Bonus Context for an Ability’s bonus input.Cover available adds 20; an Int variable feeds the amount, not the Context output.

Conditions and logic

NodeInputs and configurationOutputs / completionExample
比较 / CompareCompatible left/right values and an allowed operator.Bool.DistanceMm ≤ 2000 → Attack gate.
存在 / ExistsActor or another supported object value.Bool.Target Actor → Exists → gate; not a numeric ordering.
AND / OR / NOTBoolean operands; NOT negates one boolean.Bool.Distance > 2000 AND distance ≤ 5000 → Walk.

Value sources and Actor members

NodeInputs and configurationOutputs / completionExample
常量 / ConstantInline literal of the selected type.That concrete value type.Int 2000 → Int comparison; do not mix with meter-valued Position.X.
变量读取 / Variable readScope and a variable definition.The declared variable type.Actor-global CurrentEnemy : Actor → property Actor input.
自身 / 目标角色The Agent’s Self or Target reference.Actor reference, possibly empty.Target → Exists, or Target → Position.
属性读取 / PropertyActor input, Actor type and selected exposed property.Declared member type, optionally split into components.Self → Health(Int); Target → Position(Vector3).
方法查询 / Method queryExposed query method and supported arguments.Declared return type.Use pure queries for evaluation; invoke state-changing methods in Actions.

Arithmetic and spatial operations

NodeInputs and configurationOutputs / completionExample
加减乘除 / Add, Subtract, Multiply, DivideCompatible scalar A and B, wired or inline.Matching Int / Float.Damage = attack - armor; account for integer truncation and zero divisors.
最小 / 最大值 / Min, MaxCompatible scalar A and B.Matching Int / Float.Min(health + healing, max health).
随机整数 / Random IntegerInt Min / Max, either inline or connected.Int, inclusive bounds.Roll 1–1000 and compare ≤ 350 for 350 permille.
向量加减 / Vector Add, SubtractVector3 A and B.Vector3.Target.Position - Self.Position produces displacement.
距离 / DistanceVector3 A and B.Float in the input coordinate units.Two meter-valued Positions produce meter distance; use integer distance for mm rules.
长度 / Length;点积 / DotOne vector for Length; two Vector3 values for Dot.Float.Length(displacement); Dot(normalized direction, forward) for facing.
归一化 / Normalize;取 X/Y/ZVector3.Vector3 for Normalize; Float for X/Y/Z.Normalize displacement; split Position pins instead of separate component nodes when convenient.

See Graph Exit and cleanup and Run child flows in parallel for setup examples.

Choose an Action

OperationConfigurationCompletion
Set Actor propertyActor source, writable member and matching value.Finish after the write.
Invoke Actor methodSelect the method and bind parameters.Follow its Action contract; a long operation is not a pure instant query.
Set variableScope, variable and matching value.Finish after writing.
WaitDuration and units; use integer simulation time for authority.Finish when time elapses.
Move / attackTarget, range, speed, damage and interval.Persistent Update until complete; Exit on interruption.

Wire method arguments and results

Selecting an Actor method in an Action generates typed argument pins and a supported non-void result output. Entry parameters, variable reads, child-flow arguments and results share the FlowDataPort contract. Drag a variable card by its name to create a getter and connect it to a matching input. Reconnecting replaces the old incoming wire while keeping the old getter. Disconnecting restores the inspector fallback.

Combine keywords with / · Enter opens first result · Esc closes