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

Assembly: BitQuirky.Behavior.Runtime.Backend

Category: Low-level runtime

C#
class BitQuirky.Behavior.Execution.BehaviorHostedStateMachineRuntime

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorHostedStateMachineRuntime.cs:39-622

Implements: IDisposable

Drives the materialize/tick/release lifecycle of a Hosted State Machine node’s second, independently baked artifact instance (FSM-013), outside the Burst-compiled shared tick core, shared by the GameObject binding, the entity binding, and direct-core tests.

Responsibilities:

  • Own the per-activation native storage for at most one concurrently active hosted instance (siblings in a Behavior Tree are mutually exclusive) and the one-slot BehaviorRuntimeInstance/owning-node-index pair passed through BehaviorTick’s hosted-instance overload.
  • Advance an already-materialized hosted instance by exactly one tick before the host’s own tick runs, and materialize a freshly activated row (seeding its input blackboard from the host’s then-current values, research.md R3) or release a row the host’s own tick just finished or tore down, immediately after the host’s own tick runs.
  • Resolve the referenced artifact’s plain normal completion (a reachable dead end with no outgoing transition and no terminal-event transition firing) to a direct Success result, distinct from an authored terminal-event transition into a mapped state.

Does NOT:

  • Resolve a source address to aBakedBehaviorArtifact: the caller supplies an artifact resolver per row.
  • Bind member operations, movement, or GameObject components: the GameObject binding layers that on top through its own binding map.

C#
public BitQuirky.Behavior.Baked.BakedBehaviorArtifact ActiveArtifact { get; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorHostedStateMachineRuntime.cs:217

Gets the active row’s own artifact, or null when nothing is active.

C#
public Unity.Collections.NativeArray<byte> ActiveBlackboard { get; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorHostedStateMachineRuntime.cs:220

Gets the active row’s own blackboard, or an empty array when nothing is active.

C#
public BitQuirky.Behavior.ExternalService.ExternalServiceCommandQueue ActiveCommandQueue { get; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorHostedStateMachineRuntime.cs:223

Gets the active row’s own command queue, or null when nothing is active.

C#
public BitQuirky.Behavior.ExternalService.ExternalServiceCompletionRing ActiveCompletionRing { get; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorHostedStateMachineRuntime.cs:226

Gets the active row’s own completion ring, or null when nothing is active.

C#
public BitQuirky.Behavior.Member.BehaviorMemberBindingRuntime ActiveMemberRuntime { get; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorHostedStateMachineRuntime.cs:234

Gets the active row’s own member runtime (created by theCreatefactory at materialization), or null when nothing is active or the active graph has no member operations. Exposed so a GameObject binding can reuse the same instance for input dispatch; this driver already drives its sample/service/push cycle every tick.

C#
public bool HasRows { get; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorHostedStateMachineRuntime.cs:211

Whether this host graph authors at least one Hosted State Machine node.

C#
public Unity.Collections.NativeArray<BitQuirky.Behavior.Execution.BehaviorRuntimeInstance> InstanceSlot { get; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorHostedStateMachineRuntime.cs:205

Gets the one-slot hosted instance the shared tick core reads and writes.

C#
public bool IsActive { get; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorHostedStateMachineRuntime.cs:214

Whether a hosted instance is currently materialized and active.

C#
public Unity.Collections.NativeArray<int> OwningNodeIndexSlot { get; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorHostedStateMachineRuntime.cs:208

Gets the one-slot owning-node-index the shared tick core reads and writes.

AdvanceBeforeHostTick(EntityId entityId, int frameNumber, float deltaSeconds, in AuthorityContext context)

Section titled “AdvanceBeforeHostTick(EntityId entityId, int frameNumber, float deltaSeconds, in AuthorityContext context)”
C#
public void AdvanceBeforeHostTick(UnityEngine.EntityId entityId, int frameNumber, float deltaSeconds, in BitQuirky.Behavior.Authority.AuthorityContext context)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorHostedStateMachineRuntime.cs:263-276

Advances an already-materialized hosted instance by exactly one tick, skipping a result already terminal and awaiting the host’s own tick to consume it. Call before the host’s own primary tick every update; a no-op while nothing is materialized.

Create(BakedBehaviorArtifact hostArtifact, Func<int, BakedBehaviorArtifact> resolveReferencedArtifact, int graphId, Func<int, BakedBehaviorArtifact, NativeArray<byte>, ExternalServiceCompletionRing, BehaviorMemberBindingRuntime> createMemberRuntime, uint? randomSeed)

Section titled “Create(BakedBehaviorArtifact hostArtifact, Func<int, BakedBehaviorArtifact> resolveReferencedArtifact, int graphId, Func<int, BakedBehaviorArtifact, NativeArray<byte>, ExternalServiceCompletionRing, BehaviorMemberBindingRuntime> createMemberRuntime, uint? randomSeed)”
C#
public static BitQuirky.Behavior.Execution.BehaviorHostedStateMachineRuntime Create(BitQuirky.Behavior.Baked.BakedBehaviorArtifact hostArtifact, System.Func<int, BitQuirky.Behavior.Baked.BakedBehaviorArtifact> resolveReferencedArtifact, int graphId = 0, System.Func<int, BitQuirky.Behavior.Baked.BakedBehaviorArtifact, Unity.Collections.NativeArray<byte>, BitQuirky.Behavior.ExternalService.ExternalServiceCompletionRing, BitQuirky.Behavior.Member.BehaviorMemberBindingRuntime> createMemberRuntime = null, uint? randomSeed = null)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorHostedStateMachineRuntime.cs:164-196

Builds a driver for everyBakedHostedStateMachineReferencerow on hostArtifact; HasRowsis false when it authors none. resolveReferencedArtifact receives a row index (matching HostedStateMachineReferencesorder) and must return a freshly materialized artifact the caller owns no further reference to. createMemberRuntime, when supplied, is called once per fresh activation with that row’s own index, the newly materialized artifact, and blackboard, immediately before that same activation’s own first tick, so a hosted state’s member call is available from that very first tick (no “second tick before members work” gap); returning null is a graph with no member operations to bind. The row index lets the caller resolve that row’s own distinct member references and provider rather than the host graph’s own (FSM-013 C1): a hosted artifact’s member calls bind against its own authored member declarations, never the host’s. For a probability graph, a supplied random seed must be nonzero. A null seed derives the same deterministic nonzero seed from the actual owner identity as a GameObject host. Entity hosts pass their explicit seed, including zero when none was supplied, rather than selecting the managed identity-derived policy.

C#
public void Dispose()

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorHostedStateMachineRuntime.cs:615-621

Disposes the currently materialized row, if any, and the one-slot storage.

ReconcileAfterHostTick(NativeArray<BakedBlackboardSlot> hostBlackboardLayout, NativeArray<byte> hostBlackboard, EntityId entityId, int frameNumber, float deltaSeconds, in AuthorityContext context)

Section titled “ReconcileAfterHostTick(NativeArray<BakedBlackboardSlot> hostBlackboardLayout, NativeArray<byte> hostBlackboard, EntityId entityId, int frameNumber, float deltaSeconds, in AuthorityContext context)”
C#
public void ReconcileAfterHostTick(Unity.Collections.NativeArray<BitQuirky.Behavior.Baked.BakedBlackboardSlot> hostBlackboardLayout, Unity.Collections.NativeArray<byte> hostBlackboard, UnityEngine.EntityId entityId, int frameNumber, float deltaSeconds, in BitQuirky.Behavior.Authority.AuthorityContext context)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorHostedStateMachineRuntime.cs:284-336

Materializes a freshly activated row (seeding its input blackboard from the host’s current values) and ticks it once, or releases a row the host’s own tick just consumed or tore down. Call immediately after the host’s own primary tick every update.

C#
public void ReleaseActive()

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorHostedStateMachineRuntime.cs:243-256

Immediately disposes any currently materialized hosted instance and releases the one-slot claim, with no resume (/FSM-013 row 3), for a caller that tears the host down outside its own normal tick cadence: a reset, a cancellation, or an agent disable. The next activation materializes fresh and replays the owner’s initial random sequence. Ordinary row completion and preemption preserve the advanced stream instead.

Category: Low-level runtime

C#
struct BitQuirky.Behavior.Execution.BehaviorReactiveConditionState

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorRuntimeInstance.cs:787-792

Implements: IBufferElementData

Entity dynamic-buffer element mirroring one shared-core reactive observer state.

Responsibilities:

  • Persist artifact-indexed observer state in entity chunk storage.

Does NOT:

  • Own baked observer definitions or change their ordering.

C#
public BitQuirky.Behavior.Execution.ReactiveConditionRuntimeState Value

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorRuntimeInstance.cs:791

Shared-core observer state stored for this artifact table row.

Category: Low-level runtime

C#
struct BitQuirky.Behavior.Execution.BehaviorRuntimeArtifactBinding

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorTickSystem.cs:580-661

Implements: IComponentData

Per-entity binding to a baked artifact’s native arrays. The host stamps this when it spawns an agent so main-thread composition can keep the artifact association explicit. The batched job does not read this component because native containers inside components are not job-safe; BehaviorRuntimeTickIdentityis the job-side opt-in marker.

C#
public bool IsValid { get; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorTickSystem.cs:660

Gets whether this binding has been stamped with a baked artifact’s node table.

C#
public int AnyStateNodeIndex

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorTickSystem.cs:647

Baked node index of the optional Any State plate, or -1 when absent.

C#
public Unity.Collections.NativeArray<BitQuirky.Behavior.Baked.BakedAuthorityEntry> AuthorityTable

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorTickSystem.cs:622

Dense field-id to owner-authority rows the runtime authority gate scans without reading whole blackboard slots.

C#
public Unity.Collections.NativeArray<BitQuirky.Behavior.Baked.BakedBlackboardSlot> BlackboardLayout

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorTickSystem.cs:620

Blackboard slots: field id, type code, byte offset, and owning authority for each declared graph field.

C#
public Unity.Collections.NativeArray<int> EmitServiceIds

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorTickSystem.cs:630

Flattened service-id hashes a node emits without awaiting completion, addressed by its (EmitServiceStart, EmitServiceCount) range.

C#
public int EntryStateIndex

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorTickSystem.cs:645

Baked node index of the statechart’s entry state, or -1 when the graph has no statechart.

C#
public int ExecutionStepLimit

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorTickSystem.cs:649

Maximum evaluation steps one tick may take; exhausting it faults the machine with ExecutionLimitExceeded. A non-positive value is treated as a single step.

C#
public int FollowerId

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorTickSystem.cs:657

Follower id this binding belongs to. Set by the host runtime when registering a follower. The batched job reads FollowerIdfor pause / step decisions because this binding is main-thread state.

C#
public Unity.Collections.NativeArray<BitQuirky.Behavior.Baked.BakedHostedResultEventCondition> HostedResultEventConditions

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorTickSystem.cs:606

Hosted terminal-result event conditions that transitions address by index.

C#
public Unity.Collections.NativeArray<BitQuirky.Behavior.Baked.BakedInterruptibleServiceRequirement> InterruptibleServiceRequirements

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorTickSystem.cs:640-641

Service capabilities required by the reactive condition definitions.

C#
public Unity.Collections.NativeArray<int> MemberOperationByNode

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorTickSystem.cs:636

Member operation row for each baked node index, or -1; empty when the graph has no member bindings.

C#
public Unity.Collections.NativeArray<BitQuirky.Behavior.Baked.BakedMemberOperation> MemberOperations

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorTickSystem.cs:634

Baked member operations, each describing one node’s binding to a method, property, field, or event on a customer component.

C#
public Unity.Collections.NativeArray<byte> NativeDefaultBytes

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorTickSystem.cs:614

Declared blackboard defaults in the same byte layout as the live blackboard, copied on initialization; empty when the graph declares none.

C#
public Unity.Collections.NativeArray<BitQuirky.Behavior.Baked.BakedNode> Nodes

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorTickSystem.cs:583

The artifact’s baked node table; every node index the runtime reports is a position in this array.

C#
public Unity.Collections.NativeArray<BitQuirky.Behavior.Baked.BakedNodeParameter> Parameters

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorTickSystem.cs:632

Dense semantic node parameter table carrying each parameter’s stable id, type tag, and value words.

C#
public Unity.Collections.NativeArray<BitQuirky.Behavior.Baked.BakedReactiveCondition> ReactiveConditions

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorTickSystem.cs:638

Deterministically ordered reactive condition definitions.

C#
public Unity.Collections.NativeArray<int> ReadFieldIds

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorTickSystem.cs:624

Flattened read-set field id hashes, addressed by each node’s (ReadFieldStart, ReadFieldCount) range.

C#
public int RootNodeIndex

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorTickSystem.cs:643

Baked node index of the graph’s behavior tree root, or -1 when the graph has none.

C#
public Unity.Collections.NativeArray<BitQuirky.Behavior.Baked.BakedStateActionList> StateActionLists

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorTickSystem.cs:600

State-owned direct-action list rows, each naming its state node and a range into StateActionNodeIndices.

C#
public Unity.Collections.NativeArray<int> StateActionNodeIndices

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorTickSystem.cs:602

Baked node indices of direct actions flattened in authored order, addressed by the (ActionNodeStart, ActionCount) range on a StateActionLists row.

C#
public Unity.Collections.NativeArray<BitQuirky.Behavior.Baked.BakedStateHostedBehavior> StateHostedBehaviors

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorTickSystem.cs:604

Lifecycle rows for state-owned hosted behavior trees.

C#
public Unity.Collections.NativeArray<int> StateIndexByNode

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorTickSystem.cs:618

Row index into StatechartStates for each baked node index, or -1 for nodes that are not states.

C#
public Unity.Collections.NativeArray<BitQuirky.Behavior.Baked.BakedStateMachineCandidate> StateMachineCandidates

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorTickSystem.cs:612

Ordered candidate rows for every referenced-machine node.

C#
public Unity.Collections.NativeArray<BitQuirky.Behavior.Baked.BakedStateMachineReference> StateMachineReferences

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorTickSystem.cs:610

Referenced-machine nodes, each naming a (CandidateStart, CandidateCount) range into StateMachineCandidates.

C#
public Unity.Collections.NativeArray<BitQuirky.Behavior.Baked.BakedStateMachine> StateMachines

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorTickSystem.cs:608

Composed state-machine rows; row zero is the host machine.

C#
public Unity.Collections.NativeArray<BitQuirky.Behavior.Nodes.State.StatechartState> StatechartStates

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorTickSystem.cs:616

One dense row per baked state node, reached through StateIndexByNode.

C#
public Unity.Collections.NativeArray<BitQuirky.Behavior.Baked.BakedTransitionCondition> TransitionConditions

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorTickSystem.cs:595

Transition predicate rows, addressed by each transition’s (ConditionStart, ConditionCount) range.

C#
public Unity.Collections.NativeArray<byte> TransitionConstantBytes

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorTickSystem.cs:598

Deterministic wide constants of declared transition operands .

C#
public Unity.Collections.NativeArray<BitQuirky.Behavior.Baked.BakedTransition> Transitions

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorTickSystem.cs:585

The artifact’s transition table; a state’s outgoing edges are the contiguous run of rows whose source is that state.

C#
public Unity.Collections.NativeArray<BitQuirky.Behavior.Baked.BakedUtilityBranch> UtilityBranches

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorTickSystem.cs:589

Branches of every Utility Selector, addressed by the selector node’s (UtilityBranchStart, UtilityBranchCount) range.

C#
public Unity.Collections.NativeArray<BitQuirky.Behavior.Baked.BakedUtilityConsideration> UtilityConsiderations

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorTickSystem.cs:591

Considerations of every Utility Selector branch, addressed by the owning branch’s (ConsiderationStart, ConsiderationCount) range.

C#
public Unity.Collections.NativeArray<BitQuirky.Behavior.Baked.BakedUtilityCurveSample> UtilityCurveSamples

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorTickSystem.cs:593

Curve keys of every Utility Selector consideration sampled through a curve, addressed by the owning consideration’s (CurveStart, CurveKeyCount) range.

C#
public Unity.Collections.NativeArray<int> WaitsServiceIds

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorTickSystem.cs:628

Flattened service-id hashes a node waits on for completion, addressed by its (WaitsServiceStart, WaitsServiceCount) range.

C#
public Unity.Collections.NativeArray<BitQuirky.Behavior.Baked.BakedWeightedChild> WeightedChildren

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorTickSystem.cs:587

Weighted children of every Probability Selector, addressed by the selector node’s (WeightedChildStart, WeightedChildCount) range.

C#
public Unity.Collections.NativeArray<int> WriteFieldIds

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorTickSystem.cs:626

Flattened write-set field id hashes, addressed by each node’s (WriteFieldStart, WriteFieldCount) range.

Category: Low-level runtime

C#
struct BitQuirky.Behavior.Execution.BehaviorRuntimeBlackboardByte

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorRuntimeInstance.cs:843-853

Implements: IBufferElementData

Per-follower blackboard byte buffer. Stored as a DynamicBuffer on the follower entity so the per-instance allocation lives in ECS chunks alongside the cursor component. Its logical payload is sized from BlackboardByteSize; synchronized entity graphs append fixed package-private write-journal metadata after that payload.

C#
public byte Value

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorRuntimeInstance.cs:847

One byte of the blackboard payload, at the offset given by this element’s buffer index.

op_Implicit(BehaviorRuntimeBlackboardByte b)

Section titled “op_Implicit(BehaviorRuntimeBlackboardByte b)”
C#
public static implicit operator byte(BitQuirky.Behavior.Execution.BehaviorRuntimeBlackboardByte b)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorRuntimeInstance.cs:850

Unwraps a buffer element to the raw blackboard byte it stores.

C#
public static implicit operator BitQuirky.Behavior.Execution.BehaviorRuntimeBlackboardByte(byte v)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorRuntimeInstance.cs:852

Wraps a raw blackboard byte so it can be written into the buffer.

Category: Low-level runtime

C#
struct BitQuirky.Behavior.Execution.BehaviorRuntimeHostedStateMachineInstance

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorRuntimeInstance.cs:809-814

Implements: IBufferElementData

Entity dynamic-buffer element holding a Hosted State Machine node’s (FSM-013) one-slot referenced-artifact instance, resized to exactly one element at attachment so the shared batched tick job can address it with the same one-slot contract the GameObject binding’s own persistently allocated slot uses.

Responsibilities:

  • Let the Burst-compiled batched job claim, read, and release the owning Hosted State Machine node’s materialized result per entity, exactly as it does for every other per-entity runtime state array.

Does NOT:

  • Materialize, tick, or dispose the referenced artifact itself: that remains managed work driven byBehaviorHostedStateMachineRuntimeoutside the job.

C#
public BitQuirky.Behavior.Execution.BehaviorRuntimeInstance Value

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorRuntimeInstance.cs:813

The one-slot hosted instance’s current runtime state.

BehaviorRuntimeHostedStateMachineOwningNodeIndex

Section titled “BehaviorRuntimeHostedStateMachineOwningNodeIndex”

Category: Low-level runtime

C#
struct BitQuirky.Behavior.Execution.BehaviorRuntimeHostedStateMachineOwningNodeIndex

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorRuntimeInstance.cs:829-834

Implements: IBufferElementData

Entity dynamic-buffer element holding the baked node index of the Hosted State Machine node that currently ownsBehaviorRuntimeHostedStateMachineInstancefor this entity, or -1 when none does (FSM-013).

Responsibilities:

  • Mirror, per entity, the single owning-node-index slot the GameObject binding’s own persistently allocated array holds.

Does NOT:

  • Resolve the owning node’s referenced artifact or decide materialization; the shared tick core and the managed hosted-instance driver own that decision.

C#
public int Value

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorRuntimeInstance.cs:833

The owning baked node index, or -1 when no Hosted State Machine is active.

Category: Low-level runtime

C#
struct BitQuirky.Behavior.Execution.BehaviorRuntimeInstance

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorRuntimeInstance.cs:50-775

Implements: IComponentData

Per-follower live execution state for a Layer 2 behavior graph.

Responsibilities:

  • Carry the full runtime cursor: graph-id, current-node-id, current-state-id, last-transition-id / cause-id, last-result-code, authority-context-id, trace-tier, per data-model.md §Behavior Runtime Instance.
  • Hold up toMaxPendingExternalsoutstanding pending- external slots so the tick job can resume on completion ring records without managed allocation.
  • Stamp the last-transition / last-result fields after every leaf tick so the always-on trace and Quantum Console state commands can read them on demand without sampling the tick directly.
  • Carry the single state-hosted behavior tree cursor: owning state, baked lifetime, completed cycle count, last terminal cycle frame, and the recorded terminal result and result-event id, so hosted lifetime, result events, and interruption behave identically in every object model.
  • State-transition rule (every leaf tick): start in Running; resolve to one of Success / Failure / Interrupted / Blocked / Timeout / AuthorityMismatch / AuthorityHandoff / ExternalServiceRefused / SubgraphError; transition-edge fires update CurrentStateId+ record LastTransitionCauseId.

Does NOT:

  • Allocate per-follower buffers (those live on BehaviorRuntimeInstanceDataas ECS buffer elements when the entities package is present, or on the managed shadow handle when it is not).
  • Parse Mermaid (FR-012f).
  • Mutate consumer gameplay data directly. Node side effects flow through External Service Adapters (Layer 3).

C#
public uint ActionActivationGeneration

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorRuntimeInstance.cs:339

Monotonic activation generation for direct state action lists.

C#
public BitQuirky.Behavior.Execution.BehaviorActionLifecycleRuntimeState ActionLifecycle

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorRuntimeInstance.cs:345

Bounded Entry, Active Update, and Exit lifecycle progress for the active action state, including the latched destination and the single remaining Exit evaluation.

C#
public int ActiveDecoratorNodeIndex

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorRuntimeInstance.cs:155

Active node whose decorator ancestry owns the persistent Repeat and Time Limit rows. Comparing this cursor withCurrentNodeIndexlets the tick core clear only decorators exited by an ancestry change.

C#
public int ActiveMachineIndex

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorRuntimeInstance.cs:124

Active composed-machine row; zero is the host machine.

C#
public int ActiveNestedReferenceNodeIndex

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorRuntimeInstance.cs:109

Requested frame capacity when a Push could not fit this tick.

C#
public int ActiveProbabilitySelectorIndex

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorRuntimeInstance.cs:187

Active probability selector, or -1 when no weighted selection is active.

C#
public int ActiveStateMachineCandidateIndex

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorRuntimeInstance.cs:118

Selected referenced-machine candidate node, or -1 while parked/outside.

C#
public int ActiveStateMachineReferenceIndex

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorRuntimeInstance.cs:115

Referenced-machine node currently executing, or -1 outside a reference.

C#
public int ActiveUtilitySelectorIndex

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorRuntimeInstance.cs:215

Active Utility Selector, or -1 when no highest-score selection is active.

C#
public BitQuirky.Behavior.Baked.BakedAuthorityContext AuthorityContextId

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorRuntimeInstance.cs:272

Authority this instance was attached under, compared against each node’s declared authority by the runtime gate before that node may tick.

C#
public int CompositeChildCursor

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorRuntimeInstance.cs:142

Per-composite cursor child index. The tick job walks composites iteratively; this preserves the position across frames when a child isRunning.

C#
public float CurrentNodeElapsedSeconds

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorRuntimeInstance.cs:163

Wall-clock seconds the current cursor has been ticking, surfaced by the always-on trace. Time Limit decorators retain their subtree clocks independently in BehaviorTimeLimitRuntimeStaterows.

C#
public int CurrentNodeIndex

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorRuntimeInstance.cs:89

Active baked-node index. -1 when the instance is unscheduled (just spawned, or just transitioned with no entry tick yet).

C#
public int CurrentStateIndex

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorRuntimeInstance.cs:100

Active top-level statechart state’s baked-node index.

C#
public int DecoratorIterationsCompleted

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorRuntimeInstance.cs:149

Compatibility mirror of the activeRepeatprogress. Authoritative nested progress lives in artifact-indexed BehaviorRepeatRuntimeStaterows supplied to the tick core.

C#
public int DeepestExecutedNodeIndex

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorRuntimeInstance.cs:95

Deepest node executed during the latest tick, or -1 when the latest tick did not execute a node or the runtime has just been reset.

C#
public ulong GraphContentHash

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorRuntimeInstance.cs:75

Hash of the baked artifact this instance ticks against. Used to detect graph hot-swap (when the loader rebakes from updated Mermaid, the hash changes and the instance resets).

C#
public int GraphId

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorRuntimeInstance.cs:83

Identifier of the loaded graph. Implementation defines the id scheme (e.g. interned string-table index in the FollowerBehaviorRuntimeor a source hash); the runtime treats it as opaque.

C#
public int HostStep

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorRuntimeInstance.cs:316

Ordinal of the current host observation. Explicit HostStep entries always advance it; Microstep entries share it. Automatic uses the legacy frame/delta boundary described byRepeatRestartedThisFrame. Compared only for equality, so wrapping is harmless.

C#
public int HostedCompletedCycleCount

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorRuntimeInstance.cs:376

Terminal hosted cycles completed sinceHostedStateIndexwas entered.

C#
public byte HostedEventPending

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorRuntimeInstance.cs:414

1 while a recorded result event still awaits its single immediate transition evaluation. An unmatched event expires before the next hosted cycle starts.

C#
public int HostedLastCycleFrame

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorRuntimeInstance.cs:383

Frame that recorded the latest terminal hosted cycle, or -1, for traces and the result event’s tick. The Repeat lifetime’s once-per-tick rule keys on HostedLastCycleStepinstead.

C#
public int HostedLastCycleStep

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorRuntimeInstance.cs:390

HostStepthat recorded the latest terminal hosted cycle, or -1. A Repeat lifetime starts its fresh cycle on the next host step rather than the current one, so each of several FixedUpdate steps in one render frame still runs one cycle.

C#
public BitQuirky.Behavior.Baked.BakedHostedBehaviorLifetime HostedLifetime

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorRuntimeInstance.cs:405

Baked lifetime of the hosted tree owned byHostedStateIndex. An omitted authored lifetime bakes toRepeat.

C#
public byte HostedReserved0

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorRuntimeInstance.cs:417

Alignment padding that keeps the hosted cursor four-byte aligned.

C#
public BitQuirky.Behavior.Execution.BehaviorResultCode HostedResultCode

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorRuntimeInstance.cs:408

Terminal result of the latest hosted cycle, or None.

C#
public int HostedResultEventId

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorRuntimeInstance.cs:399

Interned result-event id recorded by the latest terminal hosted cycle, or 0 when that outcome has no configured event.

C#
public int HostedResultTick

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorRuntimeInstance.cs:393

Input tick that produced the held hosted result, or -1 before completion.

C#
public int HostedStateIndex

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorRuntimeInstance.cs:371

State that owns the active hosted behavior tree, or -1 when no hosted tree is active. Entry, exit, and reset rewrite the whole hosted cursor as one unit .

C#
public uint InitialRandomSeed

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorRuntimeInstance.cs:177

Seed supplied when this runtime instance was created.

C#
public int LastEvaluatedTransitionPredicateId

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorRuntimeInstance.cs:250

Stable hash of the graph field the most recently evaluated transition predicate read as its left operand, or -1 when no predicate group has been evaluated.

C#
public int LastEvaluatedTransitionRightFieldId

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorRuntimeInstance.cs:260

Stable hash of the graph value the most recently evaluated transition predicate compared against, or -1 when that predicate compared against its baked constant. Paired withLastEvaluatedTransitionPredicateIdthis names both operands of the deciding comparison, so a trace consumer can tell live_enemies >= 2200 apart from live_enemies >= $surge_live_enemy_limit without reopening the baked artifact.

C#
public BitQuirky.Behavior.Execution.BehaviorInterruptionRecord LastInterruption

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorRuntimeInstance.cs:282

Latest structured branch interruption, if one has occurred.

C#
public int LastProbabilitySelectorIndex

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorRuntimeInstance.cs:195

Random Selector that owns the retained selected outcome and candidate mask, or -1 before any selection and after reset or interruption. This remains set after Direct failure ends a pass so Live presentation never attributes its unreached branches to another selector.

C#
public BitQuirky.Behavior.Execution.BehaviorResultCode LastResultCode

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorRuntimeInstance.cs:262

Result of the most recent step, stamped by RecordLastResult; None before the first tick.

C#
public int LastTickedFrame

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorRuntimeInstance.cs:279

Host frame of the last completed tick, including a state pass with no leaf work.

C#
public int LastTransitionCauseId

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorRuntimeInstance.cs:242

What satisfied that transition: the stable hash of the deciding graph field for a condition-group edge, otherwise the baked node index of the edge’s condition node; -1 before any transition fires.

C#
public int LastTransitionFrame

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorRuntimeInstance.cs:248

Frame on which the most recent state-machine transition fired, or -1 before one fires. The editor uses this event stamp to distinguish an existing historical transition from a transition that fires after a Live attachment begins.

C#
public int LastTransitionId

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorRuntimeInstance.cs:240

Interned string index of the most recently fired transition’s authored id, or -1 before any transition fires.

C#
public int LastUtilitySelectorIndex

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorRuntimeInstance.cs:221

Utility Selector that owns the retained selected branch and candidate mask, or -1 before any selection and after reset or interruption.

C#
public BitQuirky.Behavior.Diagnostics.BehaviorUtilityTraceEntry LastUtilityTrace

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorRuntimeInstance.cs:291

Latest structured tactic-change trace entry recorded when a Utility Selector’s committed branch actually changed (; contract per-agent-tactic-observation.md§Structured Tracing; research D-R10). Frame -1 before any committed-branch change has ever been recorded. Held across ticks, including a tick where no change occurred, exactly likeLastInterruption.

C#
public byte MachineFinished

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorRuntimeInstance.cs:135

One after terminal completion, including Return with no suspended caller.

C#
public BitQuirky.Behavior.Execution.BehaviorMachineResult MachineResult

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorRuntimeInstance.cs:268

Explicit final state-machine result. UnlikeLastResultCode, this value remainsNonewhile the machine is active and keeps the terminal result observable after execution stops.

C#
public const int MaxPendingExternals = 4

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorRuntimeInstance.cs:64

Maximum pending externals tracked per follower. Each adapter is expected to use at most one slot at a time; four covers the canonical adapters (path, animation, follower-state, house-combat) without spilling to the heap.

C#
public uint MemberActivationGeneration

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorRuntimeInstance.cs:361

Monotonic activation generation stamped onto each deferred coroutine or event member operation so a stale callback cannot complete a later activation .

C#
public BitQuirky.Behavior.Execution.BehaviorMemberRequestSlot MemberRequest

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorRuntimeInstance.cs:355

The single in-flight immediate member request channel serviced by the host through a bounded in-tick microstep .

C#
public BitQuirky.Behavior.Execution.BehaviorNestedMachinePhase NestedMachinePhase

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorRuntimeInstance.cs:130

Stable lifecycle phase of the active/last referenced machine.

C#
public BitQuirky.Behavior.Execution.BehaviorMachineResult NestedMachineResult

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorRuntimeInstance.cs:127

Final result of the most recently completed nested machine.

C#
public int NextCommandId

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorRuntimeInstance.cs:336

Next command identifier owned by this runtime instance. Per-agent ownership keeps parallel ticks independent while completion matching remains scoped by entity, command, and service ids.

C#
public BitQuirky.Behavior.Execution.PendingExternalSlot Pending0

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorRuntimeInstance.cs:323

Pending-external slot 0; its InUse byte is zero while the slot is free. Prefer GetPending and SetPending for index-addressed access.

C#
public BitQuirky.Behavior.Execution.PendingExternalSlot Pending1

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorRuntimeInstance.cs:325

Pending-external slot 1.

C#
public BitQuirky.Behavior.Execution.PendingExternalSlot Pending2

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorRuntimeInstance.cs:327

Pending-external slot 2.

C#
public BitQuirky.Behavior.Execution.PendingExternalSlot Pending3

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorRuntimeInstance.cs:329

Pending-external slot 3.

C#
public ulong ProbabilityCandidateMask

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorRuntimeInstance.cs:210

Eligible weighted children, addressed by authored child order. After a pass ends by Direct failure the remaining bits are retained, so the branches the pass never reached stay observable until the selector is entered again.

C#
public uint RandomState

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorRuntimeInstance.cs:182

Current deterministic pseudo-random state for probability nodes.

C#
public uint ReferenceActivationGeneration

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorRuntimeInstance.cs:121

Monotonic identity of the latest referenced-machine candidate activation.

C#
public byte ReferenceParked

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorRuntimeInstance.cs:132

One while a reference is parked because no candidate is eligible.

C#
public byte RepeatRestartedThisFrame

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorRuntimeInstance.cs:303

Non-zero after a Repeat restarts and descends into a fresh leaf during the current host observation. ExplicitHostStepentries clear it even when the delta is zero and the frame is unchanged. Explicit Microstepentries retain it, preventing a continuation from evaluating facts invalidated by an earlier Repeat restart. Automaticpreserves the original public protocol: a changed frame or positive delta begins a host step; zero delta in the same frame continues it.

C#
public int RepeatRestartedThisFrameNumber

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorRuntimeInstance.cs:309

Host frame number at the last entry that began a host observation and cleared RepeatRestartedThisFrame. Sentinel -1before the first tick.

C#
public int RequiredSuspendedActionCapacity

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorRuntimeInstance.cs:113

Requested sparse action capacity when a Push could not fit this tick.

C#
public int RequiredSuspensionFrameCapacity

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorRuntimeInstance.cs:111

Frame capacity a Push needed when the suspension-frame buffer was too small this tick, or 0; the host grows the buffer to at least this size and the Push retries on a later tick.

C#
public byte Reserved0

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorRuntimeInstance.cs:274

Reserved byte kept zero for additive binary evolution.

C#
public int SelectedProbabilityChildIndex

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorRuntimeInstance.cs:203

Selected weighted child, or -1 before activation and after reset. The value -2 means the Random Selector drew its optional Direct failure outcome and ended the pass without ticking a child, which is what tells a direct failure apart from a pass that simply exhausted its candidates.

C#
public int SelectedUtilityBranchIndex

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorRuntimeInstance.cs:227

Row of the running branch in the artifact’s utility-branch table, or -1 before selection and after reset.

C#
public float StateActiveElapsedSeconds

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorRuntimeInstance.cs:172

Wall-clock secondsCurrentStateIndexhas been continuously active, accumulated once per real host tick (never per internal execution-step iteration) and reset to zero whenever a new state activates. Gates that state’s own outgoing transitions against its authored minimum-active-duration parameter (, /); a state with no such parameter is never gated by this clock.

C#
public int SuspendedActionStateCount

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorRuntimeInstance.cs:106

Used rows in the sparse suspended-action pool.

C#
public int SuspensionDepth

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorRuntimeInstance.cs:103

Number of preserved Push activations beneath the active state.

C#
public BitQuirky.Behavior.Execution.BehaviorTraceTier TraceTier

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorRuntimeInstance.cs:270

Trace verbosity this instance publishes; ForReplacement carries it forward.

C#
public ulong UtilityCandidateMask

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorRuntimeInstance.cs:233

Eligible Utility Selector branches, addressed by authored source order. A Failure removes the failed branch’s bit so the same pass never re-selects it.

C#
public void CancelAllPending()

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorRuntimeInstance.cs:681-688

Cancel every outstanding pending slot, used by AuthorityHandoffHandler after an authority handoff.

C#
public void ClearHostedCursor()

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorRuntimeInstance.cs:746-757

Stop the active hosted behavior tree. State exit, graph restart, and reset clear the cursor so an interrupted cycle can never record a later terminal result event.

C#
public void EnterLatchedState(int newStateIndex)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorRuntimeInstance.cs:715-740

Enter a chosen destination state with clean cursor, lifecycle, and activation generation so no completion from the previous activation can be accepted.

C#
public int FindPendingByCommand(int commandId)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorRuntimeInstance.cs:638-646

Find a pending slot matchingcommandId; returns -1 when not found.

ForArtifact(BakedBehaviorArtifact artifact, int graphId, BakedAuthorityContext authority, BehaviorTraceTier tier)

Section titled “ForArtifact(BakedBehaviorArtifact artifact, int graphId, BakedAuthorityContext authority, BehaviorTraceTier tier)”
C#
public static BitQuirky.Behavior.Execution.BehaviorRuntimeInstance ForArtifact(BitQuirky.Behavior.Baked.BakedBehaviorArtifact artifact, int graphId, BitQuirky.Behavior.Baked.BakedAuthorityContext authority, BitQuirky.Behavior.Execution.BehaviorTraceTier tier = AlwaysOn)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorRuntimeInstance.cs:429-439

Build a first-attach instance bound to the given baked artifact. Caller is responsible for separately allocating the per-follower blackboard buffer (BehaviorRuntimeBlackboardByte). Graph replacement must use ForReplacementso command and activation identity remain monotonic.

ForArtifact(BakedBehaviorArtifact artifact, int graphId, BakedAuthorityContext authority, uint randomSeed, BehaviorTraceTier tier)

Section titled “ForArtifact(BakedBehaviorArtifact artifact, int graphId, BakedAuthorityContext authority, uint randomSeed, BehaviorTraceTier tier)”
C#
public static BitQuirky.Behavior.Execution.BehaviorRuntimeInstance ForArtifact(BitQuirky.Behavior.Baked.BakedBehaviorArtifact artifact, int graphId, BitQuirky.Behavior.Baked.BakedAuthorityContext authority, uint randomSeed, BitQuirky.Behavior.Execution.BehaviorTraceTier tier = AlwaysOn)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorRuntimeInstance.cs:445-459

Build a first-attach instance with an explicit deterministic random seed. Graph replacement must useForReplacement.

ForReplacement(BakedBehaviorArtifact artifact, int graphId, BakedAuthorityContext authority, in BehaviorRuntimeInstance previous, uint randomSeed)

Section titled “ForReplacement(BakedBehaviorArtifact artifact, int graphId, BakedAuthorityContext authority, in BehaviorRuntimeInstance previous, uint randomSeed)”
C#
public static BitQuirky.Behavior.Execution.BehaviorRuntimeInstance ForReplacement(BitQuirky.Behavior.Baked.BakedBehaviorArtifact artifact, int graphId, BitQuirky.Behavior.Baked.BakedAuthorityContext authority, in BitQuirky.Behavior.Execution.BehaviorRuntimeInstance previous, uint randomSeed = 0)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorRuntimeInstance.cs:466-488

Build a replacement instance while carrying the previous runtime’s command and activation identity forward. The replacement starts a fresh action activation and retains the prior trace tier.

C#
public BitQuirky.Behavior.Execution.PendingExternalSlot GetPending(int slotIndex)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorRuntimeInstance.cs:576-586

Read pending slot at index (0..MaxPendingExternals-1).

RecordLastResult(BehaviorResultCode code, int frame)

Section titled “RecordLastResult(BehaviorResultCode code, int frame)”
C#
public void RecordLastResult(BitQuirky.Behavior.Execution.BehaviorResultCode code, int frame)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorRuntimeInstance.cs:693-697

Stamp result of the most recent leaf tick onto the trace mirror.

RecordTransition(int transitionId, int causeId, int newStateIndex, int frameNumber)

Section titled “RecordTransition(int transitionId, int causeId, int newStateIndex, int frameNumber)”
C#
public void RecordTransition(int transitionId, int causeId, int newStateIndex, int frameNumber)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorRuntimeInstance.cs:764-772

Stamp the most recent transition id and stable cause identifier onto the trace mirror and immediately enter the destination state. This low-level mutation bypasses the shared tick scheduler’s latched transition timing.

RecordTransitionLatch(int transitionId, int causeId, int frameNumber)

Section titled “RecordTransitionLatch(int transitionId, int causeId, int frameNumber)”
C#
public void RecordTransitionLatch(int transitionId, int causeId, int frameNumber)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorRuntimeInstance.cs:704-709

Stamp the most recent transition id and stable cause identifier onto the trace mirror without leaving the source state. The shared scheduler uses this while the destination is latched across the transition-frame boundary and any bounded Exit.

C#
public void ReleasePendingSlot(int slotIndex)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorRuntimeInstance.cs:671-674

Free a pending slot.

C#
public int ReserveCommandId()

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorRuntimeInstance.cs:652-666

Reserves the next positive command identifier without shared mutable storage. Active identifiers are skipped when the counter wraps.

SetPending(int slotIndex, PendingExternalSlot value)

Section titled “SetPending(int slotIndex, PendingExternalSlot value)”
C#
public void SetPending(int slotIndex, BitQuirky.Behavior.Execution.PendingExternalSlot value)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorRuntimeInstance.cs:591-600

Write pending slot at index (0..MaxPendingExternals-1).

TryReservePendingSlot(int serviceId, int commandId, int pendingId, int frame, int owningNodeIndex)

Section titled “TryReservePendingSlot(int serviceId, int commandId, int pendingId, int frame, int owningNodeIndex)”
C#
public int TryReservePendingSlot(int serviceId, int commandId, int pendingId, int frame, int owningNodeIndex = -1)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorRuntimeInstance.cs:607-632

Allocate the next free pending slot, return its index. Returns -1 when full; the runtime treats this as a typed ExternalServiceRefused.

Category: Low-level runtime

C#
struct BitQuirky.Behavior.Execution.BehaviorRuntimeTickIdentity

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorTickSystem.cs:680-684

Implements: IComponentData

Job-safe identity for an entity that may be advanced by BehaviorTickSystem. The artifact binding holds native containers and therefore cannot be read by or used to filter the batched job; this small companion component marks the entity as tickable and carries only the follower id needed for debug pause / step decisions.

Responsibilities:

Does NOT:

  • Carry baked graph tables or blackboard storage.
  • Define entity lifetime or stable service identity; commands and completions useEntityIdfor that.

C#
public int FollowerId

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorTickSystem.cs:683

Host-defined id used by debug pause / step decisions.

Category: Low-level runtime

C#
class BitQuirky.Behavior.Execution.BehaviorTick

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorTickCore.cs:343-1276

The single Burst-callable per-agent tick core (Principle III: one shared core, both object models).TickOneadvances exactly one agent’sBehaviorRuntimeInstanceand blackboard by one step, operating on the blackboard in place. The batched BehaviorTickJobcalls it once per agent from a parallel IJobEntity; the Samples~/ToyGraphdriver and the EditMode suites call it directly on the main thread. Because all three paths share this core, node / statechart / external-service semantics are identical across them .

Responsibilities:

  • Provide the one entry point that every tick caller routes through, so the batched parallel path and the single-agent test/sample path can never diverge.

Does NOT:

  • Schedule jobs or touch ECS: that isBehaviorTickSystem.
  • Allocate managed garbage on the hot path.

CancelAndReset(ref BehaviorRuntimeInstance instance, BakedBehaviorArtifact artifact, uint randomSeed, EntityId entityId, int frameNumber, NativeArray<BehaviorActionRuntimeState> actionStates, NativeArray<BehaviorNodeExecutionStatus> nodeExecutionStatuses, NativeArray<BehaviorStateSuspensionFrame> suspensionFrames, NativeArray<BehaviorActionRuntimeState> suspendedActionStates, NativeQueue<ExternalServiceCommand>.ParallelWriter commandWriter)

Section titled “CancelAndReset(ref BehaviorRuntimeInstance instance, BakedBehaviorArtifact artifact, uint randomSeed, EntityId entityId, int frameNumber, NativeArray<BehaviorActionRuntimeState> actionStates, NativeArray<BehaviorNodeExecutionStatus> nodeExecutionStatuses, NativeArray<BehaviorStateSuspensionFrame> suspensionFrames, NativeArray<BehaviorActionRuntimeState> suspendedActionStates, NativeQueue<ExternalServiceCommand>.ParallelWriter commandWriter)”
C#
public static void CancelAndReset(ref BitQuirky.Behavior.Execution.BehaviorRuntimeInstance instance, BitQuirky.Behavior.Baked.BakedBehaviorArtifact artifact, uint randomSeed, UnityEngine.EntityId entityId, int frameNumber, Unity.Collections.NativeArray<BitQuirky.Behavior.Execution.BehaviorActionRuntimeState> actionStates, Unity.Collections.NativeArray<BitQuirky.Behavior.Diagnostics.BehaviorNodeExecutionStatus> nodeExecutionStatuses, Unity.Collections.NativeArray<BitQuirky.Behavior.Execution.BehaviorStateSuspensionFrame> suspensionFrames, Unity.Collections.NativeArray<BitQuirky.Behavior.Execution.BehaviorActionRuntimeState> suspendedActionStates, Unity.Collections.NativeQueue<BitQuirky.Behavior.ExternalService.ExternalServiceCommand>.ParallelWriter commandWriter)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorTickCore.cs:1015-1060

Cancel fixed, active-action, and suspended pending operations, then restore a fresh instance.

GetImmediateMemberDrainLimit(int executionStepLimit, int transitionMemberConditionCount)

Section titled “GetImmediateMemberDrainLimit(int executionStepLimit, int transitionMemberConditionCount)”
C#
public static int GetImmediateMemberDrainLimit(int executionStepLimit, int transitionMemberConditionCount)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorTickCore.cs:351-357

Bounds an immediate-member drain independently of the kernel’s node-walk budget. Each authored member transition predicate can request one additional observation; repeated references to the same binding still count as separate predicate rows. Uses the baked inventory, including materialized legacy caches, without scanning it.

MarkInterruptedActionStatuses(NativeArray<BehaviorActionRuntimeState> actionStates, NativeArray<BehaviorNodeExecutionStatus> nodeExecutionStatuses)

Section titled “MarkInterruptedActionStatuses(NativeArray<BehaviorActionRuntimeState> actionStates, NativeArray<BehaviorNodeExecutionStatus> nodeExecutionStatuses)”
C#
public static void MarkInterruptedActionStatuses(Unity.Collections.NativeArray<BitQuirky.Behavior.Execution.BehaviorActionRuntimeState> actionStates, Unity.Collections.NativeArray<BitQuirky.Behavior.Diagnostics.BehaviorNodeExecutionStatus> nodeExecutionStatuses)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorTickCore.cs:980-996

Projects interrupted action rows onto the persistent per-node Live status.

MarkRunningNodesCanceled(NativeArray<BehaviorNodeExecutionStatus> statuses)

Section titled “MarkRunningNodesCanceled(NativeArray<BehaviorNodeExecutionStatus> statuses)”
C#
public static void MarkRunningNodesCanceled(Unity.Collections.NativeArray<BitQuirky.Behavior.Diagnostics.BehaviorNodeExecutionStatus> statuses)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorTickCore.cs:999-1009

Retains cancellation evidence for the entire active execution path.

ResetActionStates(NativeArray<BehaviorActionRuntimeState> actionStates)

Section titled “ResetActionStates(NativeArray<BehaviorActionRuntimeState> actionStates)”
C#
public static void ResetActionStates(Unity.Collections.NativeArray<BitQuirky.Behavior.Execution.BehaviorActionRuntimeState> actionStates)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorTickCore.cs:925-935

Clears every per-action row while retaining host-owned native storage.

ResetExecutionStatuses(ref BehaviorRuntimeInstance instance, NativeArray<BehaviorNodeExecutionStatus> nodeExecutionStatuses)

Section titled “ResetExecutionStatuses(ref BehaviorRuntimeInstance instance, NativeArray<BehaviorNodeExecutionStatus> nodeExecutionStatuses)”
C#
public static void ResetExecutionStatuses(ref BitQuirky.Behavior.Execution.BehaviorRuntimeInstance instance, Unity.Collections.NativeArray<BitQuirky.Behavior.Diagnostics.BehaviorNodeExecutionStatus> nodeExecutionStatuses)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorTickCore.cs:868-880

Restore a persistent node-status vector and deepest cursor to their fresh state.

ResetLiveValueOverlayStates(NativeArray<BehaviorLiveValueOverlayRuntimeState> liveValueOverlayStates)

Section titled “ResetLiveValueOverlayStates(NativeArray<BehaviorLiveValueOverlayRuntimeState> liveValueOverlayStates)”
C#
public static void ResetLiveValueOverlayStates(Unity.Collections.NativeArray<BitQuirky.Behavior.Execution.BehaviorLiveValueOverlayRuntimeState> liveValueOverlayStates)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorTickCore.cs:938-949

Clears every per-slot live-value overlay when a graph instance resets.

ResetProbabilityStates(NativeArray<BehaviorProbabilityRuntimeState> states)

Section titled “ResetProbabilityStates(NativeArray<BehaviorProbabilityRuntimeState> states)”
C#
public static void ResetProbabilityStates(Unity.Collections.NativeArray<BitQuirky.Behavior.Execution.BehaviorProbabilityRuntimeState> states)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorTickCore.cs:911-915

Clears every weighted-selector activation while retaining host-owned storage.

ResetReferenceStates(NativeArray<BehaviorReferenceRuntimeState> referenceStates)

Section titled “ResetReferenceStates(NativeArray<BehaviorReferenceRuntimeState> referenceStates)”
C#
public static void ResetReferenceStates(Unity.Collections.NativeArray<BitQuirky.Behavior.Execution.BehaviorReferenceRuntimeState> referenceStates)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorTickCore.cs:952-963

Restores every retained reference reading to its outside sentinel.

ResetRepeatStates(NativeArray<BehaviorRepeatRuntimeState> repeatStates)

Section titled “ResetRepeatStates(NativeArray<BehaviorRepeatRuntimeState> repeatStates)”
C#
public static void ResetRepeatStates(Unity.Collections.NativeArray<BitQuirky.Behavior.Execution.BehaviorRepeatRuntimeState> repeatStates)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorTickCore.cs:897-908

Clears every per-decorator attempt count when a graph instance resets.

ResetTimeLimitStates(NativeArray<BehaviorTimeLimitRuntimeState> timeLimitStates)

Section titled “ResetTimeLimitStates(NativeArray<BehaviorTimeLimitRuntimeState> timeLimitStates)”
C#
public static void ResetTimeLimitStates(Unity.Collections.NativeArray<BitQuirky.Behavior.Execution.BehaviorTimeLimitRuntimeState> timeLimitStates)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorTickCore.cs:883-894

Clears every per-decorator elapsed clock when a graph instance resets.

ResetTransitionConditionStates(NativeArray<BehaviorTransitionConditionRuntimeState> states)

Section titled “ResetTransitionConditionStates(NativeArray<BehaviorTransitionConditionRuntimeState> states)”
C#
public static void ResetTransitionConditionStates(Unity.Collections.NativeArray<BitQuirky.Behavior.Execution.BehaviorTransitionConditionRuntimeState> states)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorTickCore.cs:918-922

Clears every same-tick transition predicate observation on graph reset.

ResetUtilityBranchScores(NativeArray<BehaviorUtilityBranchScore> utilityBranchScores)

Section titled “ResetUtilityBranchScores(NativeArray<BehaviorUtilityBranchScore> utilityBranchScores)”
C#
public static void ResetUtilityBranchScores(Unity.Collections.NativeArray<BitQuirky.Behavior.Diagnostics.BehaviorUtilityBranchScore> utilityBranchScores)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorTickCore.cs:966-977

Clears every branch’s score, active flag, commitment, and evaluated flag when a graph instance resets.

SeedHostedBlackboard(NativeArray<BakedBlackboardSlot> hostLayout, NativeArray<byte> hostBlackboard, NativeArray<BakedBlackboardSlot> hostedLayout, NativeArray<byte> hostedBlackboard)

Section titled “SeedHostedBlackboard(NativeArray<BakedBlackboardSlot> hostLayout, NativeArray<byte> hostBlackboard, NativeArray<BakedBlackboardSlot> hostedLayout, NativeArray<byte> hostedBlackboard)”
C#
public static void SeedHostedBlackboard(Unity.Collections.NativeArray<BitQuirky.Behavior.Baked.BakedBlackboardSlot> hostLayout, Unity.Collections.NativeArray<byte> hostBlackboard, Unity.Collections.NativeArray<BitQuirky.Behavior.Baked.BakedBlackboardSlot> hostedLayout, Unity.Collections.NativeArray<byte> hostedBlackboard)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorTickCore.cs:833-863

Copies, once, every blackboard field declared with the same stable name hash and the sameBakedFieldTypeCode on both layouts from hostBlackboard into hostedBlackboard(FSM-013, research.md R3; data-model.md entity 4): the mechanism that carries a recorded input, such as a last-known position, into a freshly materialized hosted instance with no new baked row. A field declared on only one side keeps its own declared default.

TickOne(ref BehaviorRuntimeInstance instance, NativeArray<byte> blackboard, in BehaviorTickBakedInput baked, EntityId entityId, int frameNumber, float deltaSeconds, in AuthorityContext executingContext, NativeArray<ExternalServiceCompletionRecord> completionRingSnapshot, NativeQueue<ExternalServiceCommand>.ParallelWriter commandWriter)

Section titled “TickOne(ref BehaviorRuntimeInstance instance, NativeArray<byte> blackboard, in BehaviorTickBakedInput baked, EntityId entityId, int frameNumber, float deltaSeconds, in AuthorityContext executingContext, NativeArray<ExternalServiceCompletionRecord> completionRingSnapshot, NativeQueue<ExternalServiceCommand>.ParallelWriter commandWriter)”
C#
public static BitQuirky.Behavior.Execution.BehaviorTickStepResult TickOne(ref BitQuirky.Behavior.Execution.BehaviorRuntimeInstance instance, Unity.Collections.NativeArray<byte> blackboard, in BitQuirky.Behavior.Execution.BehaviorTickBakedInput baked, UnityEngine.EntityId entityId, int frameNumber, float deltaSeconds, in BitQuirky.Behavior.Authority.AuthorityContext executingContext, Unity.Collections.NativeArray<BitQuirky.Behavior.ExternalService.ExternalServiceCompletionRecord> completionRingSnapshot, Unity.Collections.NativeQueue<BitQuirky.Behavior.ExternalService.ExternalServiceCommand>.ParallelWriter commandWriter)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorTickCore.cs:366-390

Advance one agent by a single tick step. The blackboard is read and written in place (no per-agent temporary allocation); the runtime instance is updated through theinstanceref. Commands are appended tocommandWriterand command ids are reserved from the owning runtime instance.

TickOne(ref BehaviorRuntimeInstance instance, NativeArray<byte> blackboard, NativeArray<BehaviorNodeExecutionStatus> nodeExecutionStatuses, in BehaviorTickBakedInput baked, EntityId entityId, int frameNumber, float deltaSeconds, in AuthorityContext executingContext, NativeArray<ExternalServiceCompletionRecord> completionRingSnapshot, NativeQueue<ExternalServiceCommand>.ParallelWriter commandWriter)

Section titled “TickOne(ref BehaviorRuntimeInstance instance, NativeArray<byte> blackboard, NativeArray<BehaviorNodeExecutionStatus> nodeExecutionStatuses, in BehaviorTickBakedInput baked, EntityId entityId, int frameNumber, float deltaSeconds, in AuthorityContext executingContext, NativeArray<ExternalServiceCompletionRecord> completionRingSnapshot, NativeQueue<ExternalServiceCommand>.ParallelWriter commandWriter)”
C#
public static BitQuirky.Behavior.Execution.BehaviorTickStepResult TickOne(ref BitQuirky.Behavior.Execution.BehaviorRuntimeInstance instance, Unity.Collections.NativeArray<byte> blackboard, Unity.Collections.NativeArray<BitQuirky.Behavior.Diagnostics.BehaviorNodeExecutionStatus> nodeExecutionStatuses, in BitQuirky.Behavior.Execution.BehaviorTickBakedInput baked, UnityEngine.EntityId entityId, int frameNumber, float deltaSeconds, in BitQuirky.Behavior.Authority.AuthorityContext executingContext, Unity.Collections.NativeArray<BitQuirky.Behavior.ExternalService.ExternalServiceCompletionRecord> completionRingSnapshot, Unity.Collections.NativeQueue<BitQuirky.Behavior.ExternalService.ExternalServiceCommand>.ParallelWriter commandWriter)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorTickCore.cs:395-420

Advance one agent and retain the latest collapsed status for each baked node.

TickOne(ref BehaviorRuntimeInstance instance, NativeArray<byte> blackboard, NativeArray<ReactiveConditionRuntimeState> reactiveConditionStates, in BehaviorTickBakedInput baked, EntityId entityId, int frameNumber, float deltaSeconds, in AuthorityContext executingContext, NativeArray<ExternalServiceCompletionRecord> completionRingSnapshot, NativeQueue<ExternalServiceCommand>.ParallelWriter commandWriter)

Section titled “TickOne(ref BehaviorRuntimeInstance instance, NativeArray<byte> blackboard, NativeArray<ReactiveConditionRuntimeState> reactiveConditionStates, in BehaviorTickBakedInput baked, EntityId entityId, int frameNumber, float deltaSeconds, in AuthorityContext executingContext, NativeArray<ExternalServiceCompletionRecord> completionRingSnapshot, NativeQueue<ExternalServiceCommand>.ParallelWriter commandWriter)”
C#
public static BitQuirky.Behavior.Execution.BehaviorTickStepResult TickOne(ref BitQuirky.Behavior.Execution.BehaviorRuntimeInstance instance, Unity.Collections.NativeArray<byte> blackboard, Unity.Collections.NativeArray<BitQuirky.Behavior.Execution.ReactiveConditionRuntimeState> reactiveConditionStates, in BitQuirky.Behavior.Execution.BehaviorTickBakedInput baked, UnityEngine.EntityId entityId, int frameNumber, float deltaSeconds, in BitQuirky.Behavior.Authority.AuthorityContext executingContext, Unity.Collections.NativeArray<BitQuirky.Behavior.ExternalService.ExternalServiceCompletionRecord> completionRingSnapshot, Unity.Collections.NativeQueue<BitQuirky.Behavior.ExternalService.ExternalServiceCommand>.ParallelWriter commandWriter)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorTickCore.cs:425-450

Advance one agent with persistent artifact-indexed reactive condition state.

TickOne(ref BehaviorRuntimeInstance instance, NativeArray<byte> blackboard, NativeArray<ReactiveConditionRuntimeState> reactiveConditionStates, NativeArray<BehaviorNodeExecutionStatus> nodeExecutionStatuses, in BehaviorTickBakedInput baked, EntityId entityId, int frameNumber, float deltaSeconds, in AuthorityContext executingContext, NativeArray<ExternalServiceCompletionRecord> completionRingSnapshot, NativeQueue<ExternalServiceCommand>.ParallelWriter commandWriter)

Section titled “TickOne(ref BehaviorRuntimeInstance instance, NativeArray<byte> blackboard, NativeArray<ReactiveConditionRuntimeState> reactiveConditionStates, NativeArray<BehaviorNodeExecutionStatus> nodeExecutionStatuses, in BehaviorTickBakedInput baked, EntityId entityId, int frameNumber, float deltaSeconds, in AuthorityContext executingContext, NativeArray<ExternalServiceCompletionRecord> completionRingSnapshot, NativeQueue<ExternalServiceCommand>.ParallelWriter commandWriter)”
C#
public static BitQuirky.Behavior.Execution.BehaviorTickStepResult TickOne(ref BitQuirky.Behavior.Execution.BehaviorRuntimeInstance instance, Unity.Collections.NativeArray<byte> blackboard, Unity.Collections.NativeArray<BitQuirky.Behavior.Execution.ReactiveConditionRuntimeState> reactiveConditionStates, Unity.Collections.NativeArray<BitQuirky.Behavior.Diagnostics.BehaviorNodeExecutionStatus> nodeExecutionStatuses, in BitQuirky.Behavior.Execution.BehaviorTickBakedInput baked, UnityEngine.EntityId entityId, int frameNumber, float deltaSeconds, in BitQuirky.Behavior.Authority.AuthorityContext executingContext, Unity.Collections.NativeArray<BitQuirky.Behavior.ExternalService.ExternalServiceCompletionRecord> completionRingSnapshot, Unity.Collections.NativeQueue<BitQuirky.Behavior.ExternalService.ExternalServiceCommand>.ParallelWriter commandWriter)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorTickCore.cs:455-481

Advance one agent with persistent reactive state and node execution statuses.

TickOne(ref BehaviorRuntimeInstance instance, NativeArray<byte> blackboard, NativeArray<ReactiveConditionRuntimeState> reactiveConditionStates, NativeArray<BehaviorNodeExecutionStatus> nodeExecutionStatuses, NativeArray<BehaviorRepeatRuntimeState> repeatStates, NativeArray<BehaviorTimeLimitRuntimeState> timeLimitStates, in BehaviorTickBakedInput baked, EntityId entityId, int frameNumber, float deltaSeconds, in AuthorityContext executingContext, NativeArray<ExternalServiceCompletionRecord> completionRingSnapshot, NativeQueue<ExternalServiceCommand>.ParallelWriter commandWriter)

Section titled “TickOne(ref BehaviorRuntimeInstance instance, NativeArray<byte> blackboard, NativeArray<ReactiveConditionRuntimeState> reactiveConditionStates, NativeArray<BehaviorNodeExecutionStatus> nodeExecutionStatuses, NativeArray<BehaviorRepeatRuntimeState> repeatStates, NativeArray<BehaviorTimeLimitRuntimeState> timeLimitStates, in BehaviorTickBakedInput baked, EntityId entityId, int frameNumber, float deltaSeconds, in AuthorityContext executingContext, NativeArray<ExternalServiceCompletionRecord> completionRingSnapshot, NativeQueue<ExternalServiceCommand>.ParallelWriter commandWriter)”
C#
public static BitQuirky.Behavior.Execution.BehaviorTickStepResult TickOne(ref BitQuirky.Behavior.Execution.BehaviorRuntimeInstance instance, Unity.Collections.NativeArray<byte> blackboard, Unity.Collections.NativeArray<BitQuirky.Behavior.Execution.ReactiveConditionRuntimeState> reactiveConditionStates, Unity.Collections.NativeArray<BitQuirky.Behavior.Diagnostics.BehaviorNodeExecutionStatus> nodeExecutionStatuses, Unity.Collections.NativeArray<BitQuirky.Behavior.Execution.BehaviorRepeatRuntimeState> repeatStates, Unity.Collections.NativeArray<BitQuirky.Behavior.Execution.BehaviorTimeLimitRuntimeState> timeLimitStates, in BitQuirky.Behavior.Execution.BehaviorTickBakedInput baked, UnityEngine.EntityId entityId, int frameNumber, float deltaSeconds, in BitQuirky.Behavior.Authority.AuthorityContext executingContext, Unity.Collections.NativeArray<BitQuirky.Behavior.ExternalService.ExternalServiceCompletionRecord> completionRingSnapshot, Unity.Collections.NativeQueue<BitQuirky.Behavior.ExternalService.ExternalServiceCommand>.ParallelWriter commandWriter)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorTickCore.cs:520-550

Advance one agent with persistent reactive, execution-status, Repeat, and Time Limit state.

TickOne(ref BehaviorRuntimeInstance instance, NativeArray<byte> blackboard, NativeArray<ReactiveConditionRuntimeState> reactiveConditionStates, NativeArray<BehaviorNodeExecutionStatus> nodeExecutionStatuses, NativeArray<BehaviorRepeatRuntimeState> repeatStates, NativeArray<BehaviorTimeLimitRuntimeState> timeLimitStates, NativeArray<BehaviorActionRuntimeState> actionStates, in BehaviorTickBakedInput baked, EntityId entityId, int frameNumber, float deltaSeconds, in AuthorityContext executingContext, NativeArray<ExternalServiceCompletionRecord> completionRingSnapshot, NativeQueue<ExternalServiceCommand>.ParallelWriter commandWriter)

Section titled “TickOne(ref BehaviorRuntimeInstance instance, NativeArray<byte> blackboard, NativeArray<ReactiveConditionRuntimeState> reactiveConditionStates, NativeArray<BehaviorNodeExecutionStatus> nodeExecutionStatuses, NativeArray<BehaviorRepeatRuntimeState> repeatStates, NativeArray<BehaviorTimeLimitRuntimeState> timeLimitStates, NativeArray<BehaviorActionRuntimeState> actionStates, in BehaviorTickBakedInput baked, EntityId entityId, int frameNumber, float deltaSeconds, in AuthorityContext executingContext, NativeArray<ExternalServiceCompletionRecord> completionRingSnapshot, NativeQueue<ExternalServiceCommand>.ParallelWriter commandWriter)”
C#
public static BitQuirky.Behavior.Execution.BehaviorTickStepResult TickOne(ref BitQuirky.Behavior.Execution.BehaviorRuntimeInstance instance, Unity.Collections.NativeArray<byte> blackboard, Unity.Collections.NativeArray<BitQuirky.Behavior.Execution.ReactiveConditionRuntimeState> reactiveConditionStates, Unity.Collections.NativeArray<BitQuirky.Behavior.Diagnostics.BehaviorNodeExecutionStatus> nodeExecutionStatuses, Unity.Collections.NativeArray<BitQuirky.Behavior.Execution.BehaviorRepeatRuntimeState> repeatStates, Unity.Collections.NativeArray<BitQuirky.Behavior.Execution.BehaviorTimeLimitRuntimeState> timeLimitStates, Unity.Collections.NativeArray<BitQuirky.Behavior.Execution.BehaviorActionRuntimeState> actionStates, in BitQuirky.Behavior.Execution.BehaviorTickBakedInput baked, UnityEngine.EntityId entityId, int frameNumber, float deltaSeconds, in BitQuirky.Behavior.Authority.AuthorityContext executingContext, Unity.Collections.NativeArray<BitQuirky.Behavior.ExternalService.ExternalServiceCompletionRecord> completionRingSnapshot, Unity.Collections.NativeQueue<BitQuirky.Behavior.ExternalService.ExternalServiceCommand>.ParallelWriter commandWriter)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorTickCore.cs:555-589

Advance one agent with every persistent runtime table, including direct state actions.

TickOne(ref BehaviorRuntimeInstance instance, NativeArray<byte> blackboard, NativeArray<ReactiveConditionRuntimeState> reactiveConditionStates, NativeArray<BehaviorNodeExecutionStatus> nodeExecutionStatuses, NativeArray<BehaviorRepeatRuntimeState> repeatStates, NativeArray<BehaviorTimeLimitRuntimeState> timeLimitStates, NativeArray<BehaviorActionRuntimeState> actionStates, NativeArray<BehaviorStateSuspensionFrame> suspensionFrames, NativeArray<BehaviorActionRuntimeState> suspendedActionStates, NativeArray<BehaviorReferenceRuntimeState> referenceStates, in BehaviorTickBakedInput baked, EntityId entityId, int frameNumber, float deltaSeconds, in AuthorityContext executingContext, NativeArray<ExternalServiceCompletionRecord> completionRingSnapshot, NativeQueue<ExternalServiceCommand>.ParallelWriter commandWriter, NativeArray<BehaviorUtilityBranchScore> utilityBranchScores, NativeArray<BehaviorProbabilityRuntimeState> probabilityStates, NativeArray<BehaviorTransitionConditionRuntimeState> transitionConditionStates, BehaviorTickInvocationKind invocationKind)

Section titled “TickOne(ref BehaviorRuntimeInstance instance, NativeArray<byte> blackboard, NativeArray<ReactiveConditionRuntimeState> reactiveConditionStates, NativeArray<BehaviorNodeExecutionStatus> nodeExecutionStatuses, NativeArray<BehaviorRepeatRuntimeState> repeatStates, NativeArray<BehaviorTimeLimitRuntimeState> timeLimitStates, NativeArray<BehaviorActionRuntimeState> actionStates, NativeArray<BehaviorStateSuspensionFrame> suspensionFrames, NativeArray<BehaviorActionRuntimeState> suspendedActionStates, NativeArray<BehaviorReferenceRuntimeState> referenceStates, in BehaviorTickBakedInput baked, EntityId entityId, int frameNumber, float deltaSeconds, in AuthorityContext executingContext, NativeArray<ExternalServiceCompletionRecord> completionRingSnapshot, NativeQueue<ExternalServiceCommand>.ParallelWriter commandWriter, NativeArray<BehaviorUtilityBranchScore> utilityBranchScores, NativeArray<BehaviorProbabilityRuntimeState> probabilityStates, NativeArray<BehaviorTransitionConditionRuntimeState> transitionConditionStates, BehaviorTickInvocationKind invocationKind)”
C#
public static BitQuirky.Behavior.Execution.BehaviorTickStepResult TickOne(ref BitQuirky.Behavior.Execution.BehaviorRuntimeInstance instance, Unity.Collections.NativeArray<byte> blackboard, Unity.Collections.NativeArray<BitQuirky.Behavior.Execution.ReactiveConditionRuntimeState> reactiveConditionStates, Unity.Collections.NativeArray<BitQuirky.Behavior.Diagnostics.BehaviorNodeExecutionStatus> nodeExecutionStatuses, Unity.Collections.NativeArray<BitQuirky.Behavior.Execution.BehaviorRepeatRuntimeState> repeatStates, Unity.Collections.NativeArray<BitQuirky.Behavior.Execution.BehaviorTimeLimitRuntimeState> timeLimitStates, Unity.Collections.NativeArray<BitQuirky.Behavior.Execution.BehaviorActionRuntimeState> actionStates, Unity.Collections.NativeArray<BitQuirky.Behavior.Execution.BehaviorStateSuspensionFrame> suspensionFrames, Unity.Collections.NativeArray<BitQuirky.Behavior.Execution.BehaviorActionRuntimeState> suspendedActionStates, Unity.Collections.NativeArray<BitQuirky.Behavior.Execution.BehaviorReferenceRuntimeState> referenceStates, in BitQuirky.Behavior.Execution.BehaviorTickBakedInput baked, UnityEngine.EntityId entityId, int frameNumber, float deltaSeconds, in BitQuirky.Behavior.Authority.AuthorityContext executingContext, Unity.Collections.NativeArray<BitQuirky.Behavior.ExternalService.ExternalServiceCompletionRecord> completionRingSnapshot, Unity.Collections.NativeQueue<BitQuirky.Behavior.ExternalService.ExternalServiceCommand>.ParallelWriter commandWriter, Unity.Collections.NativeArray<BitQuirky.Behavior.Diagnostics.BehaviorUtilityBranchScore> utilityBranchScores = default(Unity.Collections.NativeArray<BitQuirky.Behavior.Diagnostics.BehaviorUtilityBranchScore>), Unity.Collections.NativeArray<BitQuirky.Behavior.Execution.BehaviorProbabilityRuntimeState> probabilityStates = default(Unity.Collections.NativeArray<BitQuirky.Behavior.Execution.BehaviorProbabilityRuntimeState>), Unity.Collections.NativeArray<BitQuirky.Behavior.Execution.BehaviorTransitionConditionRuntimeState> transitionConditionStates = default(Unity.Collections.NativeArray<BitQuirky.Behavior.Execution.BehaviorTransitionConditionRuntimeState>), BitQuirky.Behavior.Execution.BehaviorTickInvocationKind invocationKind = Automatic)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorTickCore.cs:592-638

Advance one agent with preallocated Push suspension storage.

TickOne(ref BehaviorRuntimeInstance instance, NativeArray<byte> blackboard, NativeArray<ReactiveConditionRuntimeState> reactiveConditionStates, NativeArray<BehaviorNodeExecutionStatus> nodeExecutionStatuses, NativeArray<BehaviorRepeatRuntimeState> repeatStates, NativeArray<BehaviorTimeLimitRuntimeState> timeLimitStates, NativeArray<BehaviorActionRuntimeState> actionStates, NativeArray<BehaviorStateSuspensionFrame> suspensionFrames, NativeArray<BehaviorActionRuntimeState> suspendedActionStates, NativeArray<BehaviorReferenceRuntimeState> referenceStates, NativeArray<BehaviorLiveValueOverlayRuntimeState> liveValueOverlayStates, in BehaviorTickBakedInput baked, EntityId entityId, int frameNumber, float deltaSeconds, in AuthorityContext executingContext, NativeArray<ExternalServiceCompletionRecord> completionRingSnapshot, NativeQueue<ExternalServiceCommand>.ParallelWriter commandWriter, NativeArray<BehaviorUtilityBranchScore> utilityBranchScores, NativeArray<BehaviorProbabilityRuntimeState> probabilityStates, NativeArray<BehaviorTransitionConditionRuntimeState> transitionConditionStates, BehaviorTickInvocationKind invocationKind)

Section titled “TickOne(ref BehaviorRuntimeInstance instance, NativeArray<byte> blackboard, NativeArray<ReactiveConditionRuntimeState> reactiveConditionStates, NativeArray<BehaviorNodeExecutionStatus> nodeExecutionStatuses, NativeArray<BehaviorRepeatRuntimeState> repeatStates, NativeArray<BehaviorTimeLimitRuntimeState> timeLimitStates, NativeArray<BehaviorActionRuntimeState> actionStates, NativeArray<BehaviorStateSuspensionFrame> suspensionFrames, NativeArray<BehaviorActionRuntimeState> suspendedActionStates, NativeArray<BehaviorReferenceRuntimeState> referenceStates, NativeArray<BehaviorLiveValueOverlayRuntimeState> liveValueOverlayStates, in BehaviorTickBakedInput baked, EntityId entityId, int frameNumber, float deltaSeconds, in AuthorityContext executingContext, NativeArray<ExternalServiceCompletionRecord> completionRingSnapshot, NativeQueue<ExternalServiceCommand>.ParallelWriter commandWriter, NativeArray<BehaviorUtilityBranchScore> utilityBranchScores, NativeArray<BehaviorProbabilityRuntimeState> probabilityStates, NativeArray<BehaviorTransitionConditionRuntimeState> transitionConditionStates, BehaviorTickInvocationKind invocationKind)”
C#
public static BitQuirky.Behavior.Execution.BehaviorTickStepResult TickOne(ref BitQuirky.Behavior.Execution.BehaviorRuntimeInstance instance, Unity.Collections.NativeArray<byte> blackboard, Unity.Collections.NativeArray<BitQuirky.Behavior.Execution.ReactiveConditionRuntimeState> reactiveConditionStates, Unity.Collections.NativeArray<BitQuirky.Behavior.Diagnostics.BehaviorNodeExecutionStatus> nodeExecutionStatuses, Unity.Collections.NativeArray<BitQuirky.Behavior.Execution.BehaviorRepeatRuntimeState> repeatStates, Unity.Collections.NativeArray<BitQuirky.Behavior.Execution.BehaviorTimeLimitRuntimeState> timeLimitStates, Unity.Collections.NativeArray<BitQuirky.Behavior.Execution.BehaviorActionRuntimeState> actionStates, Unity.Collections.NativeArray<BitQuirky.Behavior.Execution.BehaviorStateSuspensionFrame> suspensionFrames, Unity.Collections.NativeArray<BitQuirky.Behavior.Execution.BehaviorActionRuntimeState> suspendedActionStates, Unity.Collections.NativeArray<BitQuirky.Behavior.Execution.BehaviorReferenceRuntimeState> referenceStates, Unity.Collections.NativeArray<BitQuirky.Behavior.Execution.BehaviorLiveValueOverlayRuntimeState> liveValueOverlayStates, in BitQuirky.Behavior.Execution.BehaviorTickBakedInput baked, UnityEngine.EntityId entityId, int frameNumber, float deltaSeconds, in BitQuirky.Behavior.Authority.AuthorityContext executingContext, Unity.Collections.NativeArray<BitQuirky.Behavior.ExternalService.ExternalServiceCompletionRecord> completionRingSnapshot, Unity.Collections.NativeQueue<BitQuirky.Behavior.ExternalService.ExternalServiceCommand>.ParallelWriter commandWriter, Unity.Collections.NativeArray<BitQuirky.Behavior.Diagnostics.BehaviorUtilityBranchScore> utilityBranchScores = default(Unity.Collections.NativeArray<BitQuirky.Behavior.Diagnostics.BehaviorUtilityBranchScore>), Unity.Collections.NativeArray<BitQuirky.Behavior.Execution.BehaviorProbabilityRuntimeState> probabilityStates = default(Unity.Collections.NativeArray<BitQuirky.Behavior.Execution.BehaviorProbabilityRuntimeState>), Unity.Collections.NativeArray<BitQuirky.Behavior.Execution.BehaviorTransitionConditionRuntimeState> transitionConditionStates = default(Unity.Collections.NativeArray<BitQuirky.Behavior.Execution.BehaviorTransitionConditionRuntimeState>), BitQuirky.Behavior.Execution.BehaviorTickInvocationKind invocationKind = Automatic)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorTickCore.cs:645-728

Advance one agent with every persistent runtime table, including the per-instance live-value overlay a developer’s accepted edit writes into , and every baked Utility Selector branch’s current score.

TickOne(ref BehaviorRuntimeInstance instance, NativeArray<byte> blackboard, NativeArray<ReactiveConditionRuntimeState> reactiveConditionStates, NativeArray<BehaviorNodeExecutionStatus> nodeExecutionStatuses, NativeArray<BehaviorRepeatRuntimeState> repeatStates, NativeArray<BehaviorTimeLimitRuntimeState> timeLimitStates, NativeArray<BehaviorActionRuntimeState> actionStates, NativeArray<BehaviorStateSuspensionFrame> suspensionFrames, NativeArray<BehaviorActionRuntimeState> suspendedActionStates, NativeArray<BehaviorReferenceRuntimeState> referenceStates, NativeArray<BehaviorLiveValueOverlayRuntimeState> liveValueOverlayStates, in BehaviorTickBakedInput baked, EntityId entityId, int frameNumber, float deltaSeconds, in AuthorityContext executingContext, NativeArray<ExternalServiceCompletionRecord> completionRingSnapshot, NativeQueue<ExternalServiceCommand>.ParallelWriter commandWriter, NativeArray<BehaviorUtilityBranchScore> utilityBranchScores, NativeArray<BehaviorRuntimeInstance> hostedStateMachineInstance, NativeArray<int> hostedStateMachineOwningNodeIndex, NativeArray<BehaviorProbabilityRuntimeState> probabilityStates, NativeArray<BehaviorTransitionConditionRuntimeState> transitionConditionStates, BehaviorTickInvocationKind invocationKind)

Section titled “TickOne(ref BehaviorRuntimeInstance instance, NativeArray<byte> blackboard, NativeArray<ReactiveConditionRuntimeState> reactiveConditionStates, NativeArray<BehaviorNodeExecutionStatus> nodeExecutionStatuses, NativeArray<BehaviorRepeatRuntimeState> repeatStates, NativeArray<BehaviorTimeLimitRuntimeState> timeLimitStates, NativeArray<BehaviorActionRuntimeState> actionStates, NativeArray<BehaviorStateSuspensionFrame> suspensionFrames, NativeArray<BehaviorActionRuntimeState> suspendedActionStates, NativeArray<BehaviorReferenceRuntimeState> referenceStates, NativeArray<BehaviorLiveValueOverlayRuntimeState> liveValueOverlayStates, in BehaviorTickBakedInput baked, EntityId entityId, int frameNumber, float deltaSeconds, in AuthorityContext executingContext, NativeArray<ExternalServiceCompletionRecord> completionRingSnapshot, NativeQueue<ExternalServiceCommand>.ParallelWriter commandWriter, NativeArray<BehaviorUtilityBranchScore> utilityBranchScores, NativeArray<BehaviorRuntimeInstance> hostedStateMachineInstance, NativeArray<int> hostedStateMachineOwningNodeIndex, NativeArray<BehaviorProbabilityRuntimeState> probabilityStates, NativeArray<BehaviorTransitionConditionRuntimeState> transitionConditionStates, BehaviorTickInvocationKind invocationKind)”
C#
public static BitQuirky.Behavior.Execution.BehaviorTickStepResult TickOne(ref BitQuirky.Behavior.Execution.BehaviorRuntimeInstance instance, Unity.Collections.NativeArray<byte> blackboard, Unity.Collections.NativeArray<BitQuirky.Behavior.Execution.ReactiveConditionRuntimeState> reactiveConditionStates, Unity.Collections.NativeArray<BitQuirky.Behavior.Diagnostics.BehaviorNodeExecutionStatus> nodeExecutionStatuses, Unity.Collections.NativeArray<BitQuirky.Behavior.Execution.BehaviorRepeatRuntimeState> repeatStates, Unity.Collections.NativeArray<BitQuirky.Behavior.Execution.BehaviorTimeLimitRuntimeState> timeLimitStates, Unity.Collections.NativeArray<BitQuirky.Behavior.Execution.BehaviorActionRuntimeState> actionStates, Unity.Collections.NativeArray<BitQuirky.Behavior.Execution.BehaviorStateSuspensionFrame> suspensionFrames, Unity.Collections.NativeArray<BitQuirky.Behavior.Execution.BehaviorActionRuntimeState> suspendedActionStates, Unity.Collections.NativeArray<BitQuirky.Behavior.Execution.BehaviorReferenceRuntimeState> referenceStates, Unity.Collections.NativeArray<BitQuirky.Behavior.Execution.BehaviorLiveValueOverlayRuntimeState> liveValueOverlayStates, in BitQuirky.Behavior.Execution.BehaviorTickBakedInput baked, UnityEngine.EntityId entityId, int frameNumber, float deltaSeconds, in BitQuirky.Behavior.Authority.AuthorityContext executingContext, Unity.Collections.NativeArray<BitQuirky.Behavior.ExternalService.ExternalServiceCompletionRecord> completionRingSnapshot, Unity.Collections.NativeQueue<BitQuirky.Behavior.ExternalService.ExternalServiceCommand>.ParallelWriter commandWriter, Unity.Collections.NativeArray<BitQuirky.Behavior.Diagnostics.BehaviorUtilityBranchScore> utilityBranchScores, Unity.Collections.NativeArray<BitQuirky.Behavior.Execution.BehaviorRuntimeInstance> hostedStateMachineInstance, Unity.Collections.NativeArray<int> hostedStateMachineOwningNodeIndex, Unity.Collections.NativeArray<BitQuirky.Behavior.Execution.BehaviorProbabilityRuntimeState> probabilityStates = default(Unity.Collections.NativeArray<BitQuirky.Behavior.Execution.BehaviorProbabilityRuntimeState>), Unity.Collections.NativeArray<BitQuirky.Behavior.Execution.BehaviorTransitionConditionRuntimeState> transitionConditionStates = default(Unity.Collections.NativeArray<BitQuirky.Behavior.Execution.BehaviorTransitionConditionRuntimeState>), BitQuirky.Behavior.Execution.BehaviorTickInvocationKind invocationKind = Automatic)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorTickCore.cs:736-823

Advance one agent exactly as the primary overload does, additionally threading the one-slot hosted instance a Hosted State Machine node materializes (FSM-013). Callers with no such node pass empty arrays, which is exactly what every pre-existing caller of the primary overload keeps doing unchanged.

TickOne(ref BehaviorRuntimeInstance instance, NativeArray<byte> blackboard, NativeArray<ReactiveConditionRuntimeState> reactiveConditionStates, NativeArray<BehaviorNodeExecutionStatus> nodeExecutionStatuses, NativeArray<BehaviorTimeLimitRuntimeState> timeLimitStates, in BehaviorTickBakedInput baked, EntityId entityId, int frameNumber, float deltaSeconds, in AuthorityContext executingContext, NativeArray<ExternalServiceCompletionRecord> completionRingSnapshot, NativeQueue<ExternalServiceCommand>.ParallelWriter commandWriter)

Section titled “TickOne(ref BehaviorRuntimeInstance instance, NativeArray<byte> blackboard, NativeArray<ReactiveConditionRuntimeState> reactiveConditionStates, NativeArray<BehaviorNodeExecutionStatus> nodeExecutionStatuses, NativeArray<BehaviorTimeLimitRuntimeState> timeLimitStates, in BehaviorTickBakedInput baked, EntityId entityId, int frameNumber, float deltaSeconds, in AuthorityContext executingContext, NativeArray<ExternalServiceCompletionRecord> completionRingSnapshot, NativeQueue<ExternalServiceCommand>.ParallelWriter commandWriter)”
C#
public static BitQuirky.Behavior.Execution.BehaviorTickStepResult TickOne(ref BitQuirky.Behavior.Execution.BehaviorRuntimeInstance instance, Unity.Collections.NativeArray<byte> blackboard, Unity.Collections.NativeArray<BitQuirky.Behavior.Execution.ReactiveConditionRuntimeState> reactiveConditionStates, Unity.Collections.NativeArray<BitQuirky.Behavior.Diagnostics.BehaviorNodeExecutionStatus> nodeExecutionStatuses, Unity.Collections.NativeArray<BitQuirky.Behavior.Execution.BehaviorTimeLimitRuntimeState> timeLimitStates, in BitQuirky.Behavior.Execution.BehaviorTickBakedInput baked, UnityEngine.EntityId entityId, int frameNumber, float deltaSeconds, in BitQuirky.Behavior.Authority.AuthorityContext executingContext, Unity.Collections.NativeArray<BitQuirky.Behavior.ExternalService.ExternalServiceCompletionRecord> completionRingSnapshot, Unity.Collections.NativeQueue<BitQuirky.Behavior.ExternalService.ExternalServiceCommand>.ParallelWriter commandWriter)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorTickCore.cs:486-514

Advance one agent with persistent reactive, execution-status, and Time Limit state.

Category: Low-level runtime

C#
readonly struct BitQuirky.Behavior.Execution.BehaviorTickBakedInput

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorTickCore.cs:48-312

The immutable, per-graph baked tables one tick step reads. Bundling them into one value lets the single Burst-callable TickOnecore serve every caller: the batched BehaviorTickJob(which builds this from its shared [ReadOnly] table fields, fed by BehaviorTickContext.BakedInput), theSamples~/ToyGraphdriver, and the EditMode suites (which build it from aBakedBehaviorArtifact).

Responsibilities:

  • Hold the shared read-only node/transition/blackboard/authority tables and the graph’s root/entry indices as a single blittable value, copyable into a Burst job without managed allocation.

Does NOT:

  • Own the native arrays: they belong to the baked artifact (or the entity binding that references it); this is a non-owning view.
  • Carry per-agent state: the instance and blackboard are separate.

C#
public readonly int AnyStateNodeIndex

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorTickCore.cs:117

Baked node index of the optional Any State plate, or -1 when the graph has none.

C#
public readonly Unity.Collections.NativeArray<BitQuirky.Behavior.Baked.BakedAuthorityEntry> AuthorityTable

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorTickCore.cs:92

One owner-authority row per blackboard field, so the authority gate can scan ownership alone.

C#
public readonly Unity.Collections.NativeArray<BitQuirky.Behavior.Baked.BakedBlackboardSlot> BlackboardLayout

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorTickCore.cs:90

One slot per blackboard field - type code, byte offset, size, and owning authority - describing the layout of the blackboard byte array the step reads and writes.

C#
public readonly Unity.Collections.NativeArray<int> EmitServiceIds

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorTickCore.cs:107

Flattened emitted-service ids, addressed by each node’s emit range.

C#
public readonly int EntryStateIndex

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorTickCore.cs:115

Baked node index of the state a statechart activates first; for a behavior tree it equals RootNodeIndex, and it is -1 when the bake found none.

C#
public readonly int ExecutionStepLimit

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorTickCore.cs:119

Maximum node steps one tick may take; values of zero or less are treated as one. A tick that exhausts the limit faults the machine with ExecutionLimitExceeded instead of looping.

C#
public readonly Unity.Collections.NativeArray<BitQuirky.Behavior.Baked.BakedHostedResultEventCondition> HostedResultEventConditions

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorTickCore.cs:80

Hosted terminal-result event conditions addressed by transitions.

C#
public readonly Unity.Collections.NativeArray<BitQuirky.Behavior.Baked.BakedInterruptibleServiceRequirement> InterruptibleServiceRequirements

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorTickCore.cs:104-105

Service capabilities required by the reactive condition definitions.

C#
public readonly Unity.Collections.NativeArray<int> MemberOperationByNode

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorTickCore.cs:111

Member operation row per baked node index, or -1 .

C#
public readonly Unity.Collections.NativeArray<BitQuirky.Behavior.Baked.BakedMemberOperation> MemberOperations

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorTickCore.cs:109

Append-only baked member operation table .

C#
public readonly Unity.Collections.NativeArray<byte> NativeDefaultBytes

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorTickCore.cs:88

Authored blackboard defaults in the blackboard’s own byte layout, empty when the graph declares none. Initialization copies them; a tick step never writes them.

C#
public readonly Unity.Collections.NativeArray<BitQuirky.Behavior.Baked.BakedNode> Nodes

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorTickCore.cs:51

The graph’s baked nodes in bake order; every node index in this view and on the agent’s runtime instance addresses this table. Read but never written by a tick.

C#
public readonly Unity.Collections.NativeArray<BitQuirky.Behavior.Baked.BakedNodeParameter> Parameters

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorTickCore.cs:100

Dense semantic node parameter table.

C#
public readonly int ProbabilitySelectorCount

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorTickCore.cs:122

Number of persistent Probability Selector rows required by the graph.

C#
public readonly Unity.Collections.NativeArray<BitQuirky.Behavior.Baked.BakedReactiveCondition> ReactiveConditions

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorTickCore.cs:102

Deterministically ordered reactive condition definitions.

C#
public readonly Unity.Collections.NativeArray<int> ReadFieldIds

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorTickCore.cs:94

Flattened read sets: one stable field id hash per entry, addressed by each node’s read range.

C#
public readonly int RootNodeIndex

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorTickCore.cs:113

Baked node index the graph starts from, or -1 when the bake resolved no root.

C#
public readonly Unity.Collections.NativeArray<BitQuirky.Behavior.Baked.BakedStateActionList> StateActionLists

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorTickCore.cs:70

One ordered direct-action lifecycle group per state that owns actions; each row addresses a range of StateActionNodeIndices.

C#
public readonly Unity.Collections.NativeArray<int> StateActionNodeIndices

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorTickCore.cs:72

Baked node indices of state-owned direct actions, flattened in authored edge order and addressed by the StateActionLists ranges.

C#
public readonly Unity.Collections.NativeArray<BitQuirky.Behavior.Baked.BakedStateHostedBehavior> StateHostedBehaviors

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorTickCore.cs:74

State-owned hosted behavior tree lifecycle rows .

C#
public readonly Unity.Collections.NativeArray<int> StateIndexByNode

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorTickCore.cs:78

State-row index per baked node, or -1 for non-state nodes.

C#
public readonly Unity.Collections.NativeArray<BitQuirky.Behavior.Baked.BakedStateMachineCandidate> StateMachineCandidates

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorTickCore.cs:86

Ordered candidate rows of every referenced-machine node, in the order eligibility is evaluated.

C#
public readonly Unity.Collections.NativeArray<BitQuirky.Behavior.Baked.BakedStateMachineReference> StateMachineReferences

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorTickCore.cs:84

Referenced-machine nodes and the candidate range each one owns in StateMachineCandidates.

C#
public readonly Unity.Collections.NativeArray<BitQuirky.Behavior.Baked.BakedStateMachine> StateMachines

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorTickCore.cs:82

Dense composed machine rows; row zero is the authoring host machine.

C#
public readonly Unity.Collections.NativeArray<BitQuirky.Behavior.Nodes.State.StatechartState> StatechartStates

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorTickCore.cs:76

Dense authoritative row for every state node.

C#
public readonly Unity.Collections.NativeArray<BitQuirky.Behavior.Baked.BakedTransitionCondition> TransitionConditions

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorTickCore.cs:63

Every transition and candidate eligibility predicate, addressed by the condition range of the transition or candidate row that owns it.

C#
public readonly Unity.Collections.NativeArray<byte> TransitionConstantBytes

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorTickCore.cs:68

Deterministic constant bytes of every transition predicate whose declared operand is wider than the row’s eight-byte constant column .

C#
public readonly int TransitionMemberConditionCount

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorTickCore.cs:124

Number of persistent member transition-predicate cache rows.

C#
public readonly Unity.Collections.NativeArray<BitQuirky.Behavior.Baked.BakedTransition> Transitions

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorTickCore.cs:53

Every state transition, ordered by source state then authored order, so row order is evaluation priority.

C#
public readonly Unity.Collections.NativeArray<BitQuirky.Behavior.Baked.BakedUtilityBranch> UtilityBranches

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorTickCore.cs:57

Branches of every Utility Selector, addressed by the owning selector node’s utility-branch range.

C#
public readonly Unity.Collections.NativeArray<BitQuirky.Behavior.Baked.BakedUtilityConsideration> UtilityConsiderations

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorTickCore.cs:59

Considerations of every Utility Selector branch, addressed by the owning branch’s consideration range.

C#
public readonly Unity.Collections.NativeArray<BitQuirky.Behavior.Baked.BakedUtilityCurveSample> UtilityCurveSamples

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorTickCore.cs:61

Curve keys of every Utility Selector consideration sampled through a curve, addressed by the owning consideration’s curve range.

C#
public readonly Unity.Collections.NativeArray<int> WaitsServiceIds

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorTickCore.cs:98

Flattened awaited-service ids, addressed by each node’s waits range.

C#
public readonly Unity.Collections.NativeArray<BitQuirky.Behavior.Baked.BakedWeightedChild> WeightedChildren

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorTickCore.cs:55

Weighted children of every Probability Selector, addressed by the owning selector node’s weighted-child range.

C#
public readonly Unity.Collections.NativeArray<int> WriteFieldIds

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorTickCore.cs:96

Flattened write sets: one stable field id hash per entry, addressed by each node’s write range.

BehaviorTickBakedInput(NativeArray<BakedNode> nodes, NativeArray<BakedTransition> transitions, NativeArray<BakedWeightedChild> weightedChildren, NativeArray<BakedTransitionCondition> transitionConditions, NativeArray<BakedBlackboardSlot> blackboardLayout, NativeArray<BakedAuthorityEntry> authorityTable, NativeArray<int> readFieldIds, NativeArray<int> writeFieldIds, NativeArray<int> waitsServiceIds, NativeArray<int> emitServiceIds, NativeArray<BakedNodeParameter> parameters, NativeArray<BakedReactiveCondition> reactiveConditions, NativeArray<BakedInterruptibleServiceRequirement> interruptibleServiceRequirements, NativeArray<BakedMemberOperation> memberOperations, NativeArray<int> memberOperationByNode, NativeArray<BakedStateActionList> stateActionLists, NativeArray<int> stateActionNodeIndices, NativeArray<BakedStateHostedBehavior> stateHostedBehaviors, NativeArray<StatechartState> statechartStates, NativeArray<int> stateIndexByNode, NativeArray<BakedHostedResultEventCondition> hostedResultEventConditions, NativeArray<byte> transitionConstantBytes, int rootNodeIndex, int entryStateIndex, int anyStateNodeIndex, int executionStepLimit, NativeArray<BakedUtilityBranch> utilityBranches, NativeArray<BakedUtilityConsideration> utilityConsiderations, NativeArray<BakedUtilityCurveSample> utilityCurveSamples)

Section titled “BehaviorTickBakedInput(NativeArray<BakedNode> nodes, NativeArray<BakedTransition> transitions, NativeArray<BakedWeightedChild> weightedChildren, NativeArray<BakedTransitionCondition> transitionConditions, NativeArray<BakedBlackboardSlot> blackboardLayout, NativeArray<BakedAuthorityEntry> authorityTable, NativeArray<int> readFieldIds, NativeArray<int> writeFieldIds, NativeArray<int> waitsServiceIds, NativeArray<int> emitServiceIds, NativeArray<BakedNodeParameter> parameters, NativeArray<BakedReactiveCondition> reactiveConditions, NativeArray<BakedInterruptibleServiceRequirement> interruptibleServiceRequirements, NativeArray<BakedMemberOperation> memberOperations, NativeArray<int> memberOperationByNode, NativeArray<BakedStateActionList> stateActionLists, NativeArray<int> stateActionNodeIndices, NativeArray<BakedStateHostedBehavior> stateHostedBehaviors, NativeArray<StatechartState> statechartStates, NativeArray<int> stateIndexByNode, NativeArray<BakedHostedResultEventCondition> hostedResultEventConditions, NativeArray<byte> transitionConstantBytes, int rootNodeIndex, int entryStateIndex, int anyStateNodeIndex, int executionStepLimit, NativeArray<BakedUtilityBranch> utilityBranches, NativeArray<BakedUtilityConsideration> utilityConsiderations, NativeArray<BakedUtilityCurveSample> utilityCurveSamples)”
C#
public BehaviorTickBakedInput(Unity.Collections.NativeArray<BitQuirky.Behavior.Baked.BakedNode> nodes, Unity.Collections.NativeArray<BitQuirky.Behavior.Baked.BakedTransition> transitions, Unity.Collections.NativeArray<BitQuirky.Behavior.Baked.BakedWeightedChild> weightedChildren, Unity.Collections.NativeArray<BitQuirky.Behavior.Baked.BakedTransitionCondition> transitionConditions, Unity.Collections.NativeArray<BitQuirky.Behavior.Baked.BakedBlackboardSlot> blackboardLayout, Unity.Collections.NativeArray<BitQuirky.Behavior.Baked.BakedAuthorityEntry> authorityTable, Unity.Collections.NativeArray<int> readFieldIds, Unity.Collections.NativeArray<int> writeFieldIds, Unity.Collections.NativeArray<int> waitsServiceIds, Unity.Collections.NativeArray<int> emitServiceIds, Unity.Collections.NativeArray<BitQuirky.Behavior.Baked.BakedNodeParameter> parameters, Unity.Collections.NativeArray<BitQuirky.Behavior.Baked.BakedReactiveCondition> reactiveConditions, Unity.Collections.NativeArray<BitQuirky.Behavior.Baked.BakedInterruptibleServiceRequirement> interruptibleServiceRequirements, Unity.Collections.NativeArray<BitQuirky.Behavior.Baked.BakedMemberOperation> memberOperations, Unity.Collections.NativeArray<int> memberOperationByNode, Unity.Collections.NativeArray<BitQuirky.Behavior.Baked.BakedStateActionList> stateActionLists, Unity.Collections.NativeArray<int> stateActionNodeIndices, Unity.Collections.NativeArray<BitQuirky.Behavior.Baked.BakedStateHostedBehavior> stateHostedBehaviors, Unity.Collections.NativeArray<BitQuirky.Behavior.Nodes.State.StatechartState> statechartStates, Unity.Collections.NativeArray<int> stateIndexByNode, Unity.Collections.NativeArray<BitQuirky.Behavior.Baked.BakedHostedResultEventCondition> hostedResultEventConditions, Unity.Collections.NativeArray<byte> transitionConstantBytes, int rootNodeIndex, int entryStateIndex, int anyStateNodeIndex, int executionStepLimit, Unity.Collections.NativeArray<BitQuirky.Behavior.Baked.BakedUtilityBranch> utilityBranches = default(Unity.Collections.NativeArray<BitQuirky.Behavior.Baked.BakedUtilityBranch>), Unity.Collections.NativeArray<BitQuirky.Behavior.Baked.BakedUtilityConsideration> utilityConsiderations = default(Unity.Collections.NativeArray<BitQuirky.Behavior.Baked.BakedUtilityConsideration>), Unity.Collections.NativeArray<BitQuirky.Behavior.Baked.BakedUtilityCurveSample> utilityCurveSamples = default(Unity.Collections.NativeArray<BitQuirky.Behavior.Baked.BakedUtilityCurveSample>))

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorTickCore.cs:131-197

Creates the complete baked view with the authoritative per-state lookup tables. Hosts normally useFromArtifactso compatibility is resolved once before this Burst-facing view is created.

BehaviorTickBakedInput(NativeArray<BakedNode> nodes, NativeArray<BakedTransition> transitions, NativeArray<BakedWeightedChild> weightedChildren, NativeArray<BakedTransitionCondition> transitionConditions, NativeArray<BakedBlackboardSlot> blackboardLayout, NativeArray<BakedAuthorityEntry> authorityTable, NativeArray<int> readFieldIds, NativeArray<int> writeFieldIds, NativeArray<int> waitsServiceIds, NativeArray<int> emitServiceIds, NativeArray<BakedNodeParameter> parameters, NativeArray<BakedReactiveCondition> reactiveConditions, NativeArray<BakedInterruptibleServiceRequirement> interruptibleServiceRequirements, NativeArray<BakedMemberOperation> memberOperations, NativeArray<int> memberOperationByNode, NativeArray<BakedStateActionList> stateActionLists, NativeArray<int> stateActionNodeIndices, NativeArray<BakedStateHostedBehavior> stateHostedBehaviors, NativeArray<StatechartState> statechartStates, NativeArray<int> stateIndexByNode, NativeArray<BakedHostedResultEventCondition> hostedResultEventConditions, NativeArray<byte> transitionConstantBytes, NativeArray<BakedStateMachine> stateMachines, NativeArray<BakedStateMachineReference> stateMachineReferences, NativeArray<BakedStateMachineCandidate> stateMachineCandidates, NativeArray<byte> nativeDefaultBytes, int rootNodeIndex, int entryStateIndex, int anyStateNodeIndex, int executionStepLimit, NativeArray<BakedUtilityBranch> utilityBranches, NativeArray<BakedUtilityConsideration> utilityConsiderations, NativeArray<BakedUtilityCurveSample> utilityCurveSamples, int probabilitySelectorCount, int transitionMemberConditionCount)

Section titled “BehaviorTickBakedInput(NativeArray<BakedNode> nodes, NativeArray<BakedTransition> transitions, NativeArray<BakedWeightedChild> weightedChildren, NativeArray<BakedTransitionCondition> transitionConditions, NativeArray<BakedBlackboardSlot> blackboardLayout, NativeArray<BakedAuthorityEntry> authorityTable, NativeArray<int> readFieldIds, NativeArray<int> writeFieldIds, NativeArray<int> waitsServiceIds, NativeArray<int> emitServiceIds, NativeArray<BakedNodeParameter> parameters, NativeArray<BakedReactiveCondition> reactiveConditions, NativeArray<BakedInterruptibleServiceRequirement> interruptibleServiceRequirements, NativeArray<BakedMemberOperation> memberOperations, NativeArray<int> memberOperationByNode, NativeArray<BakedStateActionList> stateActionLists, NativeArray<int> stateActionNodeIndices, NativeArray<BakedStateHostedBehavior> stateHostedBehaviors, NativeArray<StatechartState> statechartStates, NativeArray<int> stateIndexByNode, NativeArray<BakedHostedResultEventCondition> hostedResultEventConditions, NativeArray<byte> transitionConstantBytes, NativeArray<BakedStateMachine> stateMachines, NativeArray<BakedStateMachineReference> stateMachineReferences, NativeArray<BakedStateMachineCandidate> stateMachineCandidates, NativeArray<byte> nativeDefaultBytes, int rootNodeIndex, int entryStateIndex, int anyStateNodeIndex, int executionStepLimit, NativeArray<BakedUtilityBranch> utilityBranches, NativeArray<BakedUtilityConsideration> utilityConsiderations, NativeArray<BakedUtilityCurveSample> utilityCurveSamples, int probabilitySelectorCount, int transitionMemberConditionCount)”
C#
public BehaviorTickBakedInput(Unity.Collections.NativeArray<BitQuirky.Behavior.Baked.BakedNode> nodes, Unity.Collections.NativeArray<BitQuirky.Behavior.Baked.BakedTransition> transitions, Unity.Collections.NativeArray<BitQuirky.Behavior.Baked.BakedWeightedChild> weightedChildren, Unity.Collections.NativeArray<BitQuirky.Behavior.Baked.BakedTransitionCondition> transitionConditions, Unity.Collections.NativeArray<BitQuirky.Behavior.Baked.BakedBlackboardSlot> blackboardLayout, Unity.Collections.NativeArray<BitQuirky.Behavior.Baked.BakedAuthorityEntry> authorityTable, Unity.Collections.NativeArray<int> readFieldIds, Unity.Collections.NativeArray<int> writeFieldIds, Unity.Collections.NativeArray<int> waitsServiceIds, Unity.Collections.NativeArray<int> emitServiceIds, Unity.Collections.NativeArray<BitQuirky.Behavior.Baked.BakedNodeParameter> parameters, Unity.Collections.NativeArray<BitQuirky.Behavior.Baked.BakedReactiveCondition> reactiveConditions, Unity.Collections.NativeArray<BitQuirky.Behavior.Baked.BakedInterruptibleServiceRequirement> interruptibleServiceRequirements, Unity.Collections.NativeArray<BitQuirky.Behavior.Baked.BakedMemberOperation> memberOperations, Unity.Collections.NativeArray<int> memberOperationByNode, Unity.Collections.NativeArray<BitQuirky.Behavior.Baked.BakedStateActionList> stateActionLists, Unity.Collections.NativeArray<int> stateActionNodeIndices, Unity.Collections.NativeArray<BitQuirky.Behavior.Baked.BakedStateHostedBehavior> stateHostedBehaviors, Unity.Collections.NativeArray<BitQuirky.Behavior.Nodes.State.StatechartState> statechartStates, Unity.Collections.NativeArray<int> stateIndexByNode, Unity.Collections.NativeArray<BitQuirky.Behavior.Baked.BakedHostedResultEventCondition> hostedResultEventConditions, Unity.Collections.NativeArray<byte> transitionConstantBytes, Unity.Collections.NativeArray<BitQuirky.Behavior.Baked.BakedStateMachine> stateMachines, Unity.Collections.NativeArray<BitQuirky.Behavior.Baked.BakedStateMachineReference> stateMachineReferences, Unity.Collections.NativeArray<BitQuirky.Behavior.Baked.BakedStateMachineCandidate> stateMachineCandidates, Unity.Collections.NativeArray<byte> nativeDefaultBytes, int rootNodeIndex, int entryStateIndex, int anyStateNodeIndex, int executionStepLimit, Unity.Collections.NativeArray<BitQuirky.Behavior.Baked.BakedUtilityBranch> utilityBranches = default(Unity.Collections.NativeArray<BitQuirky.Behavior.Baked.BakedUtilityBranch>), Unity.Collections.NativeArray<BitQuirky.Behavior.Baked.BakedUtilityConsideration> utilityConsiderations = default(Unity.Collections.NativeArray<BitQuirky.Behavior.Baked.BakedUtilityConsideration>), Unity.Collections.NativeArray<BitQuirky.Behavior.Baked.BakedUtilityCurveSample> utilityCurveSamples = default(Unity.Collections.NativeArray<BitQuirky.Behavior.Baked.BakedUtilityCurveSample>), int probabilitySelectorCount = 0, int transitionMemberConditionCount = 0)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorTickCore.cs:204-257

Creates the complete baked view and additionally supplies the referenced state-machine tables and the native default-value bytes. Delegates every shared argument to the primary constructor.

FromArtifact(BakedBehaviorArtifact artifact)

Section titled “FromArtifact(BakedBehaviorArtifact artifact)”
C#
public static BitQuirky.Behavior.Execution.BehaviorTickBakedInput FromArtifact(BitQuirky.Behavior.Baked.BakedBehaviorArtifact artifact)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorTickCore.cs:264-311

Build the input from a managed baked artifact. Off the Burst path (composition-root, sample, and test setup); the resulting value is then copied into the tick.

Category: Low-level runtime

C#
struct BitQuirky.Behavior.Execution.BehaviorTickContext

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorTickSystem.cs:710-739

Implements: IComponentData

World-singleton context the system reads each frame. The host loop updates this before calling OnUpdate.

C#
public bool IsValid { get; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorTickSystem.cs:738

Gets whether the context carries both a completion-ring snapshot and a baked node table. OnUpdate ticks nothing while this is false.

C#
public BitQuirky.Behavior.Execution.BehaviorTickBakedInput BakedInput

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorTickSystem.cs:727

The shared baked graph tables the batched tick reads, published by the host on the main thread. The tick job takes these as [ReadOnly]fields rather than from a per-agent component, because a component that itself holds native containers cannot be read inside a job. Feature 008 runs a single shared enemy graph; per-agent heterogeneous graphs are feature 027.

C#
public Unity.Collections.NativeQueue<BitQuirky.Behavior.ExternalService.ExternalServiceCommand>.ParallelWriter CommandQueueWriter

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorTickSystem.cs:717

Parallel writer every ticking agent posts its external service commands to; the host drains the queue on the main thread after this system runs.

C#
public Unity.Collections.NativeArray<BitQuirky.Behavior.ExternalService.ExternalServiceCompletionRecord> CompletionRingSnapshot

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorTickSystem.cs:715

Completion records the host published for this frame. The tick scans them to resume nodes awaiting external work, matching on entity, command, and service id.

C#
public BitQuirky.Behavior.Execution.BehaviorTickDebugDecisions DebugDecisions

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorTickSystem.cs:735

Per-follower-id debug decisions the host may publish for Feature 014 pause / step. Missing keys mean “tick normally” so agents without a debug control entry are unaffected.IsCreated is false when unwired.

C#
public BitQuirky.Behavior.Authority.AuthorityContext ExecutingContext

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorTickSystem.cs:713

The role this process ticks as; the runtime gate refuses any node whose declared authority does not match it.

Category: Low-level runtime

C#
struct BitQuirky.Behavior.Execution.BehaviorTickDebugDecision

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorTickSystem.cs:699-703

Per-follower debug-tick decision the host publishes through BehaviorTickDebugDecisions. ShouldTick offalsemeans “skip the tick this frame”.

Responsibilities:

  • Hold the smallest amount of state the burst-side tick loop needs to honour pause + step (one bool per follower id).

Does NOT:

  • Carry the step credit itself: the host runtime decrements that on its own dictionary after the system runs.

C#
public bool ShouldTick

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorTickSystem.cs:702

True when this follower should tick this frame.

Category: Low-level runtime

C#
struct BitQuirky.Behavior.Execution.BehaviorTickDebugDecisions

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorTickSystem.cs:747-770

Lightweight handle wrapping aNativeParallelHashMap'2 of follower ids toBehaviorTickDebugDecisionso the tick system can read it without taking a dependency on the host runtime’s full debug control surface.

C#
public bool IsCreated { get; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorTickSystem.cs:753

Gets whether the host has published a decision map.

C#
public Unity.Collections.NativeParallelHashMap<int, BitQuirky.Behavior.Execution.BehaviorTickDebugDecision> Map

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorTickSystem.cs:750

Host-owned map from follower id to decision; a default (uncreated) map means every follower ticks.

C#
public bool ShouldTick(int followerId)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorTickSystem.cs:761-769

Decides whether one follower may tick this frame. Returns true when no map has been published or the follower has no entry, so agents the host is not pausing or stepping are unaffected.

Parameters

  • followerId: Host-defined id taken from FollowerId.

Category: Low-level runtime

C#
struct BitQuirky.Behavior.Execution.BehaviorTickJob

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorTickJob.cs:52-257

Implements: IJobEntity

The legacy-compatible batched, Burst-compiled non-reactive behavior-graph tick. One ScheduleParalleladvances every agent in the query for a single simulation frame:BehaviorTickSystemschedules this job once and each agent’s step runs on a worker thread, so there is no per-agent schedule/complete sync point and no per-agent temporary allocation . Every agent’s step is delegated to the sharedTickOnecore, so the batched path, theSamples~/ToyGraphdriver, and the EditMode suites execute byte-for-byte identical node / statechart / external-service semantics (, Principle III).

The shared baked tables are carried as[ReadOnly]array fields, not read from a per-agent component: a component that itself contains native containers is illegal to access inside a job (the Jobs Debugger rejects it, which is the CI condition), so the tables come from the world-singletonBakedInputthat the host publishes on the main thread. The query requires BehaviorRuntimeTickIdentityas the job-safe opt-in marker and source of the follower id. Feature 008 drives a single shared enemy graph; per-agent heterogeneous graphs are feature 027.

Responsibilities:

  • Resolve each agent’s blackboardDynamicBuffer'1in place (zero-copy viaReinterpret''1) and tick exactly one step per agent through the shared core.

Does NOT:

  • Allocate per-agent scratch memory: the blackboard is read and written in the entity chunk; commands go to a shared parallel writer.
  • Drain the External Service Command Queue: the host does that after the tick’s dependency resolves.
  • Require the additive reactive-condition buffer from entities whose graph has no reactive abort observers.
  • Parse Mermaid or mutate consumer gameplay data directly.

C#
public int AnyStateNodeIndex

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorTickJob.cs:116

Baked node index of the optional Any State plate, or -1 when the graph has none.

C#
public Unity.Collections.NativeArray<BitQuirky.Behavior.Baked.BakedAuthorityEntry> AuthorityTable

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorTickJob.cs:88

One owner-authority row per blackboard field, so the authority gate can scan ownership alone.

C#
public Unity.Collections.NativeArray<BitQuirky.Behavior.Baked.BakedBlackboardSlot> BlackboardLayout

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorTickJob.cs:86

One slot per blackboard field - type code, byte offset, size, and owning authority - describing the layout of each agent’s blackboard bytes.

C#
public Unity.Collections.NativeQueue<BitQuirky.Behavior.ExternalService.ExternalServiceCommand>.ParallelWriter CommandWriter

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorTickJob.cs:142

Append-only command queue parallel writer, shared across agents.

C#
public Unity.Collections.NativeArray<BitQuirky.Behavior.ExternalService.ExternalServiceCompletionRecord> CompletionRingSnapshot

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorTickJob.cs:127

Completion records the host published for this frame, valid for this tick only. The tick scans them to resume nodes awaiting external work, matching on entity, command, and service id.

C#
public Unity.Collections.NativeParallelHashMap<int, BitQuirky.Behavior.Execution.BehaviorTickDebugDecision> DebugDecisionMap

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorTickJob.cs:133

Host-published pause and step decisions keyed by FollowerId; an agent with no entry ticks normally. Read only while HasDebugDecisions is non-zero.

C#
public float DeltaSeconds

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorTickJob.cs:131

Simulation time elapsed since the previous tick, in seconds; node elapsed timers and Time Limit decorators accumulate it.

C#
public Unity.Collections.NativeArray<int> EmitServiceIds

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorTickJob.cs:110

Flattened emitted-service ids, addressed by each node’s emit range.

C#
public int EntryStateIndex

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorTickJob.cs:114

Baked node index of the state a statechart activates first; for a behavior tree it equals RootNodeIndex, and it is -1 when the bake found none.

C#
public BitQuirky.Behavior.Authority.AuthorityContext ExecutingContext

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorTickJob.cs:125

The role this process ticks as; the runtime gate refuses any node whose declared authority does not match it.

C#
public int ExecutionStepLimit

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorTickJob.cs:118

Maximum node steps one agent’s tick may take. A tick that exhausts the limit faults the machine with ExecutionLimitExceeded instead of looping.

C#
public int FrameNumber

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorTickJob.cs:129

The host’s monotonic simulation frame counter for this tick, stamped onto every emitted command and onto the completion bookkeeping on each instance.

C#
public byte HasDebugDecisions

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorTickJob.cs:135

Non-zero when the host published a decision map for this frame; zero skips the lookup entirely and every matched agent ticks.

C#
public Unity.Collections.NativeArray<BitQuirky.Behavior.Baked.BakedHostedResultEventCondition> HostedResultEventConditions

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorTickJob.cs:84

Hosted terminal-result event conditions, each naming the transition row that waits for the event.

C#
public Unity.Collections.NativeArray<int> MemberOperationByNode

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorTickJob.cs:100

Row index into MemberOperations per baked node index, or -1 when the node binds no member.

C#
public Unity.Collections.NativeArray<BitQuirky.Behavior.Baked.BakedMemberOperation> MemberOperations

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorTickJob.cs:98

Baked member operations - the calls, reads, and writes nodes make against the customer’s own components - addressed through MemberOperationByNode.

C#
public Unity.Collections.NativeArray<byte> NativeDefaultBytes

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorTickJob.cs:108

Authored blackboard defaults in the blackboard’s own byte layout, empty when the graph declares none. Only agent initialization copies them; a tick never writes them.

C#
public Unity.Collections.NativeArray<BitQuirky.Behavior.Baked.BakedNode> Nodes

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorTickJob.cs:58

The shared graph’s baked nodes in bake order, read-only for the whole tick; every node index this job and each agent’s runtime instance carry addresses this table.

C#
public Unity.Collections.NativeArray<BitQuirky.Behavior.Baked.BakedNodeParameter> Parameters

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorTickJob.cs:96

Dense semantic node parameters, addressed by each node’s parameter range.

C#
public Unity.Collections.NativeArray<int> ReadFieldIds

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorTickJob.cs:90

Flattened read sets: one stable field id hash per entry, addressed by each node’s read range.

C#
public int RootNodeIndex

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorTickJob.cs:112

Baked node index the shared graph starts from, or -1 when the bake resolved no root.

C#
public Unity.Collections.NativeArray<BitQuirky.Behavior.Baked.BakedStateActionList> StateActionLists

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorTickJob.cs:74

One ordered direct-action lifecycle group per state that owns actions; each row addresses a range of StateActionNodeIndices.

C#
public Unity.Collections.NativeArray<int> StateActionNodeIndices

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorTickJob.cs:76

Baked node indices of state-owned direct actions, flattened in authored edge order and addressed by the StateActionLists ranges.

C#
public Unity.Collections.NativeArray<BitQuirky.Behavior.Baked.BakedStateHostedBehavior> StateHostedBehaviors

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorTickJob.cs:78

One row per state that owns a hosted behavior tree, naming the hosted root node and the lifecycle contract applied to its terminal result.

C#
public Unity.Collections.NativeArray<int> StateIndexByNode

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorTickJob.cs:82

Row index into StatechartStates per baked node index, or -1 for nodes that are not states.

C#
public Unity.Collections.NativeArray<BitQuirky.Behavior.Baked.BakedStateMachineCandidate> StateMachineCandidates

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorTickJob.cs:106

Ordered candidate rows of every referenced-machine node, in the order eligibility is evaluated.

C#
public Unity.Collections.NativeArray<BitQuirky.Behavior.Baked.BakedStateMachineReference> StateMachineReferences

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorTickJob.cs:104

Referenced-machine nodes and the candidate range each one owns in StateMachineCandidates.

C#
public Unity.Collections.NativeArray<BitQuirky.Behavior.Baked.BakedStateMachine> StateMachines

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorTickJob.cs:102

Dense composed machine rows; row zero is the authoring host machine.

C#
public Unity.Collections.NativeArray<BitQuirky.Behavior.Nodes.State.StatechartState> StatechartStates

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorTickJob.cs:80

Dense state row for every baked state node, reached through StateIndexByNode.

C#
public Unity.Collections.NativeArray<BitQuirky.Behavior.Baked.BakedTransitionCondition> TransitionConditions

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorTickJob.cs:70

Every transition and candidate eligibility predicate, addressed by the condition range of the transition or candidate row that owns it.

C#
public Unity.Collections.NativeArray<byte> TransitionConstantBytes

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorTickJob.cs:72

Constants of transition predicates too wide for a condition row’s eight-byte column, addressed by that row’s constant byte range.

C#
public Unity.Collections.NativeArray<BitQuirky.Behavior.Baked.BakedTransition> Transitions

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorTickJob.cs:60

Every state transition of the shared graph, ordered by source state then authored order, so row order is evaluation priority.

C#
public Unity.Collections.NativeArray<BitQuirky.Behavior.Baked.BakedUtilityBranch> UtilityBranches

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorTickJob.cs:64

Branches of every Utility Selector, addressed by the owning selector node’s utility-branch range.

C#
public Unity.Collections.NativeArray<BitQuirky.Behavior.Baked.BakedUtilityConsideration> UtilityConsiderations

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorTickJob.cs:66

Considerations of every Utility Selector branch, addressed by the owning branch’s consideration range.

C#
public Unity.Collections.NativeArray<BitQuirky.Behavior.Baked.BakedUtilityCurveSample> UtilityCurveSamples

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorTickJob.cs:68

Curve keys of every Utility Selector consideration sampled through a curve, addressed by the owning consideration’s curve range.

C#
public Unity.Collections.NativeArray<int> WaitsServiceIds

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorTickJob.cs:94

Flattened awaited-service ids, addressed by each node’s waits range.

C#
public Unity.Collections.NativeArray<BitQuirky.Behavior.Baked.BakedWeightedChild> WeightedChildren

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorTickJob.cs:62

Weighted children of every Probability Selector, addressed by the owning selector node’s weighted-child range.

C#
public Unity.Collections.NativeArray<int> WriteFieldIds

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorTickJob.cs:92

Flattened write sets: one stable field id hash per entry, addressed by each node’s write range.

Category: Low-level runtime

C#
struct BitQuirky.Behavior.Execution.BehaviorTickSystem

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorTickSystem.cs:51-569

Implements: ISystem

ECS system that drives everyBehaviorRuntimeInstance component on an agent entity through one tick step per simulation frame with a single batched parallel schedule. One BehaviorTickJobor its additive reactive counterpart advances the whole query across the worker pool, replacing the former per-agent schedule-then-complete loop: no per-agent sync point, no per-agent temporary allocation, zero managed allocation on the tick path .

Responsibilities:

  • Read the world-singletonBehaviorTickContext(executing authority context, completion-ring snapshot, command-queue parallel writer, command-id counter, debug decisions) and hand it to the batched job, without copying per-agent.
  • Restrict ticking to explicitly bound agents: a BehaviorRuntimeTickIdentityopts the entity into this graph context and supplies the job-safe follower id used by debug pause / step decisions.
  • Schedule the batched tick once, flow the dependency into Dependency, and resolve it with a single frame-level barrier (never per-agent) so the host’s main-thread external-service drain, which reads the command queue and completion ring this job wrote, sees settled data.

Does NOT:

  • Manage adapter lifecycle (that is the concern of the host FollowerBehaviorRuntimeGameLogic in Layer 3).
  • Drain the External Service Command Queue: the host does that after this system, on the main thread.
  • Parse Mermaid (FR-012f).
  • Mutate consumer gameplay data directly: node side effects flow through the command queue and are decoded by Layer 3 adapters.

The system is updated in the simulation group; the host loop is responsible for running adapter drain immediately after.

C#
public void OnCreate(ref Unity.Entities.SystemState state)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorTickSystem.cs:78-133

Allocates the persistent empty debug-decision map used when the host publishes none, and builds the queries that backfill per-agent runtime buffers. Called once by the ECS world; hosts never call it directly.

C#
public void OnDestroy(ref Unity.Entities.SystemState state)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorTickSystem.cs:139-145

Releases the empty debug-decision map allocated byOnCreate. Called once by the ECS world when the system is torn down.

C#
public void OnUpdate(ref Unity.Entities.SystemState state)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/Execution/BehaviorTickSystem.cs:159-292

Advances every bound agent by one tick, using the world’s delta time in seconds. Returns without ticking anything while the world holds no valid BehaviorTickContextsingleton. Otherwise it increments this system’s own frame counter, backfills and resizes the per-agent runtime buffers to the artifact’s node and referenced-machine counts, schedules one batched parallel job across every entity carryingBehaviorRuntimeInstance, BehaviorRuntimeTickIdentity, and a blackboard buffer, and completes that job before returning, so the host’s main-thread external-service drain sees settled command-queue and completion-ring writes. Called by the ECS world once per simulation frame.

Source fingerprint: sha256:29003d8b1658b98a79bebcd93e3b4030caf8511268b96817ab764d63df8d6c3b

Full-size image