# Node Reference

## Summary

Node reference pages are lookup pages for built-in Flow Core graph nodes. Use them after you know the general kind of node you need and want exact ports, parameters, runtime behavior, return semantics, and common mistakes.

This section is not a tutorial. If you are still learning how to build a first graph, start with [First 15 Minutes](/flow-core-docs/documentation/tutorials/first-15-minutes.md). If you are choosing between node families, start with [Flow Node Kinds](/flow-core-docs/documentation/reference/flow-node-kinds.md).

## Use When

* You need to confirm what a node input or output does.
* You are checking why a node returned Abort, Invalid, Success, or Failure.
* You want to know which parameters affect runtime behavior.
* You are reviewing a graph and need a quick behavior contract for a specific node.

## How to Read Node Pages

| Section          | What to look for                                                                 |
| ---------------- | -------------------------------------------------------------------------------- |
| Purpose          | The shortest description of the node's job.                                      |
| When to use      | The design situation where the node is a good fit.                               |
| Behavior         | What the node does when a chain enters it.                                       |
| Ports            | Flow inputs, outputs, control inputs, and lifecycle outputs.                     |
| Parameters       | Inspector fields that change runtime behavior.                                   |
| Return semantics | How the node reports completion, rejection, cancellation, or failure.            |
| Editor usage     | Authoring notes that affect graph readability or setup.                          |
| Common mistakes  | The fastest way to catch likely configuration errors.                            |
| Related          | Concept, runtime, debugging, or module pages that explain the surrounding model. |

## Where to Start

| Reader task                              | Start with                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| ---------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Start a chain from an event or Entry     | [Trigger Node](https://github.com/HaikunHuang/FlowCore/blob/main/reference/nodes/node-trigger.md), [Enter Node](https://github.com/HaikunHuang/FlowCore/blob/main/reference/nodes/node-enter.md)                                                                                                                                                                                                                                                                                                              |
| Run a list of visual actions             | [Action Node](https://github.com/HaikunHuang/FlowCore/blob/main/reference/nodes/node-action.md)                                                                                                                                                                                                                                                                                                                                                                                                               |
| Branch, gate, wait, retry, or route flow | [IfElse Node](https://github.com/HaikunHuang/FlowCore/blob/main/reference/nodes/node-if-else.md), [Gate Node](https://github.com/HaikunHuang/FlowCore/blob/main/reference/nodes/node-gate.md), [Wait Node](https://github.com/HaikunHuang/FlowCore/blob/main/reference/nodes/node-wait.md), [Retry Node](https://github.com/HaikunHuang/FlowCore/blob/main/reference/nodes/node-retry.md), [Switch Node](https://github.com/HaikunHuang/FlowCore/blob/main/reference/nodes/node-switch.md)                    |
| React to Unity UI or input               | [UI Button Trigger](https://github.com/HaikunHuang/FlowCore/blob/main/reference/nodes/node-ui-button-trigger.md), [InputNewTrigger Node](https://github.com/HaikunHuang/FlowCore/blob/main/reference/nodes/node-input-new-trigger.md), [InputOldTrigger Node](https://github.com/HaikunHuang/FlowCore/blob/main/reference/nodes/node-input-old-trigger.md)                                                                                                                                                    |
| Build BT decisions                       | [BtRoot](https://github.com/HaikunHuang/FlowCore/blob/main/reference/nodes/node-bt-root.md), [BtSelector](https://github.com/HaikunHuang/FlowCore/blob/main/reference/nodes/node-bt-selector.md), [BtSequence](https://github.com/HaikunHuang/FlowCore/blob/main/reference/nodes/node-bt-sequence.md), [BtAction](https://github.com/HaikunHuang/FlowCore/blob/main/reference/nodes/node-bt-action.md), [BtCondition](https://github.com/HaikunHuang/FlowCore/blob/main/reference/nodes/node-bt-condition.md) |
| Build stacked modes or modal flows       | [Stack Root](https://github.com/HaikunHuang/FlowCore/blob/main/reference/nodes/node-stack-root.md), [Stack Layer](https://github.com/HaikunHuang/FlowCore/blob/main/reference/nodes/node-stack-layer.md)                                                                                                                                                                                                                                                                                                      |
| Build GOAP planning                      | [GoapRoot](https://github.com/HaikunHuang/FlowCore/blob/main/reference/nodes/node-goap-root.md), [GoapGoal](https://github.com/HaikunHuang/FlowCore/blob/main/reference/nodes/node-goap-goal.md), [GoapAction](https://github.com/HaikunHuang/FlowCore/blob/main/reference/nodes/node-goap-action.md)                                                                                                                                                                                                         |

## Reference Rules

* Node pages describe stable public behavior, not internal implementation.
* A node page can tell you what a port returns; it does not replace graph debugging when runtime data is wrong.
* If a node uses Invoke Mode or Reject Result, read [Invoke and Reject Modes](/flow-core-docs/documentation/reference/invoke-and-reject-modes.md) alongside the node page.
* If a node depends on Blackboard data, verify scope, index, key, and type in the graph's runtime context.

## Pages

* [Abort Node](https://github.com/HaikunHuang/FlowCore/blob/main/reference/nodes/node-abort.md)
* [Action Node](https://github.com/HaikunHuang/FlowCore/blob/main/reference/nodes/node-action.md)
* [BtAction](https://github.com/HaikunHuang/FlowCore/blob/main/reference/nodes/node-bt-action.md)
* [BtCondition](https://github.com/HaikunHuang/FlowCore/blob/main/reference/nodes/node-bt-condition.md)
* [BtDecorator](https://github.com/HaikunHuang/FlowCore/blob/main/reference/nodes/node-bt-decorator.md)
* [BtLoop](https://github.com/HaikunHuang/FlowCore/blob/main/reference/nodes/node-bt-loop.md)
* [BtParallelPlus](https://github.com/HaikunHuang/FlowCore/blob/main/reference/nodes/node-bt-parallel-plus.md)
* [BtParallelWeighted](https://github.com/HaikunHuang/FlowCore/blob/main/reference/nodes/node-bt-parallel-weighted.md)
* [BtParallel](https://github.com/HaikunHuang/FlowCore/blob/main/reference/nodes/node-bt-parallel.md)
* [BtRoot](https://github.com/HaikunHuang/FlowCore/blob/main/reference/nodes/node-bt-root.md)
* [BtSelector](https://github.com/HaikunHuang/FlowCore/blob/main/reference/nodes/node-bt-selector.md)
* [BtSequence](https://github.com/HaikunHuang/FlowCore/blob/main/reference/nodes/node-bt-sequence.md)
* [BtService](https://github.com/HaikunHuang/FlowCore/blob/main/reference/nodes/node-bt-service.md)
* [BtSubGraph](https://github.com/HaikunHuang/FlowCore/blob/main/reference/nodes/node-bt-sub-graph.md)
* [Combiner Node](https://github.com/HaikunHuang/FlowCore/blob/main/reference/nodes/node-combiner.md)
* [Comment Node](https://github.com/HaikunHuang/FlowCore/blob/main/reference/nodes/node-comment.md)
* [Cooldown Node](https://github.com/HaikunHuang/FlowCore/blob/main/reference/nodes/node-cooldown.md)
* [Delay Node](https://github.com/HaikunHuang/FlowCore/blob/main/reference/nodes/node-delay.md)
* [Enter Node](https://github.com/HaikunHuang/FlowCore/blob/main/reference/nodes/node-enter.md)
* [Exit Node](https://github.com/HaikunHuang/FlowCore/blob/main/reference/nodes/node-exit.md)
* [Flags Node](https://github.com/HaikunHuang/FlowCore/blob/main/reference/nodes/node-flags.md)
* [FsmState Node](https://github.com/HaikunHuang/FlowCore/blob/main/reference/nodes/node-fsm-state.md)
* [Gate Node](https://github.com/HaikunHuang/FlowCore/blob/main/reference/nodes/node-gate.md)
* [Gather Node](https://github.com/HaikunHuang/FlowCore/blob/main/reference/nodes/node-gather.md)
* [GoapAction](https://github.com/HaikunHuang/FlowCore/blob/main/reference/nodes/node-goap-action.md)
* [GoapGoal](https://github.com/HaikunHuang/FlowCore/blob/main/reference/nodes/node-goap-goal.md)
* [GoapRoot](https://github.com/HaikunHuang/FlowCore/blob/main/reference/nodes/node-goap-root.md)
* [IfElse Node](https://github.com/HaikunHuang/FlowCore/blob/main/reference/nodes/node-if-else.md)
* [InputNewTrigger Node](https://github.com/HaikunHuang/FlowCore/blob/main/reference/nodes/node-input-new-trigger.md)
* [InputOldTrigger Node](https://github.com/HaikunHuang/FlowCore/blob/main/reference/nodes/node-input-old-trigger.md)
* [Loop Node](https://github.com/HaikunHuang/FlowCore/blob/main/reference/nodes/node-loop.md)
* [OnBlackboardValueChangedTrigger Node](https://github.com/HaikunHuang/FlowCore/blob/main/reference/nodes/node-on-blackboard-value-changed-trigger.md)
* [Once Node](https://github.com/HaikunHuang/FlowCore/blob/main/reference/nodes/node-once.md)
* [Relay Node](https://github.com/HaikunHuang/FlowCore/blob/main/reference/nodes/node-relay.md)
* [RemoteIn Node](https://github.com/HaikunHuang/FlowCore/blob/main/reference/nodes/node-remote-in.md)
* [RemoteOut Node](https://github.com/HaikunHuang/FlowCore/blob/main/reference/nodes/node-remote-out.md)
* [Repeat Node](https://github.com/HaikunHuang/FlowCore/blob/main/reference/nodes/node-repeat.md)
* [Retry Node](https://github.com/HaikunHuang/FlowCore/blob/main/reference/nodes/node-retry.md)
* [Spinner Node](https://github.com/HaikunHuang/FlowCore/blob/main/reference/nodes/node-spinner.md)
* [Stack Layer](https://github.com/HaikunHuang/FlowCore/blob/main/reference/nodes/node-stack-layer.md)
* [Stack Root](https://github.com/HaikunHuang/FlowCore/blob/main/reference/nodes/node-stack-root.md)
* [SubFlowGraph Node](https://github.com/HaikunHuang/FlowCore/blob/main/reference/nodes/node-sub-flow-graph.md)
* [Switch Node](https://github.com/HaikunHuang/FlowCore/blob/main/reference/nodes/node-switch.md)
* [Timeout Node](https://github.com/HaikunHuang/FlowCore/blob/main/reference/nodes/node-timeout.md)
* [Timer Cooldown Node](https://github.com/HaikunHuang/FlowCore/blob/main/reference/nodes/node-timer-cooldown.md)
* [Timer Countdown Node](https://github.com/HaikunHuang/FlowCore/blob/main/reference/nodes/node-timer-countdown.md)
* [Timer Delay Node](https://github.com/HaikunHuang/FlowCore/blob/main/reference/nodes/node-timer-delay.md)
* [Timer Interval Node](https://github.com/HaikunHuang/FlowCore/blob/main/reference/nodes/node-timer-interval.md)
* [Timer Stopwatch Node](https://github.com/HaikunHuang/FlowCore/blob/main/reference/nodes/node-timer-stopwatch.md)
* [Timer Time Window Node](https://github.com/HaikunHuang/FlowCore/blob/main/reference/nodes/node-timer-time-window.md)
* [Trigger Node](https://github.com/HaikunHuang/FlowCore/blob/main/reference/nodes/node-trigger.md)
* [TryCatchFinal Node](https://github.com/HaikunHuang/FlowCore/blob/main/reference/nodes/node-try-catch-final.md)
* [UI Begin Drag Trigger](https://github.com/HaikunHuang/FlowCore/blob/main/reference/nodes/node-ui-begin-drag-trigger.md)
* [UI Button Trigger](https://github.com/HaikunHuang/FlowCore/blob/main/reference/nodes/node-ui-button-trigger.md)
* [UI Cancel Trigger](https://github.com/HaikunHuang/FlowCore/blob/main/reference/nodes/node-ui-cancel-trigger.md)
* [UI Deselect Trigger](https://github.com/HaikunHuang/FlowCore/blob/main/reference/nodes/node-ui-deselect-trigger.md)
* [UI Drag Trigger](https://github.com/HaikunHuang/FlowCore/blob/main/reference/nodes/node-ui-drag-trigger.md)
* [UI Drop Trigger](https://github.com/HaikunHuang/FlowCore/blob/main/reference/nodes/node-ui-drop-trigger.md)
* [UI Dropdown Trigger](https://github.com/HaikunHuang/FlowCore/blob/main/reference/nodes/node-ui-dropdown-trigger.md)
* [UI End Drag Trigger](https://github.com/HaikunHuang/FlowCore/blob/main/reference/nodes/node-ui-end-drag-trigger.md)
* [UI Initialize Potential Drag Trigger](https://github.com/HaikunHuang/FlowCore/blob/main/reference/nodes/node-ui-initialize-potential-drag-trigger.md)
* [UI InputField Changed Trigger](https://github.com/HaikunHuang/FlowCore/blob/main/reference/nodes/node-ui-input-field-changed-trigger.md)
* [UI InputField Deselect Trigger](https://github.com/HaikunHuang/FlowCore/blob/main/reference/nodes/node-ui-input-field-deselect-trigger.md)
* [UI InputField Select Trigger](https://github.com/HaikunHuang/FlowCore/blob/main/reference/nodes/node-ui-input-field-select-trigger.md)
* [UI InputField Submit Trigger](https://github.com/HaikunHuang/FlowCore/blob/main/reference/nodes/node-ui-input-field-submit-trigger.md)
* [UI Move Trigger](https://github.com/HaikunHuang/FlowCore/blob/main/reference/nodes/node-ui-move-trigger.md)
* [UI Pointer Click Trigger](https://github.com/HaikunHuang/FlowCore/blob/main/reference/nodes/node-ui-pointer-click-trigger.md)
* [UI Pointer Down Trigger](https://github.com/HaikunHuang/FlowCore/blob/main/reference/nodes/node-ui-pointer-down-trigger.md)
* [UI Pointer Enter Trigger](https://github.com/HaikunHuang/FlowCore/blob/main/reference/nodes/node-ui-pointer-enter-trigger.md)
* [UI Pointer Exit Trigger](https://github.com/HaikunHuang/FlowCore/blob/main/reference/nodes/node-ui-pointer-exit-trigger.md)
* [UI Pointer Move Trigger](https://github.com/HaikunHuang/FlowCore/blob/main/reference/nodes/node-ui-pointer-move-trigger.md)
* [UI Pointer Up Trigger](https://github.com/HaikunHuang/FlowCore/blob/main/reference/nodes/node-ui-pointer-up-trigger.md)
* [UI ScrollRect Trigger](https://github.com/HaikunHuang/FlowCore/blob/main/reference/nodes/node-ui-scroll-rect-trigger.md)
* [UI Scroll Trigger](https://github.com/HaikunHuang/FlowCore/blob/main/reference/nodes/node-ui-scroll-trigger.md)
* [UI Scrollbar Trigger](https://github.com/HaikunHuang/FlowCore/blob/main/reference/nodes/node-ui-scrollbar-trigger.md)
* [UI Select Trigger](https://github.com/HaikunHuang/FlowCore/blob/main/reference/nodes/node-ui-select-trigger.md)
* [UI Slider Trigger](https://github.com/HaikunHuang/FlowCore/blob/main/reference/nodes/node-ui-slider-trigger.md)
* [UI Submit Trigger](https://github.com/HaikunHuang/FlowCore/blob/main/reference/nodes/node-ui-submit-trigger.md)
* [TMP Dropdown Trigger](https://github.com/HaikunHuang/FlowCore/blob/main/reference/nodes/node-ui-tmp-dropdown-trigger.md)
* [TMP InputField Changed Trigger](https://github.com/HaikunHuang/FlowCore/blob/main/reference/nodes/node-ui-tmp-input-field-changed-trigger.md)
* [TMP InputField Deselect Trigger](https://github.com/HaikunHuang/FlowCore/blob/main/reference/nodes/node-ui-tmp-input-field-deselect-trigger.md)
* [TMP InputField Select Trigger](https://github.com/HaikunHuang/FlowCore/blob/main/reference/nodes/node-ui-tmp-input-field-select-trigger.md)
* [TMP InputField Submit Trigger](https://github.com/HaikunHuang/FlowCore/blob/main/reference/nodes/node-ui-tmp-input-field-submit-trigger.md)
* [UI Toggle Trigger](https://github.com/HaikunHuang/FlowCore/blob/main/reference/nodes/node-ui-toggle-trigger.md)
* [UI Update Selected Trigger](https://github.com/HaikunHuang/FlowCore/blob/main/reference/nodes/node-ui-update-selected-trigger.md)
* [Wait Node](https://github.com/HaikunHuang/FlowCore/blob/main/reference/nodes/node-wait.md)
* [Weighted Random Node](https://github.com/HaikunHuang/FlowCore/blob/main/reference/nodes/node-weighted-random.md)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://flow-core.gitbook.io/flow-core-docs/documentation/reference/nodes.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.