Skip to content
Bit Quirky Behavior Trees and
State Machines

Search documentation

All topics and APIs

Close returns focus to Search.

What are you looking for?

Try a common topic or enter a complete API identifier.

Browse the reference instead

Esc closes · Tab reaches results · Enter opens the focused link

v0.11.0
Menu

BitQuirky.Behavior.Nodes

Public behavior trees and state machines: runtime symbols in BitQuirky.Behavior.Nodes.

Source snapshot 29003d8b1658.

Assembly: BitQuirky.Behavior.Runtime

Category: Node contracts

C#
class BitQuirky.Behavior.Nodes.BehaviorBranchLabelTokens

Source declaration: Packages/io.bitquirky.behavior/Runtime/Nodes/BehaviorNodeTokens.cs:142-158

Canonical edge-label tokens for Random Selector branches.

Responsibilities:

  • Centralize the stable lowercase branch weight and participation keys.

Does NOT:

  • Parse, format, or validate a branch label.

C#
public const string Aggregation = "aggregation"

Source declaration: Packages/io.bitquirky.behavior/Runtime/Nodes/BehaviorNodeTokens.cs:154

The Utility Selector branch aggregation label prefix.

C#
public const string Considerations = "considerations"

Source declaration: Packages/io.bitquirky.behavior/Runtime/Nodes/BehaviorNodeTokens.cs:151

The Utility Selector branch considerations label prefix.

C#
public const string Disabled = "disabled"

Source declaration: Packages/io.bitquirky.behavior/Runtime/Nodes/BehaviorNodeTokens.cs:148

The modifier marking a branch as switched off by the author.

C#
public const string ExecutionMode = "execution_mode"

Source declaration: Packages/io.bitquirky.behavior/Runtime/Nodes/BehaviorNodeTokens.cs:157

The Utility Selector branch execution-mode label prefix.

C#
public const string Weight = "weight"

Source declaration: Packages/io.bitquirky.behavior/Runtime/Nodes/BehaviorNodeTokens.cs:145

The branch weight label prefix.

Category: Node contracts

C#
class BitQuirky.Behavior.Nodes.BehaviorNodeKindTokens

Source declaration: Packages/io.bitquirky.behavior/Runtime/Nodes/BehaviorNodeTokens.cs:15-131

Canonical node-kind tokens shared across source, editor, validation, and bake operations.

Responsibilities:

  • Centralize the stable lowercase identifiers used by behavior source nodes.

Does NOT:

  • Register node implementations or determine runtime semantics.

C#
public const string Action = "action"

Source declaration: Packages/io.bitquirky.behavior/Runtime/Nodes/BehaviorNodeTokens.cs:63

The generic action node token.

C#
public const string AnyState = "any_state"

Source declaration: Packages/io.bitquirky.behavior/Runtime/Nodes/BehaviorNodeTokens.cs:30

The statechart-wide Any State node token.

C#
public const string Condition = "condition"

Source declaration: Packages/io.bitquirky.behavior/Runtime/Nodes/BehaviorNodeTokens.cs:66

The generic condition node token.

C#
public const string Conditional = "conditional"

Source declaration: Packages/io.bitquirky.behavior/Runtime/Nodes/BehaviorNodeTokens.cs:60

The conditional decorator node token.

C#
public const string Entry = "entry"

Source declaration: Packages/io.bitquirky.behavior/Runtime/Nodes/BehaviorNodeTokens.cs:21

The statechart entry node token.

C#
public const string Inverter = "inverter"

Source declaration: Packages/io.bitquirky.behavior/Runtime/Nodes/BehaviorNodeTokens.cs:51

The inverter decorator node token.

C#
public const string MemberCondition = "member_condition"

Source declaration: Packages/io.bitquirky.behavior/Runtime/Nodes/BehaviorNodeTokens.cs:90

The reusable member condition node token.

C#
public const string MemberEvent = "member_event"

Source declaration: Packages/io.bitquirky.behavior/Runtime/Nodes/BehaviorNodeTokens.cs:93

The reusable member event condition node token.

C#
public const string MemberField = "member_field"

Source declaration: Packages/io.bitquirky.behavior/Runtime/Nodes/BehaviorNodeTokens.cs:84

The reusable member field action node token.

C#
public const string MemberMessage = "member_message"

Source declaration: Packages/io.bitquirky.behavior/Runtime/Nodes/BehaviorNodeTokens.cs:87

The reusable member message action node token.

C#
public const string MemberMethod = "member_method"

Source declaration: Packages/io.bitquirky.behavior/Runtime/Nodes/BehaviorNodeTokens.cs:78

The reusable member method action node token .

C#
public const string MemberProperty = "member_property"

Source declaration: Packages/io.bitquirky.behavior/Runtime/Nodes/BehaviorNodeTokens.cs:81

The reusable member property action node token.

C#
public const string MoveTo = "move_to"

Source declaration: Packages/io.bitquirky.behavior/Runtime/Nodes/BehaviorNodeTokens.cs:75

The movement action node token.

C#
public const string Parallel = "parallel"

Source declaration: Packages/io.bitquirky.behavior/Runtime/Nodes/BehaviorNodeTokens.cs:48

The parallel composite node token.

C#
public const string ProbabilitySelector = "probability_selector"

Source declaration: Packages/io.bitquirky.behavior/Runtime/Nodes/BehaviorNodeTokens.cs:39

The probability-selector composite node token.

C#
public const string Repeat = "repeat"

Source declaration: Packages/io.bitquirky.behavior/Runtime/Nodes/BehaviorNodeTokens.cs:54

The repeat decorator node token.

C#
public const string Root = "root"

Source declaration: Packages/io.bitquirky.behavior/Runtime/Nodes/BehaviorNodeTokens.cs:18

The statechart root node token.

C#
public const string Selector = "selector"

Source declaration: Packages/io.bitquirky.behavior/Runtime/Nodes/BehaviorNodeTokens.cs:36

The selector composite node token.

C#
public const string Sequence = "sequence"

Source declaration: Packages/io.bitquirky.behavior/Runtime/Nodes/BehaviorNodeTokens.cs:45

The sequence composite node token.

C#
public const string State = "state"

Source declaration: Packages/io.bitquirky.behavior/Runtime/Nodes/BehaviorNodeTokens.cs:24

The state node token.

C#
public const string StateMachineHost = "state_machine_host"

Source declaration: Packages/io.bitquirky.behavior/Runtime/Nodes/BehaviorNodeTokens.cs:72

The hosted-state-machine leaf node token: addresses a separately authored State Machine graph without flattening it.

C#
public const string StateMachineReference = "state_machine_reference"

Source declaration: Packages/io.bitquirky.behavior/Runtime/Nodes/BehaviorNodeTokens.cs:33

The reusable referenced-state-machine canvas node token.

C#
public const string Subgraph = "subgraph"

Source declaration: Packages/io.bitquirky.behavior/Runtime/Nodes/BehaviorNodeTokens.cs:69

The subgraph-reference node token.

C#
public const string TimeLimit = "timelimit"

Source declaration: Packages/io.bitquirky.behavior/Runtime/Nodes/BehaviorNodeTokens.cs:57

The time-limit decorator node token.

C#
public const string Transition = "transition"

Source declaration: Packages/io.bitquirky.behavior/Runtime/Nodes/BehaviorNodeTokens.cs:27

The state transition node token.

C#
public const string UtilitySelector = "utility_selector"

Source declaration: Packages/io.bitquirky.behavior/Runtime/Nodes/BehaviorNodeTokens.cs:42

The utility-selector composite node token.

Category: Node contracts

C#
class BitQuirky.Behavior.Nodes.BehaviorNodeParameterTokens

Source declaration: Packages/io.bitquirky.behavior/Runtime/Nodes/BehaviorNodeTokens.cs:169-268

Canonical semantic parameter tokens introduced by source format 1.1.

Responsibilities:

  • Centralize stable lowercase parameter keys used by built-in authoring schemas.

Does NOT:

  • Supply values, defaults, or validation behavior for those parameters.

C#
public const string AbortMode = "abort_mode"

Source declaration: Packages/io.bitquirky.behavior/Runtime/Nodes/BehaviorNodeTokens.cs:172

The condition interruption policy parameter token.

C#
public const string ActionExecution = "action_execution"

Source declaration: Packages/io.bitquirky.behavior/Runtime/Nodes/BehaviorNodeTokens.cs:205

The action-state list execution policy token.

C#
public const string ActionLifetime = "action_lifetime"

Source declaration: Packages/io.bitquirky.behavior/Runtime/Nodes/BehaviorNodeTokens.cs:208

The action-state list activation lifetime token.

C#
public const string ActionPhase = "action_phase"

Source declaration: Packages/io.bitquirky.behavior/Runtime/Nodes/BehaviorNodeTokens.cs:211

The direct state action’s explicit lifecycle-phase token.

C#
public const string ArrivalTolerance = "arrival_tolerance"

Source declaration: Packages/io.bitquirky.behavior/Runtime/Nodes/BehaviorNodeTokens.cs:193

The movement arrival-tolerance parameter token.

C#
public const string ConditionOperand = "condition_operand"

Source declaration: Packages/io.bitquirky.behavior/Runtime/Nodes/BehaviorNodeTokens.cs:199

The blackboard condition comparison operand.

C#
public const string ConditionOperator = "condition_operator"

Source declaration: Packages/io.bitquirky.behavior/Runtime/Nodes/BehaviorNodeTokens.cs:196

The blackboard condition comparison-operator token.

C#
public const string Count = "count"

Source declaration: Packages/io.bitquirky.behavior/Runtime/Nodes/BehaviorNodeTokens.cs:178

The bounded repeat-count parameter token.

C#
public const string EntryActionExecution = "entry_action_execution"

Source declaration: Packages/io.bitquirky.behavior/Runtime/Nodes/BehaviorNodeTokens.cs:214

The Entry lifecycle group’s execution policy token.

C#
public const string ExitActionExecution = "exit_action_execution"

Source declaration: Packages/io.bitquirky.behavior/Runtime/Nodes/BehaviorNodeTokens.cs:223

The Exit lifecycle group’s execution policy token.

C#
public const string FailureWeight = "failure_weight"

Source declaration: Packages/io.bitquirky.behavior/Runtime/Nodes/BehaviorNodeTokens.cs:257

The Random Selector’s optional Direct failure weight token. Absent means the outcome is not in the weighted set at all; a present zero is a usable weight that contributes nothing to the denominator and can never be drawn.

C#
public const string MinActiveSeconds = "min_active_seconds"

Source declaration: Packages/io.bitquirky.behavior/Runtime/Nodes/BehaviorNodeTokens.cs:267

The State-owned minimum-active-duration token . Authored only on :::statenodes; absent means a zero dwell budget, so every existing authored state keeps its exact current behavior with no migration.

C#
public const string Policy = "policy"

Source declaration: Packages/io.bitquirky.behavior/Runtime/Nodes/BehaviorNodeTokens.cs:175

The repeat policy parameter token.

C#
public const string Response = "response"

Source declaration: Packages/io.bitquirky.behavior/Runtime/Nodes/BehaviorNodeTokens.cs:260

The per-task response marker parameter token .

C#
public const string Seconds = "seconds"

Source declaration: Packages/io.bitquirky.behavior/Runtime/Nodes/BehaviorNodeTokens.cs:202

The time-limit decorator’s wall-clock budget token, in seconds.

C#
public const string Speed = "speed"

Source declaration: Packages/io.bitquirky.behavior/Runtime/Nodes/BehaviorNodeTokens.cs:190

The movement speed parameter token.

C#
public const string StateCompletion = "completion"

Source declaration: Packages/io.bitquirky.behavior/Runtime/Nodes/BehaviorNodeTokens.cs:247

What a state does after terminal Active Update work.

C#
public const string StateFinishResult = "finish_result"

Source declaration: Packages/io.bitquirky.behavior/Runtime/Nodes/BehaviorNodeTokens.cs:250

The machine result produced by a finishing state.

C#
public const string StateMachineCandidateDefault = "is_default"

Source declaration: Packages/io.bitquirky.behavior/Runtime/Nodes/BehaviorNodeTokens.cs:241

Whether a referenced-machine candidate is the unconditional default.

C#
public const string StateMachineCandidateOverridePrefix = "override_"

Source declaration: Packages/io.bitquirky.behavior/Runtime/Nodes/BehaviorNodeTokens.cs:244

Prefix for a candidate declared-value override parameter.

C#
public const string TargetX = "target_x"

Source declaration: Packages/io.bitquirky.behavior/Runtime/Nodes/BehaviorNodeTokens.cs:181

The target world X parameter token.

C#
public const string TargetY = "target_y"

Source declaration: Packages/io.bitquirky.behavior/Runtime/Nodes/BehaviorNodeTokens.cs:184

The target world Y parameter token.

C#
public const string TargetZ = "target_z"

Source declaration: Packages/io.bitquirky.behavior/Runtime/Nodes/BehaviorNodeTokens.cs:187

The target world Z parameter token.

C#
public const string TransitionEvaluate = "evaluate"

Source declaration: Packages/io.bitquirky.behavior/Runtime/Nodes/BehaviorNodeTokens.cs:226

When a state transition is evaluated.

C#
public const string TransitionKind = "kind"

Source declaration: Packages/io.bitquirky.behavior/Runtime/Nodes/BehaviorNodeTokens.cs:235

Whether a transition switches or pushes its destination.

C#
public const string TransitionOnReturn = "on_return"

Source declaration: Packages/io.bitquirky.behavior/Runtime/Nodes/BehaviorNodeTokens.cs:238

Whether a pushed source resumes or re-enters when its child returns.

C#
public const string TransitionReentry = "reentry"

Source declaration: Packages/io.bitquirky.behavior/Runtime/Nodes/BehaviorNodeTokens.cs:232

How a self-transition re-enters its state.

C#
public const string TransitionResult = "result"

Source declaration: Packages/io.bitquirky.behavior/Runtime/Nodes/BehaviorNodeTokens.cs:229

Which Active Update result permits a state transition.

C#
public const string UpdateActionExecution = "update_action_execution"

Source declaration: Packages/io.bitquirky.behavior/Runtime/Nodes/BehaviorNodeTokens.cs:217

The Active Update lifecycle group’s execution policy token.

C#
public const string UpdateActionLifetime = "update_action_lifetime"

Source declaration: Packages/io.bitquirky.behavior/Runtime/Nodes/BehaviorNodeTokens.cs:220

The Active Update lifecycle group’s activation lifetime token.

Category: Node contracts

C#
enum BitQuirky.Behavior.Nodes.BehaviorNodeStatus

Source declaration: Packages/io.bitquirky.behavior/Runtime/Nodes/BehaviorNodeStatus.cs:11-46

Underlying type: byte

Per-tick result code returned by every behavior node, per section Tick contract.

C#
AuthorityMismatch = 6

Source declaration: Packages/io.bitquirky.behavior/Runtime/Nodes/BehaviorNodeStatus.cs:45

Authority gate refused the tick .

C#
Blocked = 4

Source declaration: Packages/io.bitquirky.behavior/Runtime/Nodes/BehaviorNodeStatus.cs:35

A guard predicate is false. Maps toblocked-condition failure reason in diagnostics.

C#
Failure = 2

Source declaration: Packages/io.bitquirky.behavior/Runtime/Nodes/BehaviorNodeStatus.cs:24

The node’s work finished and the node reports failure to its parent.

C#
Interrupted = 3

Source declaration: Packages/io.bitquirky.behavior/Runtime/Nodes/BehaviorNodeStatus.cs:29

Tick was preempted by a parent / sibling / authority handoff.

C#
Running = 0

Source declaration: Packages/io.bitquirky.behavior/Runtime/Nodes/BehaviorNodeStatus.cs:18

Tick is in flight. The node MUST progress next frame; a node that returnsRunningindefinitely with no awaited external is a bug (silent re-tick loop).

C#
Success = 1

Source declaration: Packages/io.bitquirky.behavior/Runtime/Nodes/BehaviorNodeStatus.cs:21

The node’s work finished and the node reports success to its parent.

C#
Timeout = 5

Source declaration: Packages/io.bitquirky.behavior/Runtime/Nodes/BehaviorNodeStatus.cs:40

A decorator-imposed time limit elapsed.

Source fingerprint: sha256:29003d8b1658b98a79bebcd93e3b4030caf8511268b96817ab764d63df8d6c3b

Full-size image