> ## 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 — Shared module

> GameManager, media, preload, and AuthUI patterns in _MolcaSDK Code.

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

## Connection UX (GameManager)

* **Symptom:** connection errors never show a modal\
  **Check:** `GameManager` flag and `connectionFailConfirmation`; `HttpClient.OnConnectionError` actually raised.\
  **Refs:** [Game manager](/shared/game-manager), [Http client](/core/http-client)

## Media loading

* **Symptom:** `MediaLoader.GetTexture` always null\
  **Check:** User logged in (`AuthManager`); `HttpRequestAsset` assigned; URL non-empty; bump cache `version` if stale.\
  **Refs:** [Media system](/shared/media-system)

## Preload gates

* **Symptom:** preload gate skipped or hang on splash\
  **Check:** Each entry in `customChecks` implements `IPreloadCheck`; splash `CanvasGroup` refs valid.\
  **Refs:** [Preload checks](/shared/preload-checks)

## Auth UI vs VR session

* **Symptom:** flat login works in VR sample but not your scene — or wrong API for product\
  **Check:** Shared `AuthUI` uses `AuthManager`, not `ScenarioSessionManager`; scene name `SharedString` and `AuthEvents.LoggedIn`.\
  **Refs:** [Auth UI](/shared/auth-ui), [Session authentication](/vr/session-authentication)

## Related

* [Troubleshooting hub](/overview/troubleshooting)
* [Shared modals](/shared/modals)
* [UI widgets](/shared/ui-widgets)