Troubleshooting — Core & setup

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.

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
  Recipe: See Implement dependency injection in custom components 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, Runtime subsystem
  Recipe: See Implement dependency injection in custom components 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, 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
  Recipe: See Integrate HTTP requests with 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, Runtime manager
  Recipe: See Load and use 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
  Recipe: See Create and dispatch custom events for step-by-step guidance

​

Related

• Troubleshooting hub
• Molca project settings