Class ScyllaBootstrap

Main bootstrap component that initializes and manages the lifecycle of the Scylla Framework. This UnityEngine.MonoBehaviour serves as the root entry point for the entire framework: it configures logging, initializes the ScyllaCore singleton, validates the module scene hierarchy, and orchestrates startup and shutdown of all registered ScyllaModule instances.

Inheritance

object

Object

Component

Behaviour

MonoBehaviour

ScyllaBootstrap

Inherited Members

MonoBehaviour.IsInvoking()

MonoBehaviour.CancelInvoke()

MonoBehaviour.Invoke(string, float)

MonoBehaviour.InvokeRepeating(string, float, float)

MonoBehaviour.CancelInvoke(string)

MonoBehaviour.IsInvoking(string)

MonoBehaviour.StartCoroutine(string)

MonoBehaviour.StartCoroutine(string, object)

MonoBehaviour.StartCoroutine(IEnumerator)

MonoBehaviour.StopCoroutine(IEnumerator)

MonoBehaviour.StopCoroutine(Coroutine)

MonoBehaviour.StopCoroutine(string)

MonoBehaviour.StopAllCoroutines()

MonoBehaviour.print(object)

MonoBehaviour.destroyCancellationToken

MonoBehaviour.useGUILayout

MonoBehaviour.didStart

MonoBehaviour.didAwake

MonoBehaviour.runInEditMode

Behaviour.enabled

Behaviour.isActiveAndEnabled

Component.GetComponent(Type)

Component.GetComponent<T>()

Component.TryGetComponent(Type, out Component)

Component.TryGetComponent<T>(out T)

Component.GetComponent(string)

Component.GetComponentInChildren(Type, bool)

Component.GetComponentInChildren(Type)

Component.GetComponentInChildren<T>(bool)

Component.GetComponentInChildren<T>()

Component.GetComponentsInChildren(Type, bool)

Component.GetComponentsInChildren(Type)

Component.GetComponentsInChildren<T>(bool)

Component.GetComponentsInChildren<T>(bool, List<T>)

Component.GetComponentsInChildren<T>()

Component.GetComponentsInChildren<T>(List<T>)

Component.GetComponentInParent(Type, bool)

Component.GetComponentInParent(Type)

Component.GetComponentInParent<T>(bool)

Component.GetComponentInParent<T>()

Component.GetComponentsInParent(Type, bool)

Component.GetComponentsInParent(Type)

Component.GetComponentsInParent<T>(bool)

Component.GetComponentsInParent<T>(bool, List<T>)

Component.GetComponentsInParent<T>()

Component.GetComponents(Type)

Component.GetComponents(Type, List<Component>)

Component.GetComponents<T>(List<T>)

Component.GetComponents<T>()

Component.GetComponentIndex()

Component.CompareTag(string)

Component.CompareTag(TagHandle)

Component.SendMessageUpwards(string, object, SendMessageOptions)

Component.SendMessageUpwards(string, object)

Component.SendMessageUpwards(string)

Component.SendMessageUpwards(string, SendMessageOptions)

Component.SendMessage(string, object)

Component.SendMessage(string)

Component.SendMessage(string, object, SendMessageOptions)

Component.SendMessage(string, SendMessageOptions)

Component.BroadcastMessage(string, object, SendMessageOptions)

Component.BroadcastMessage(string, object)

Component.BroadcastMessage(string)

Component.BroadcastMessage(string, SendMessageOptions)

Component.transform

Component.transformHandle

Component.gameObject

Component.tag

Object.GetEntityId()

Object.GetHashCode()

Object.Equals(object)

Object.InstantiateAsync<T>(T)

Object.InstantiateAsync<T>(T, Transform)

Object.InstantiateAsync<T>(T, Vector3, Quaternion)

Object.InstantiateAsync<T>(T, Transform, Vector3, Quaternion)

Object.InstantiateAsync<T>(T, int)

Object.InstantiateAsync<T>(T, int, Transform)

Object.InstantiateAsync<T>(T, int, Vector3, Quaternion)

Object.InstantiateAsync<T>(T, int, ReadOnlySpan<Vector3>, ReadOnlySpan<Quaternion>)

Object.InstantiateAsync<T>(T, int, Transform, Vector3, Quaternion)

Object.InstantiateAsync<T>(T, int, Transform, Vector3, Quaternion, CancellationToken)

Object.InstantiateAsync<T>(T, int, Transform, ReadOnlySpan<Vector3>, ReadOnlySpan<Quaternion>)

Object.InstantiateAsync<T>(T, int, Transform, ReadOnlySpan<Vector3>, ReadOnlySpan<Quaternion>, CancellationToken)

Object.InstantiateAsync<T>(T, InstantiateParameters, CancellationToken)

Object.InstantiateAsync<T>(T, int, InstantiateParameters, CancellationToken)

Object.InstantiateAsync<T>(T, Vector3, Quaternion, InstantiateParameters, CancellationToken)

Object.InstantiateAsync<T>(T, int, Vector3, Quaternion, InstantiateParameters, CancellationToken)

Object.InstantiateAsync<T>(T, int, ReadOnlySpan<Vector3>, ReadOnlySpan<Quaternion>, InstantiateParameters, CancellationToken)

Object.Instantiate(Object, Vector3, Quaternion)

Object.Instantiate(Object, Vector3, Quaternion, Transform)

Object.Instantiate(Object)

Object.Instantiate(Object, Scene)

Object.Instantiate<T>(T, InstantiateParameters)

Object.Instantiate<T>(T, Vector3, Quaternion, InstantiateParameters)

Object.Instantiate(Object, Transform)

Object.Instantiate(Object, Transform, bool)

Object.Instantiate<T>(T)

Object.Instantiate<T>(T, Vector3, Quaternion)

Object.Instantiate<T>(T, Vector3, Quaternion, Transform)

Object.Instantiate<T>(T, Transform)

Object.Instantiate<T>(T, Transform, bool)

Object.Destroy(Object, float)

Object.Destroy(Object)

Object.DestroyImmediate(Object, bool)

Object.DestroyImmediate(Object)

Object.FindObjectsByType(Type)

Object.FindObjectsByType(Type, FindObjectsInactive)

Object.DontDestroyOnLoad(Object)

Object.FindAnyObjectByType<T>()

Object.FindAnyObjectByType<T>(FindObjectsInactive)

Object.FindObjectsByType<T>()

Object.FindObjectsByType<T>(FindObjectsInactive)

Object.FindAnyObjectByType(Type)

Object.FindAnyObjectByType(Type, FindObjectsInactive)

Object.ToString()

Object.name

Object.hideFlags

object.Equals(object, object)

object.GetType()

object.ReferenceEquals(object, object)

Namespace: Scylla.Core

Assembly: ScyllaCore.dll

Syntax

public sealed class ScyllaBootstrap : MonoBehaviour

Remarks

Attach this component to a root GameObject in your initial scene. All Scylla modules must be placed as direct child GameObjects of this bootstrap GameObject (one module per child). Modules auto-register with the framework during their Awake() calls, and the bootstrap triggers full framework initialization after a configurable delay (see InitializationDelay) to ensure all modules have had time to register.

This class enforces a singleton pattern: only one ScyllaBootstrap instance may exist at a time. Duplicate instances are automatically destroyed with an error log. The singleton reference is accessible via Instance.

Configuration is resolved through a three-tier fallback strategy for each subsystem (core, logger, time): first the Inspector-assigned UnityEngine.ScriptableObject asset, then a default asset loaded from Resources, and finally built-in default values if neither is available.

Properties

CoreConfiguration

Gets the active core configuration for this bootstrap, resolving through a three-tier fallback: first the Inspector-assigned ScyllaCoreConfiguration asset, then a default asset loaded via LoadDefault() from Resources, and finally null if neither is available (in which case built-in default values are used).

Declaration

public ScyllaCoreConfiguration CoreConfiguration { get; }

Property Value

Type	Description
ScyllaCoreConfiguration	The resolved ScyllaCoreConfiguration, or `null` if no configuration asset is assigned and none could be loaded from Resources.

EventConfiguration

Gets the active event configuration for this bootstrap, resolving through a three-tier fallback: first the Inspector-assigned ScyllaEventConfiguration asset, then a default asset loaded via LoadDefault() from Resources, and finally null if neither is available (in which case built-in default event settings are used).

Declaration

public ScyllaEventConfiguration EventConfiguration { get; }

Property Value

Type	Description
ScyllaEventConfiguration	The resolved ScyllaEventConfiguration, or `null` if no configuration asset is assigned and none could be loaded from Resources.

Framework

The ScyllaCore instance that this bootstrap created and manages. Provides access to the module manager, framework state, and core services. This property is set during Scylla.Core.ScyllaBootstrap.Awake() and remains valid until the bootstrap is destroyed.

Declaration

public ScyllaCore Framework { get; }

Property Value

Type	Description
ScyllaCore	The active ScyllaCore singleton, or `null` if the bootstrap has not yet awakened or was destroyed due to being a duplicate instance.

HasCoreConfiguration

Indicates whether a ScyllaCoreConfiguration asset is actively in use, either from the Inspector assignment or from a default asset loaded from Resources.

Declaration

public bool HasCoreConfiguration { get; }

Property Value

Type	Description
bool	`true` if CoreConfiguration returns a non-null configuration; otherwise `false`, meaning the framework will use built-in default values for core settings.

HasEventConfiguration

Indicates whether a ScyllaEventConfiguration asset is actively in use, either from the Inspector assignment or from a default asset loaded from Resources.

Declaration

public bool HasEventConfiguration { get; }

Property Value

Type	Description
bool	`true` if EventConfiguration returns a non-null configuration; otherwise `false`, meaning the framework will use built-in default event settings.

HasLoggerConfiguration

Indicates whether a ScyllaLoggerConfiguration asset is actively in use, either from the Inspector assignment or from a default asset loaded from Resources.

Declaration

public bool HasLoggerConfiguration { get; }

Property Value

Type	Description
bool	`true` if LoggerConfiguration returns a non-null configuration; otherwise `false`, meaning the framework will use built-in default log settings.

HasSceneConfiguration

Indicates whether a ScyllaSceneConfiguration asset is actively in use, either from the Inspector assignment or from a default asset loaded from Resources.

Declaration

public bool HasSceneConfiguration { get; }

Property Value

Type	Description
bool	`true` if SceneConfiguration returns a non-null configuration; otherwise `false`, meaning the framework will use built-in default scene settings.

HasTimeConfiguration

Indicates whether a ScyllaTimeConfiguration asset is actively in use, either from the Inspector assignment or from a default asset loaded from Resources.

Declaration

public bool HasTimeConfiguration { get; }

Property Value

Type	Description
bool	`true` if TimeConfiguration returns a non-null configuration; otherwise `false`, meaning the framework will use built-in default time settings.

Instance

The singleton instance of ScyllaBootstrap, providing global access to the active bootstrap and its Framework reference. Only one instance may exist at a time; duplicates are destroyed during Scylla.Core.ScyllaBootstrap.Awake(). The reference is cleared when the instance is destroyed (see Scylla.Core.ScyllaBootstrap.OnDestroy()).

Declaration

public static ScyllaBootstrap Instance { get; }

Property Value

Type	Description
ScyllaBootstrap	The active ScyllaBootstrap instance, or `null` if no bootstrap exists in the scene.

LoggerConfiguration

Gets the active logger configuration for this bootstrap, resolving through a three-tier fallback: first the Inspector-assigned ScyllaLoggerConfiguration asset, then a default asset loaded via LoadDefault() from Resources, and finally null if neither is available (in which case built-in default log settings are used).

Declaration

public ScyllaLoggerConfiguration LoggerConfiguration { get; }

Property Value

Type	Description
ScyllaLoggerConfiguration	The resolved ScyllaLoggerConfiguration, or `null` if no configuration asset is assigned and none could be loaded from Resources.

SceneConfiguration

Gets the active scene configuration for this bootstrap, resolving through a three-tier fallback: first the Inspector-assigned ScyllaSceneConfiguration asset, then a default asset loaded via LoadDefault() from Resources, and finally null if neither is available (in which case built-in default scene settings are used).

Declaration

public ScyllaSceneConfiguration SceneConfiguration { get; }

Property Value

Type	Description
ScyllaSceneConfiguration	The resolved ScyllaSceneConfiguration, or `null` if no configuration asset is assigned and none could be loaded from Resources.

TimeConfiguration

Gets the active time configuration for this bootstrap, resolving through a three-tier fallback: first the Inspector-assigned ScyllaTimeConfiguration asset, then a default asset loaded via LoadDefault() from Resources, and finally null if neither is available (in which case built-in default time settings are used).

Declaration

public ScyllaTimeConfiguration TimeConfiguration { get; }

Property Value

Type	Description
ScyllaTimeConfiguration	The resolved ScyllaTimeConfiguration, or `null` if no configuration asset is assigned and none could be loaded from Resources.

Methods

InitializeFramework()

Initializes the Scylla framework by validating the module hierarchy, resolving module dependencies, and starting all registered ScyllaModule instances through the ScyllaCore lifecycle pipeline. This method is automatically invoked by Scylla.Core.ScyllaBootstrap.Start() after the configured initialization delay, but may also be called manually for custom startup flows.

Declaration

public void InitializeFramework()

Remarks

This method is idempotent: calling it when the framework is already initialized logs a warning and returns without side effects. If Framework is null (e.g., due to a failed Scylla.Core.ScyllaBootstrap.Awake()), an error is logged and initialization is skipped.

A final module hierarchy validation is performed immediately before initialization to catch modules that were added or activated after Scylla.Core.ScyllaBootstrap.Awake(). If validation fails, the bootstrap enters a fatal error state and no further initialization occurs.

If a ScyllaModuleException is thrown during initialization (e.g., due to missing required dependencies or circular references), the error is logged as fatal and the application is terminated -- in the Editor by stopping play mode, at runtime by calling Application.Quit().

Exceptions

Type	Condition
ScyllaModuleException	Caught internally. Thrown by the module system when dependency validation or module initialization fails. Results in application termination rather than propagation.

ShutdownFramework()

Shuts down the Scylla framework gracefully. This method triggers ShutdownFramework() to finalize all registered modules (calling their shutdown callbacks in reverse initialization order) and then shuts down the ScyllaTime service. Safe to call multiple times or when Framework is null (no-op in both cases).

Declaration

public void ShutdownFramework()

Remarks

Automatically called from Scylla.Core.ScyllaBootstrap.OnApplicationQuit(). Can also be invoked manually for controlled teardown scenarios such as scene transitions or hot-reload workflows. ScyllaTime and ScyllaSceneManager are shut down unconditionally (both are null-safe when not initialized): they can come up live even when a fatal setup error left Framework unassigned, so gating their shutdown on it would leak them. The subsystem one-shot guard is cleared so a subsequent bootstrap Awake re-initializes them; logging configuration is intentionally left in place (see Scylla.Core.ScyllaBootstrap._loggingConfigured).