> ## 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.

# TeleportStep

> Teleport event hook (stock SDK may require a patch to call Complete).

**File:** `Assets/_MolcaSDK/_VR/Scripts/Scenario/Steps/TeleportStep.cs`\
**Base:** [Step](/core/step)

## When to use

Use `Teleport Step` when a VR training scenario needs this specific interaction as a step in a sequence. Configure entirely in the Inspector — no code required.

## Role

Subscribes to **`TeleportingEvent`** while active; handler currently **logs** the destination only. **Does not call `Complete()` in the SDK version**— treat as a stub or extend locally.

## Code

Assign **`teleportingEvent`** from your XR teleport/locomotion stack. Stock **`OnTeleportRequest`** only logs — fork or patch so the handler completes the step, for example:

```csharp theme={null}
private void OnTeleportRequest(TeleportingEventArgs args)
{
    Debug.Log("Teleporting to " + args.teleportRequest.destinationPosition);
    Complete();
}
```

Until **`Complete()`** runs from that callback (or a custom **`Step`**), the **sequence will not advance**.

## Troubleshooting

* **Step never completes** — Expected with stock **`TeleportStep.cs`**: add **`Complete()`** in the teleport callback or replace with a custom **`Step`**.
* **Null reference** — Assign **`teleportingEvent`** reference from your locomotion/teleport setup.
* **Multiple teleports** — Decide whether first teleport only should complete (track a bool before calling **`Complete()`**).

## Related

* [VR player manager](/vr/vr-player-manager) — locomotion providers
* [Step (base class)](/core/step)

## Unity Editor

<Frame hint="TeleportStep on player rig or training volume." caption="TeleportStep Inspector">
  <img src="https://mintlify.s3.us-west-1.amazonaws.com/ptmolcateknologinusantara/images/features/vr/steps/teleport-step-inspector.png" alt="TeleportStep in Unity Inspector" />
</Frame>
