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.State

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

Source snapshot 29003d8b1658.

Assembly: BitQuirky.Behavior.Runtime.Backend

Category: Node contracts

C#
struct BitQuirky.Behavior.Nodes.State.Transition

Source 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.

C#
public int ConditionNodeIndex

Source 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.

C#
public BitQuirky.Behavior.Nodes.State.StateTransitionEvaluation Evaluation

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Nodes/State/Transition.cs:86

Point in the tick at which this transition becomes eligible.

C#
public BitQuirky.Behavior.Nodes.State.StateTransitionKind Kind

Source 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.

C#
public BitQuirky.Behavior.Nodes.State.StateTransitionOnReturn OnReturn

Source 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.

C#
public BitQuirky.Behavior.Nodes.State.StateTransitionResultFilter ResultFilter

Source 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.

C#
public BitQuirky.Behavior.Nodes.State.StateSelfReentry SelfReentry

Source 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.

C#
public int SourceStateIndex

Source 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.

C#
public int TargetStateIndex

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Nodes/State/Transition.cs:70

Baked node index of the state entered when the transition fires.

C#
public int TransitionIdInternedIndex

Source 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)”
C#
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.

C#
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.

Category: Node contracts

C#
class BitQuirky.Behavior.Nodes.State.TransitionConstants

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Nodes/State/Transition.cs:10-18

Constants for the statechart Transition node type.

C#
public const BitQuirky.Behavior.Baked.BakedNodeKind Kind = Transition

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Nodes/State/Transition.cs:17

Baked runtime node kind.

C#
public const string NodeKindToken = "transition"

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Nodes/State/Transition.cs:13-14

Canonical source node-kind token.

Category: Node contracts

C#
enum BitQuirky.Behavior.Nodes.State.TransitionEvaluation

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Nodes/State/Transition.cs:23-43

Underlying type: byte

Outcome of evaluating a transition’s condition once.

C#
AuthorityMismatch = 2

Source 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).

C#
DoesNotFire = 0

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Nodes/State/Transition.cs:28

Condition does not hold; the transition does not fire this tick.

C#
Fires = 1

Source 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

Full-size image