> ## 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 — VR SDK

> Scenario, session, player, steps, scoring, tour, and VR-specific flows.

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

## Scenario / session

* **Symptom:** `CreateSessionAsync` fails or scene never starts\
  **Check:** auth token, org scenario id, network config assets, and scenario data mapping.\
  **Refs:** [Session loading and events](/vr/session-loading-and-events), [Scenario Data Config](/setup/scenario-data-config), [VR session flow (how-to)](/setup/vr-session-flow-how-to)\
  **Recipe:** See [Set up a VR scenario from scratch](/recipes/setup-vr-scenario) for step-by-step guidance

## VR locomotion and player

* **Symptom:** movement still works when it should be off, or `VRPlayerManager` errors about missing subsystem\
  **Check:** Locomotion providers must live under the XR rig; `WaitForInitialization` completed; only one `VRPlayerManager` instance.\
  **Refs:** [VR player manager](/vr/vr-player-manager), [Grab step](/vr/steps/grab-step)

## VR fade and scene loads

* **Symptom:** black flash twice, or fade never clears after session-driven load\
  **Check:** Call `SkipNextAutoFade` when a loader already fades; assign fade material with `_FadeAmount`.\
  **Refs:** [VR fade manager](/vr/vr-fade-manager)

## VR inventory

* **Symptom:** toggle does nothing, items never store\
  **Check:** `InputActionReference` assigned and enabled; release grab within hover distance; free slot exists; optional `VRInventorySubsystem` for persistence.\
  **Refs:** [VR inventory manager](/vr/vr-inventory-manager)

## VR steps (common)

* **Symptom:** grab step never completes\
  **Check:** `XRGrabInteractable` assigned or auto-found; `completeOnGrab` vs `completeOnRelease`; interactor and position rules.\
  **Refs:** [Grab step](/vr/steps/grab-step)\
  **Recipe:** See [Set up a VR scenario from scratch](/recipes/setup-vr-scenario) for step-by-step guidance

* **Symptom:** teleport step never advances sequence\
  **Check:** Stock `TeleportStep` may not call `Complete()` — patch handler or use another step type.\
  **Refs:** [Teleport step](/vr/steps/teleport-step)

* **Symptom:** valve/knob step stuck\
  **Check:** `SceneObjectReference` resolves `ValveInteraction` / `KnobInteraction`; target angle within clamp; lock and feedback UI refs.\
  **Refs:** [Valve step](/vr/steps/valve-step), [Knob step](/vr/steps/knob-step)\
  **Recipe:** See [Implement custom VR interactions](/recipes/implement-custom-vr-interaction) for step-by-step guidance

## VR scoring and session posts

* **Symptom:** step score always zero or never posted\
  **Check:** `ScoringType` not `None`; for binary use `SetCorrect` / `SetIncorrect`; session active and org IDs present in scenario data.\
  **Refs:** [Scoring config](/vr/scoring/scoring-config), [Step scoring auxiliary](/vr/scoring/step-scoring-auxiliary), [Session loading and events](/vr/session-loading-and-events)\
  **Recipe:** See [Add scoring to VR activities](/recipes/add-vr-activity-scoring) for step-by-step guidance

## VR tour

* **Symptom:** area transition fails, POI layout broken\
  **Check:** `TourScenarioData` and Addressables scene names; `POIManager` on VR side if applicable; `TeleportationAnchor` on spots.\
  **Refs:** [Tour subsystem](/vr/tour/tour-subsystem), [Tour areas and spots](/vr/tour/tour-area-and-spots)

## Related

* [Troubleshooting hub](/overview/troubleshooting)
* [Scenario manager](/vr/scenario-manager)
* [Session authentication](/vr/session-authentication)