Skip to main content
Back to Troubleshooting hub.

​
Runtime bootstrap

  • Symptom: services/subsystems are null in Start
    Check: call await RuntimeManager.WaitForInitialization() before resolving services.
    Refs: RuntimeManager, Dependency injection

​
Dependency injection

  • Symptom: [Inject] field remains null
    Check: service is registered and target instance is part of scene injection pass, or call RuntimeManager.InjectInto / InjectDependencies on runtime-created objects after init.
    Refs: Dependency injection, Runtime subsystem

​
Localization

  • Symptom: language changes but UI text does not update
    Check: LocalizationManager exists on RuntimeManager, LocalizedText is bound to valid LocalizedString, and module languages are configured.
    Refs: Localization, Global Settings

​
Color / theming

  • Symptom: UI colors don’t update after theme switch
    Check: ColorModule is configured, ColorID references valid swatch/id, and scheme switching uses ColorSchemeManager.SetScheme(...).
    Refs: ColorID, UI widgets

​
Data / HTTP (Core)

  • Symptom: requests succeed but view is stale
    Check: subscribe to update events and verify provider registration in DataManager; ensure request asset points to active base URL.
    Refs: HttpClient, Data manager

​
Content packages (Addressables)

  • Symptom: PackageSubsystem / PackageService null
    Check: RuntimeManager prefab includes package subsystem; WaitForInitialization; global ContentPackageSettings.
    Refs: Content packages, Runtime manager

​
Events (pub/sub)

  • Symptom: handler never runs or duplicate calls
    Check: Same EventDispatcher instance; unregister on destroy; event name constant matches.
    Refs: Event dispatcher