Teleport Hotkeys

Example Script: Teleport Hotkeys

This example script, Teleport Hotkeys (TeleportHotkeys.cs), allows you to set hotkeys that teleport users to another experience when pressed.

Instructions

Here is a step-by-step guide to using the script:

  1. Download the script file from the download link at the end of this article.

  2. Follow the instructions provided in Working with scripts to upload the script and add it to an object.

  3. Open the object's Properties panel and go to the Script Settings section.

  4. Upon looking at the Script Settings section for TeleportHotkeys, you will see a list of parameters which you can set for the object. Setting values on these parameters can help you set the teleport hotkey and experience destination. See the section on Script Parameters for a full listing of parameters.

  5. Set a TeleportHotkey that will be used to trigger the script.

  6. To grab the experience name and Avatar ID of the experience that you want as a teleport location, go to the details page of the the experience that you want to designate.

  7. Once you are on the experience details page, click Copy URL on the bottom left corner of the details page. This opens a new window which shows the experience's URL, where you can copy the Experience name and the creator's Avatar ID (Persona Handle) as seen below.

    Access the experience URL to access the Avatar ID (aka Persona Handle) and Experience name.

  8. Once you have finished setting the parameters for your object, your script is ready! Save and build your scene.

  9. If you want to verify that the script is running correctly, visit the scene once it has been built.

Script parameters

TeleportHotkey

Designate a hotkey that will trigger the teleport script to run and transfer the user to the designated experience. You can choose from the list of keyboard and gamepad buttons below.

Experiences

Designate the name of the designated experience that you want your users to teleport to when the TeleportHotkey is triggered.

PersonaHandle

To properly direct your users to the correct experience, you must also grab the creator's Avatar ID (aka Persona Handle) from the Experience's URL.

Parameters for TeleportHotkey

Keyboard Buttons

  • Key_W

  • Key_A

  • Key_S

  • Key_D

  • Key_Space

  • Key_F

  • Key_1

  • Key_2

  • Key_3

  • Key_4

  • Key_5

  • Key_6

  • Key_7

  • Key_8

  • Key_9

  • Key_0

  • Key_F1

  • Key_F2

  • Key_F3

  • Key_F4

  • Key_F5

  • Key_F6

  • Key_F7

  • Key_F8

  • Key_F9

  • Key_F10

  • Key_F11

  • Key_F12

Gamepad Buttons

  • Gamepad_DpadUp

  • Gamepad_DpadDown

  • Gamepad_DpadLeft

  • Gamepad_DpadRight

  • Gamepad_SmallLeft // Xbox: Back, PS: Select

  • Gamepad_SmallRight // Xbox: Start, PS: Start

  • Gamepad_LeftThumb

  • Gamepad_RightThumb

  • Gamepad_LeftShoulder

  • Gamepad_RightShoulder

  • Gamepad_ButtonLeft // Xbox: X, PS: Square

  • Gamepad_ButtonTop // Xbox: Y, PS: Triangle

  • Gamepad_ButtonRight // Xbox: B, PS: Circle

  • Gamepad_ButtonBottom // Xbox: A, PS: X

  • Gamepad_Extra1

  • Gamepad_Extra2

Creative Commons License

Have more questions? Join our Discord!

PreviousStats ExampleNextVisitor Tracker

Last updated