BitQuirky.Behavior.Nodes.State
Public behavior trees and state machines: runtime backend symbols in BitQuirky.Behavior.Nodes.State.
Source snapshot 29003d8b1658.
On this page
Assembly: BitQuirky.Behavior.Runtime.Backend
Transition
Section titled “Transition”Category: Node contracts
struct BitQuirky.Behavior.Nodes.State.TransitionSource declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Nodes/State/Transition.cs:60-150
Pure-data view of one statechart transition. The baked transition table (BakedTransition) is the authoritative representation; this struct is a per-evaluation projection used by the runtime tick job and the debugger overlay.
Responsibilities:
- Carry the source / target state indices and the optional condition node index used to evaluate the transition.
- Provide a Burst-callable evaluation rule.
Does NOT:
- Resolve the condition predicate: that’s the condition node’s responsibility; this rule is the structural pairing.
Members
Section titled “Members”ConditionNodeIndex
Section titled “ConditionNodeIndex”public int ConditionNodeIndexSource declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Nodes/State/Transition.cs:76
Baked node index of the node whose evaluation gates the transition, or -1 when the transition is unconditional andEvaluatealways fires.
Evaluation
Section titled “Evaluation”public BitQuirky.Behavior.Nodes.State.StateTransitionEvaluation EvaluationSource declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Nodes/State/Transition.cs:86
Point in the tick at which this transition becomes eligible.
public BitQuirky.Behavior.Nodes.State.StateTransitionKind KindSource declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Nodes/State/Transition.cs:105
Whether firing switches away from the source activation or suspends it and pushes the target as a nested activation.
OnReturn
Section titled “OnReturn”public BitQuirky.Behavior.Nodes.State.StateTransitionOnReturn OnReturnSource declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Nodes/State/Transition.cs:111
How the suspended source resumes once the pushed activation returns. Consulted only whenKindis Push.
ResultFilter
Section titled “ResultFilter”public BitQuirky.Behavior.Nodes.State.StateTransitionResultFilter ResultFilterSource declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Nodes/State/Transition.cs:92
Terminal Active Update result required to fire. Consulted only on the completion
boundaries (OnFinish and OnIteration); a Continuous transition ignores it.
SelfReentry
Section titled “SelfReentry”public BitQuirky.Behavior.Nodes.State.StateSelfReentry SelfReentrySource declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Nodes/State/Transition.cs:99
Re-entry policy applied whenTargetStateIndexis the already-active state. The runtime tests this beforeKind, so a self-transition marked Resume keeps the state’s progress and never pushes.
SourceStateIndex
Section titled “SourceStateIndex”public int SourceStateIndexSource declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Nodes/State/Transition.cs:67
Baked node index of the state this transition leaves, matching that state’s StateNodeIndex, or the machine’s Any State node index for a statechart-wide transition.
TargetStateIndex
Section titled “TargetStateIndex”public int TargetStateIndexSource declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Nodes/State/Transition.cs:70
Baked node index of the state entered when the transition fires.
TransitionIdInternedIndex
Section titled “TransitionIdInternedIndex”public int TransitionIdInternedIndexSource declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Nodes/State/Transition.cs:83
Index into the artifact’s interned string table of the transition’s authored id, not a row index in the transition table. The runtime latches it as the cause recorded for the state change.
Evaluate(BehaviorNodeStatus conditionStatus)
Section titled “Evaluate(BehaviorNodeStatus conditionStatus)”public BitQuirky.Behavior.Nodes.State.TransitionEvaluation Evaluate(BitQuirky.Behavior.Nodes.BehaviorNodeStatus conditionStatus)Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Nodes/State/Transition.cs:134-149
Evaluate the transition given the current condition status. A transition with no condition (ConditionNodeIndex = -1) fires unconditionally each tick.
From(BakedTransition baked)
Section titled “From(BakedTransition baked)”public static BitQuirky.Behavior.Nodes.State.Transition From(BitQuirky.Behavior.Baked.BakedTransition baked)Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Nodes/State/Transition.cs:116-127
Project a baked transition into the runtime view.
TransitionConstants
Section titled “TransitionConstants”Category: Node contracts
class BitQuirky.Behavior.Nodes.State.TransitionConstantsSource declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Nodes/State/Transition.cs:10-18
Constants for the statechart Transition node type.
Members
Section titled “Members”public const BitQuirky.Behavior.Baked.BakedNodeKind Kind = TransitionSource declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Nodes/State/Transition.cs:17
Baked runtime node kind.
NodeKindToken
Section titled “NodeKindToken”public const string NodeKindToken = "transition"Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Nodes/State/Transition.cs:13-14
Canonical source node-kind token.
TransitionEvaluation
Section titled “TransitionEvaluation”Category: Node contracts
enum BitQuirky.Behavior.Nodes.State.TransitionEvaluationSource declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Nodes/State/Transition.cs:23-43
Underlying type: byte
Outcome of evaluating a transition’s condition once.
Members
Section titled “Members”AuthorityMismatch
Section titled “AuthorityMismatch”AuthorityMismatch = 2Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Nodes/State/Transition.cs:42
The transition’s read set references a slot the executing
authority is not allowed to read; the runtime declines to
evaluate (typedauthority-mismatchreason).
DoesNotFire
Section titled “DoesNotFire”DoesNotFire = 0Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Nodes/State/Transition.cs:28
Condition does not hold; the transition does not fire this tick.
Fires = 1Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Nodes/State/Transition.cs:35
Condition holds; the runtime should change state to TargetStateIndexand record the transition’s id as the cause.
Source fingerprint: sha256:29003d8b1658b98a79bebcd93e3b4030caf8511268b96817ab764d63df8d6c3b