Reference map for the broad aura model: auras, folders, triggers, actions,
overlays, behavior trees, script entities, and built-in aura packs.
- An aura is a user-facing automation unit.
- Enabling conditions gate whether an aura may activate.
- Triggers watch state and drive activation.
- Actions perform work in lifecycle lists.
- Overlays display UI/presentation.
- Behavior tree nodes are tick-based aura entities.
- Aura packs are registered by modules and described by metadata assemblies.
DefaultAurasModule - default triggers/actions/overlays/settings.AdvancedAurasModule - advanced integrations such as Telegram.CsScriptAurasModule - C# script triggers, actions, and overlays.BehaviorTreeModule - behavior-tree nodes and runtime integration.BehaviorTreeRootNode.IsLoaded is desired load state, not an awaited drain receipt.
Unload closes all root/node Tick entrypoints, cancels the root epoch, then waits
for admitted calls before resetting structural node state and the session.
A quick reload waits for that cleanup; graph/config/blackboard remain.
Manual ticks on an unloaded or draining root return Failure without execution.
Loaded but inactive/Disabled roots still permit manual ticks.
Same-root SubTree uses exclusive containing-tree ownership keyed by entry/alias-chain/epoch.
Running and live script iterators retain it, including a terminal yield.
Another caller receives Failure until captured-owner cancel/drain/reset finishes.
Retarget cleans the OLD target; the same owner can continue its terminal iterator.
Ordinary IsTicking=false keeps Session-only maintenance; explicit status-reset/unload clears owned state.
Foreign roots and whole-application disposal completion remain separate contracts.IAuraRegistrator - central entity registration service.AuraActionBase<T> - common action base; inspect ExecuteInternal.AuraTriggerBase<T> - common trigger base; inspect
CreateTriggerEventSource.
- Use
auras/entities.md for registration and factories.
- Use
auras/actions.md for action execution.
- Use
auras/triggers.md for activation/event sources.
- Use
auras/overlays.md for overlay entities.
- aura
- trigger
- action
- overlay
- aura pack
- behavior tree
- script action
- script trigger
- lifecycle action
- enabling condition
core/eyeauras-structure.mdauras/entities.mdauras/actions.mdauras/triggers.mdauras/overlays.mdscripting/runtime.md