Develop
Develop
Select your platform

Teleport to a Plane

Updated: Nov 6, 2025
In this tutorial, you will learn how to use Interaction SDK locomotion interactions to teleport to a location on a ground plane in your Unity scene using your hands or controllers. This is generally useful to allow the user to freely teleport within the world, while layering specialized areas - such as hotspots - and areas where teleporting should not be allowed on top. This guide assumes you have a scene set up with a camera rig configured for interactions. If you do not have a camera rig set up, you can add one by following the instructions in the Create Comprehensive Rig guide.

Add a Plane Teleport Target

To teleport, you need to add a teleport interactable. To freely teleport within the scene, you can use any Transform as the target and use the Plane teleport type, which enables the user to teleport to any location on an XZ-plane locally-aligned to the target transform.
  1. Right-click on the transform you want to use as a target and select Interaction SDK > Add Teleport Interaction. The Teleport wizard appears.
    The Teleport Wizard
  2. In the Teleport wizard, set the Interaction Type to Plane. This will set the selected plane object as a target for teleportation.
    The Plane type option
  3. If you want to further customize the interaction, adjust the interaction’s settings in the wizard. For details on the available options, please see the Teleport Quick Action documentation.
  4. Select Create. The wizard automatically adds the required components for the interaction to the GameObject. It also adds components to the camera rig if those components weren’t already there.
    The automatically added GameObjects for a teleport interaction.

Test your Interaction

Use Link to test your project.
  1. Open the Link desktop application on your computer.
  2. Put on your headset, and, when prompted, enable Link.
  3. On your development machine, in Unity Editor, select the Play button.
  4. Tap your thumb against the side of the index or press the joystick forward on your controllers. A ray is emitted from your hands or controllers. Aim it at the teleportable area designated by the ground plane and either tap your thumb again (if using hands) or release the joystick (if using controllers), to teleport to that location.

Test your Interaction

Build your project into an .apk to test your project.
  1. Make sure your headset is connected to your development machine.
  2. In Unity Editor, select File > Build Settings. Add your scene to the Scenes In Build list by dragging it from the Project panel or clicking Add Open Scenes.
  3. Click Build and Run to generate an .apk and run it on your headset. In the File Explorer that opens, select a location to save the .apk to and give it a name. The build process may take a few minutes.
  4. Tap your thumb against the side of the index or press the joystick forward on your controllers. A ray is emitted from your hands or controllers. Aim it at the teleportable area designated by the ground plane and either tap your thumb again (if using hands) or release the joystick (if using controllers), to teleport to that location.

Learn more

Design guidelines

Did you find this page helpful?