> ## Documentation Index
> Fetch the complete documentation index at: https://docs-unity.molca.id/llms.txt
> Use this file to discover all available pages before exploring further.

# Troubleshooting — Core & setup

> Bootstrap, DI, localization, UI shell, networking, content packages, and events.

Back to [Troubleshooting hub](/overview/troubleshooting).

## Runtime bootstrap

* **Symptom:** services/subsystems are null in `Start`\
  **Check:** call `await RuntimeManager.WaitForInitialization()` before resolving services.\
  **Refs:** [RuntimeManager](/core/runtime-manager), [Dependency injection](/core/dependency-injection)\
  **Recipe:** See [Implement dependency injection in custom components](/recipes/implement-dependency-injection) for step-by-step guidance

## 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](/core/dependency-injection), [Runtime subsystem](/core/runtime-subsystem)\
  **Recipe:** See [Implement dependency injection in custom components](/recipes/implement-dependency-injection) for step-by-step guidance

## 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](/core/localization), [Global Settings](/setup/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](/core/color-id), [UI widgets](/shared/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](/core/http-client), [Data manager](/core/data-manager)\
  **Recipe:** See [Integrate HTTP requests with data persistence](/recipes/integrate-http-data-persistence) for step-by-step guidance

## Content packages (Addressables)

* **Symptom:** `PackageSubsystem` / `PackageService` null\
  **Check:** RuntimeManager prefab includes package subsystem; `WaitForInitialization`; global `ContentPackageSettings`.\
  **Refs:** [Content packages](/core/content-packages), [Runtime manager](/core/runtime-manager)\
  **Recipe:** See [Load and use content packages](/recipes/load-content-packages) for step-by-step guidance

## Events (pub/sub)

* **Symptom:** handler never runs or duplicate calls\
  **Check:** Same `EventDispatcher` instance; unregister on destroy; event name constant matches.\
  **Refs:** [Event dispatcher](/core/event-dispatcher)\
  **Recipe:** See [Create and dispatch custom events](/recipes/create-custom-events) for step-by-step guidance

## Related

* [Troubleshooting hub](/overview/troubleshooting)
* [Molca project settings](/setup/molca-project-settings)