Troubleshooting — VR SDK

​

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, Scenario Data Config, VR session flow (how-to)

​

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, 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 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 steps (common)

• Symptom: grab step never completes
  Check: XRGrabInteractable assigned or auto-found; completeOnGrab vs completeOnRelease; interactor and position rules.
  Refs: Grab step
• Symptom: teleport step never advances sequence
  Check: Stock TeleportStep may not call Complete() — patch handler or use another step type.
  Refs: Teleport step
• Symptom: valve/knob step stuck
  Check: SceneObjectReference resolves ValveInteraction / KnobInteraction; target angle within clamp; lock and feedback UI refs.
  Refs: Valve step, Knob step

​

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, Step scoring auxiliary, Session loading and events

​

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, Tour areas and spots

​

Related

• Troubleshooting hub
• Scenario manager
• Session authentication