Skip to content
Bit Quirky Behavior Trees and
State Machines

Search documentation

All topics and APIs

Close returns focus to Search.

What are you looking for?

Try a common topic or enter a complete API identifier.

Browse the reference instead

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

v0.11.0
Menu

BitQuirky.Behavior.GameObject

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

Source snapshot 29003d8b1658.

Assembly: BitQuirky.Behavior.Runtime.Backend

Category: GameObject integration

C#
class BitQuirky.Behavior.GameObject.BehaviorAgentBackend

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/GameObject/BehaviorAgentBackend.cs:45-2016

Implements: IBehaviorAgentBackend

Thin GameObject owner over the same behavior execution core used by entities.

Responsibilities:

  • Materialize one imported artifact, own native runtime state, tick one selected Unity callback, and preserve the same instance across disable and re-enable.
  • Own one independently mutable managed blackboard companion clone for graphs that declare a GameObject-path value, restore it on reset, keep it across disable and re-enable, and release it exactly once on replacement and disposal.
  • Compose exact fact binders and command handlers around each shared-core step.
  • Carry one monotonic runtime generation, the running executable and generated member provider fingerprints, and one stable non-negative debug follower key, so an editor observer can pin exactly this runtime instance.
  • Consult an attached non-owning follower-keyed debug tick control before each selected Unity callback, so a Live document can pause and single-step this one agent through its normal tick path.

Does NOT:

  • Parse source, interpret nodes in managed code, create a backing World, or locate a default graph, binder, command handler, or movement backend.
  • Own, create, or dispose the debug tick control, or introduce a second evaluation path for a paused or stepped frame.

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

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/GameObject/BehaviorAgentBackend.cs:901

Gets persistent per-action progress for direct state action lists.

C#
public UnityEngine.EntityId AgentEntityId { get; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/GameObject/BehaviorAgentBackend.cs:414

Gets the stable Unity entity identity assigned to this GameObject.

C#
public BitQuirky.Behavior.GameObject.BehaviorAgentBindingMap BindingMap { get; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/GameObject/BehaviorAgentBackend.cs:936

Gets the exact initialized field and service ownership map.

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

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/GameObject/BehaviorAgentBackend.cs:851

Gets the owned blackboard bytes.

C#
public UnityEngine.MonoBehaviour[] CommandHandlerComponents { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/GameObject/BehaviorAgentBackend.cs:245-254

Gets or sets explicitly composed command handlers before initialization.

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

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/GameObject/BehaviorAgentBackend.cs:927

Gets the owned external-service command queue.

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

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/GameObject/BehaviorAgentBackend.cs:930

Gets the owned external-service completion ring.

C#
public int DebugFollowerId { get; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/GameObject/BehaviorAgentBackend.cs:446-461

Gets the stable non-negative debug follower key that addresses this component in a BehaviorDebugTickControl. It identifies the component rather than one runtime generation, so two agents on one GameObject are two independently controllable followers.

C#
public BitQuirky.Behavior.Diagnostics.BehaviorDebugTickControl DebugTickControl { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/GameObject/BehaviorAgentBackend.cs:470-474

Gets or sets the non-owning per-follower debug tick control that the selected Unity callback consults before advancing. Null is the shipped default: nothing is attached, and the tick path costs one reference test. A Live document assigns its own control while it is attached and clears it again when it is released, so a released document can never leave this agent frozen.

C#
public ulong ExecutableFingerprint { get; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/GameObject/BehaviorAgentBackend.cs:429-430

Gets the executable content fingerprint of the artifact this component is running, or zero before initialization.

C#
public BitQuirky.Behavior.Authoring.BehaviorSourceAsset Graph { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/GameObject/BehaviorAgentBackend.cs:187-196

Gets or sets the imported behavior graph before initialization.

C#
public BitQuirky.Behavior.Member.IBehaviorMemberProvider HostedMemberProvider { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/GameObject/BehaviorAgentBackend.cs:293-302

Gets or sets the explicitly composed consumer-owned member provider a Hosted State Machine node’s own referenced artifact resolves its member operations against (FSM-013), before initialization. Distinct fromMemberProvider: the hosted artifact is a separately authored graph with its own binding-set fingerprint, so it never resolves against the host graph’s own provider. Takes precedence over any serializedHostedMemberProviderComponent.

C#
public UnityEngine.MonoBehaviour HostedMemberProviderComponent { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/GameObject/BehaviorAgentBackend.cs:309-318

Gets or sets the explicitly composed serialized member provider component a Hosted State Machine node’s own referenced artifact resolves its member operations against (FSM-013), before initialization.

C#
public UnityEngine.MonoBehaviour[] InputBinderComponents { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/GameObject/BehaviorAgentBackend.cs:221-230

Gets or sets explicitly composed input binders before initialization.

C#
public bool IsDisposed { get; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/GameObject/BehaviorAgentBackend.cs:405

Gets whether this component has disposed its owned runtime state.

C#
public bool IsInitialized { get; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/GameObject/BehaviorAgentBackend.cs:402

Gets whether this component owns initialized runtime state.

C#
public bool IsTerminallyCancelled { get; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/GameObject/BehaviorAgentBackend.cs:408

Gets whether explicit terminal cancellation has stopped this agent.

C#
public bool LastInterruptionHasConfiguredResponse { get; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/GameObject/BehaviorAgentBackend.cs:824-826

Gets whether the guard’s most recently recorded interruption, since the response-bearing task’s own last entry, resolved a configured response . Reads the persistent record directly, never the transient in-scene cue.

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

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/GameObject/BehaviorAgentBackend.cs:858-859

Gets this agent’s own per-instance live-value overlay table, indexed by baked node index . An editor reads this to show a Task or State row’s currently effective value and whether an accepted live edit is active.

C#
public BitQuirky.Behavior.Blackboard.BehaviorManagedBlackboardTemplate ManagedBlackboard { get; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/GameObject/BehaviorAgentBackend.cs:344

Gets this agent’s own independently mutable companion clone, or null when the graph declares no GameObject-path value. Two agents running the same graph never share it.

C#
public BitQuirky.Behavior.Blackboard.BehaviorManagedBlackboardTemplate ManagedBlackboardTemplate { get; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/GameObject/BehaviorAgentBackend.cs:337-338

Gets the generated managed blackboard companion template imported with this graph. A graph that declares a GameObject-path value requires it; a graph that declares none carries none.

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

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/GameObject/BehaviorAgentBackend.cs:347

Gets the owned member binding runtime, or null when the graph binds no members.

C#
public BitQuirky.Behavior.Diagnostics.BehaviorMemberFaultTrace MemberFaultTrace { get; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/GameObject/BehaviorAgentBackend.cs:359

Gets the bounded managed companion trace for structured member faults, or null when this graph binds no members.

C#
public BitQuirky.Behavior.Member.IBehaviorMemberProvider MemberProvider { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/GameObject/BehaviorAgentBackend.cs:260-269

Gets or sets the explicitly composed consumer-owned member provider before initialization. Takes precedence over any serialized provider component.

C#
public UnityEngine.MonoBehaviour MemberProviderComponent { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/GameObject/BehaviorAgentBackend.cs:274-283

Gets or sets the explicitly composed serialized member component before initialization.

C#
public ulong MemberProviderFingerprint { get; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/GameObject/BehaviorAgentBackend.cs:438

Gets the binding-set fingerprint of the generated member provider this component initialized with, or zero when the graph binds no member. An initialized member runtime requires this to equal the artifact’s binding-set fingerprint, so a difference means the provider in use is not the one an observer attached to.

C#
public BitQuirky.Behavior.Member.BehaviorMemberReference[] MemberReferences { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/GameObject/BehaviorAgentBackend.cs:321-330

Gets or sets the serialized explicit member reference slots before initialization.

C#
public int MemberTargetReadingCount { get; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/GameObject/BehaviorAgentBackend.cs:370-371

Gets the number of live blackboard-variable target readings this agent holds.

C#
public UnityEngine.MonoBehaviour MovementAdapterComponent { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/GameObject/BehaviorAgentBackend.cs:209-218

Gets or sets the explicitly composed component implementing IBehaviorMovementAdapterbefore initialization.

C#
public BitQuirky.Behavior.Movement.BehaviorMovementService MovementService { get; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/GameObject/BehaviorAgentBackend.cs:933

Gets the movement service composed for this agent.

C#
public Unity.Collections.NativeArray<BitQuirky.Behavior.Diagnostics.BehaviorNodeExecutionStatus> NodeExecutionStatuses { get; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/GameObject/BehaviorAgentBackend.cs:866-867

Gets the persistent latest execution state for every baked node.

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

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/GameObject/BehaviorAgentBackend.cs:862-863

Gets the persistent artifact-indexed reactive observer state.

C#
public int RefEvaluationReadingCount { get; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/GameObject/BehaviorAgentBackend.cs:386-387

Gets the number of live ref-parameter evaluation readings this agent holds.

C#
public BitQuirky.Behavior.Execution.BehaviorMachineResult Result { get; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/GameObject/BehaviorAgentBackend.cs:848

Gets the explicit final state-machine result, or None while still active.

C#
public uint RuntimeGeneration { get; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/GameObject/BehaviorAgentBackend.cs:423

Gets the advancing generation of this component’s initialized runtime. Zero means no runtime has been built yet. It advances on every initialization, graph replacement, and runtime reset. The unsigned counter wraps from its maximum back to one, keeping zero reserved for the uninitialized state. Disabling and re-enabling preserves the one runtime, so it preserves the generation.

C#
public BitQuirky.Behavior.Execution.BehaviorRuntimeInstance RuntimeInstance { get; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/GameObject/BehaviorAgentBackend.cs:477

Gets the owned behavior runtime state.

C#
public UnityEngine.MonoBehaviour[] ServiceAdapterComponents { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/GameObject/BehaviorAgentBackend.cs:233-242

Gets or sets explicitly composed general service adapters.

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

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/GameObject/BehaviorAgentBackend.cs:909

Gets native Push suspension frames in activation order.

C#
public long TickCount { get; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/GameObject/BehaviorAgentBackend.cs:411

Gets the number of shared-core steps executed by this component.

C#
public int UnresolvedMemberTargetCount { get; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/GameObject/BehaviorAgentBackend.cs:366-367

Gets how many blackboard-variable member targets did not resolve on their last evaluation. This is a live reading that clears as soon as every variable holds a usable object again; it is never a bake verdict and is never written into the graph.

C#
public BitQuirky.Behavior.GameObject.BehaviorAgentUpdateMode UpdateMode { get; set; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/GameObject/BehaviorAgentBackend.cs:199-203

Gets or sets the one Unity callback that advances this agent.

C#
public Unity.Collections.NativeArray<BitQuirky.Behavior.Diagnostics.BehaviorUtilityBranchScore> UtilityBranchScores { get; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/GameObject/BehaviorAgentBackend.cs:905-906

Gets persistent current score and active flag for every baked Utility Selector branch.

C#
public event System.Action<int> InterruptionResponseTriggered

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/GameObject/BehaviorAgentBackend.cs:817

Fires exactly once per host tick in whichRuntimeInstance’s LastInterruption.Sequencehas just advanced to a genuinely new, freshly resolved response-bearing interruption: itsResponseNodeIndexis nonnegative and itsResponseNodeIndexReassertedis zero, passing that response-bearing task’s own baked node index as the payload (, BT-016). It never fires for a repeated read of the same interruption, when no response-bearing ancestor was resolved, or when the same guarded branch’s own reactive conditions merely re-asserted themselves and carried the prior interruption’s response forward unchanged (P2) - that carried-forward fact still persists through LastInterruptionHasConfiguredResponse, only the event does not repeat.

C#
public BehaviorAgentBackend(BitQuirky.Behavior.GameObject.BehaviorAgent owner)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/GameObject/BehaviorAgentBackend.cs:51-54

Creates a nonserialized execution backend for the supplied stable agent owner.

C#
public void CancelActiveWork(int frameNumber)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/GameObject/BehaviorAgentBackend.cs:986-989

Stops this agent’s outstanding external work exactly once.

C#
public void FixedUpdate()

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/GameObject/BehaviorAgentBackend.cs:1134-1140

Receives the owner’s FixedUpdate callback for its configured tick schedule.

C#
public string GetAuthoredNodeId(int nodeIndex)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/GameObject/BehaviorAgentBackend.cs:833-845

Resolves a baked node index to its authored source id through the baked artifact’s NodeIdNamestable, or the empty string when the index is out of range .

C#
public void InitializeNow()

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/GameObject/BehaviorAgentBackend.cs:939-945

Initializes the one owned runtime instance when it has not started.

C#
public void OnDestroy()

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/GameObject/BehaviorAgentBackend.cs:1119-1122

Releases owned state when the stable owner is destroyed.

C#
public void OnDisable()

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/GameObject/BehaviorAgentBackend.cs:1110-1116

Receives the stable owner’s disable callback.

C#
public void OnEnable()

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/GameObject/BehaviorAgentBackend.cs:1097-1107

Receives the stable owner’s enable callback.

C#
public BitQuirky.Behavior.Member.BehaviorMemberTargetReading ReadMemberTargetReading(int index)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/GameObject/BehaviorAgentBackend.cs:378-383

Reads one live blackboard-variable target reading for explicit tooling inspection, carrying graph, node, binding, variable, reason, the type required, and the object held. Formatting happens only on this explicit read.

C#
public BitQuirky.Behavior.Member.BehaviorMemberRefEvaluationReading ReadRefEvaluation(int index)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/GameObject/BehaviorAgentBackend.cs:394-399

Reads one live ref-parameter evaluation reading for explicit tooling inspection, carrying the pre-call read, post-call write, and completion outcome of the last invocation observed. Formatting happens only on this explicit read.

ReplaceGraph(BehaviorSourceAsset graph, int frameNumber)

Section titled “ReplaceGraph(BehaviorSourceAsset graph, int frameNumber)”
C#
public void ReplaceGraph(BitQuirky.Behavior.Authoring.BehaviorSourceAsset graph, int frameNumber)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/GameObject/BehaviorAgentBackend.cs:951-983

Cancels the current graph’s work, releases its owned native state, and initializes the replacement graph with the same explicit host composition.

C#
public void ResetRuntime(int frameNumber)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/GameObject/BehaviorAgentBackend.cs:1049-1094

Restores the initialized artifact to its deterministic entry state.

SubmitLiveValueEdit(in BehaviorLiveValueEditRequest request)

Section titled “SubmitLiveValueEdit(in BehaviorLiveValueEditRequest request)”
C#
public BitQuirky.Behavior.Member.BehaviorLiveValueEditResult SubmitLiveValueEdit(in BitQuirky.Behavior.Member.BehaviorLiveValueEditRequest request)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/GameObject/BehaviorAgentBackend.cs:489-508

Submits one live value edit against this agent’s own per-instance storage (, through ): a declared blackboard field or graph-local variable is written into the existing per-instance blackboard, and a Task authored constant or State duration parameter is written into this agent’s own live-value overlay, keyed by the baked node that owns it. Refuses a request this agent cannot yet accept, a target this baked graph does not declare, a blackboard slot whose strongest declared writer is host-authoritative, or a payload that is not the target slot’s own exact representation, with a stated reason and no partial change.

TickManual(float deltaTime, int frameNumber)

Section titled “TickManual(float deltaTime, int frameNumber)”
C#
public void TickManual(float deltaTime, int frameNumber)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/GameObject/BehaviorAgentBackend.cs:1177-1187

Advances this agent once from an external driver, honoring the exact same attached Live document pause/step gate as the automaticUpdate/ FixedUpdate callbacks, instead of the ungated TickOnce a driver calling it directly would bypass that gate with. Requires UpdateMode to be Manual; neither Update nor FixedUpdateadvances this agent while that mode is selected, so this is the only tick path for a Manual-mode agent.

TickOnce(float deltaTime, int frameNumber)

Section titled “TickOnce(float deltaTime, int frameNumber)”
C#
public BitQuirky.Behavior.Execution.BehaviorTickStepResult TickOnce(float deltaTime, int frameNumber)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/GameObject/BehaviorAgentBackend.cs:1192-1273

Samples facts, advances the shared behavior core, and dispatches services once.

TryReadProbabilityState(int nodeIndex, out BehaviorProbabilityRuntimeState state)

Section titled “TryReadProbabilityState(int nodeIndex, out BehaviorProbabilityRuntimeState state)”
C#
public bool TryReadProbabilityState(int nodeIndex, out BitQuirky.Behavior.Execution.BehaviorProbabilityRuntimeState state)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/GameObject/BehaviorAgentBackend.cs:882-898

Maps a baked node to its sparse selector state without relying on the trace cursor.

TryReadReferenceState(int referenceIndex, out BehaviorReferenceRuntimeState state)

Section titled “TryReadReferenceState(int referenceIndex, out BehaviorReferenceRuntimeState state)”
C#
public bool TryReadReferenceState(int referenceIndex, out BitQuirky.Behavior.Execution.BehaviorReferenceRuntimeState state)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/GameObject/BehaviorAgentBackend.cs:912-924

Reads one retained state-machine reference lifecycle without allocating.

TryReadRepeatState(int nodeIndex, out BehaviorRepeatRuntimeState state)

Section titled “TryReadRepeatState(int nodeIndex, out BehaviorRepeatRuntimeState state)”
C#
public bool TryReadRepeatState(int nodeIndex, out BitQuirky.Behavior.Execution.BehaviorRepeatRuntimeState state)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/GameObject/BehaviorAgentBackend.cs:870-879

Reads one retained Repeat row for the editor without exposing a member binding.

C#
public void Update()

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/GameObject/BehaviorAgentBackend.cs:1125-1131

Receives the owner’s Update callback for its configured tick schedule.

Category: GameObject integration

C#
class BitQuirky.Behavior.GameObject.BehaviorAgentBindingMap

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/GameObject/BehaviorAgentBindingMap.cs:27-734

Exact initialized field and service ownership for one GameObject behavior agent.

Responsibilities:

  • Own the resolved binder and handler tables used by one explicitly composed agent.
  • Reject missing, duplicate, unknown, null, or incompatible authored bindings, while recognizing that member-projected fields and carried declared values are supplied by the graph itself rather than by an input binder.

Does NOT:

  • Own runtime native storage, tick behavior, or discover components by order.

C#
public int CommandHandlerCount { get; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/GameObject/BehaviorAgentBindingMap.cs:63

Gets the number of exact authored service-token mappings.

C#
public int InputBinderCount { get; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/GameObject/BehaviorAgentBindingMap.cs:60

Gets the number of explicitly composed input binder components.

Category: GameObject integration

C#
readonly struct BitQuirky.Behavior.GameObject.BehaviorAgentBlackboardFieldHandle<T> where T : unmanaged

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/GameObject/IBehaviorAgentInputBinder.cs:20-58

Resolved type-safe blackboard field location for a GameObject input binder.

Responsibilities:

  • Write one validated unmanaged value without per-step name lookup or byte arithmetic.

Does NOT:

  • Own blackboard storage or resolve fields during a selected step.

C#
public bool IsValid { get; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/GameObject/IBehaviorAgentInputBinder.cs:34

Gets whether this handle was resolved from a compatible baked field.

Write(NativeArray<byte> blackboard, T value)

Section titled “Write(NativeArray<byte> blackboard, T value)”
C#
public void Write(Unity.Collections.NativeArray<byte> blackboard, T value)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/GameObject/IBehaviorAgentInputBinder.cs:37-57

Writes one typed value to the resolved blackboard location.

Category: GameObject integration

C#
class BitQuirky.Behavior.GameObject.BehaviorAgentBlackboardSchema

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/GameObject/IBehaviorAgentInputBinder.cs:70-164

Resolves required GameObject blackboard input fields once at composition.

Responsibilities:

  • Validate stable field name, baked type, and unmanaged storage size.
  • Reject field ownership shared between input binders during composition.

Does NOT:

  • Sample scene state or mutate live blackboard bytes.

C#
public BitQuirky.Behavior.GameObject.BehaviorAgentBlackboardFieldHandle<T> Require<T>(string fieldName) where T : unmanaged

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/GameObject/IBehaviorAgentInputBinder.cs:100-133

Resolves a required field and validates its baked type and size.

Category: GameObject integration

C#
class BitQuirky.Behavior.GameObject.BehaviorAgentRuntimeAccess

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/GameObject/BehaviorRuntimeBackendRegistration.cs:20-28

Exposes typed backend access only to callers that depend on the runtime backend assembly.

C#
public static BitQuirky.Behavior.GameObject.BehaviorAgentBackend GetRuntime(this BitQuirky.Behavior.GameObject.BehaviorAgent owner)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/GameObject/BehaviorRuntimeBackendRegistration.cs:23-27

Gets the selected nonserialized native execution implementation.

Category: GameObject integration

C#
interface BitQuirky.Behavior.GameObject.IBehaviorAgentInputBinder

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/GameObject/IBehaviorAgentInputBinder.cs:175-182

Explicit GameObject fact binder invoked before each reactive behavior tick.

Responsibilities:

  • Resolve required typed fields once and sample current facts allocation-free per step.

Does NOT:

  • Tick behavior, dispatch services, or discover scene dependencies.

Bind(BehaviorAgentBlackboardSchema schema)

Section titled “Bind(BehaviorAgentBlackboardSchema schema)”
C#
void Bind(BitQuirky.Behavior.GameObject.BehaviorAgentBlackboardSchema schema)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/GameObject/IBehaviorAgentInputBinder.cs:178

Resolves all required fields once during agent composition.

C#
void Sample(Unity.Collections.NativeArray<byte> blackboard)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/GameObject/IBehaviorAgentInputBinder.cs:181

Samples current facts into the supplied blackboard before a tick.

Category: GameObject integration

C#
interface BitQuirky.Behavior.GameObject.IBehaviorGameObjectCommandHandler

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/GameObject/IBehaviorGameObjectCommandHandler.cs:18-25

Explicit GameObject command handler invoked after each selected behavior tick.

Responsibilities:

  • Declare every stable service token handled by one explicitly composed component.
  • Apply emitted commands in deterministic queue order without per-step token lookup.

Does NOT:

  • Tick behavior, sample facts, or discover a default service implementation.

C#
System.Collections.Generic.IReadOnlyList<string> ServiceTokens { get; }

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/GameObject/IBehaviorGameObjectCommandHandler.cs:21

Gets the stable authored service tokens claimed by this handler.

C#
void Handle(in BitQuirky.Behavior.ExternalService.ExternalServiceCommand command)

Source declaration: Packages/io.bitquirky.behavior/Runtime/Backend/GameObject/IBehaviorGameObjectCommandHandler.cs:24

Handles one emitted command for a claimed service.

Source fingerprint: sha256:29003d8b1658b98a79bebcd93e3b4030caf8511268b96817ab764d63df8d6c3b

Full-size image