Teleport Hybrid Pro Script

USER GUIDE: TELEPORT (HYBRID PRO)

Version 1.7.1
________________________________________
OVERVIEW
The "Teleport (Hybrid Pro)" script lets visitors teleport to another Sansar experience or to a specific location in the same scene. It's easy to configure, no scripting skills needed.

Main features:
- Trigger teleportation by click or by entering a volume.
- Optional confirmation popup with Yes/No.
- Teleport to a different world or to a local spot.
- Optional sound playback on teleport, with configurable repeats, duration, and loudness.
- Single anti-spam cooldown for both click and trigger activations.
- Customizable text and behavior through the properties panel.
________________________________________
HOW TO USE IT

1. Add the script to an object:
- In Build mode, select an object.
- In the "Script" section, add "Teleport (Hybrid Pro)" from your inventory.

2. Configure the properties:
• UseClick
- True: click activation (shows the button).
- False: collision/trigger activation (no button).

• CooldownSeconds
- Sets a global cooldown in seconds for both click and trigger.

• TeleportWorld
- True: teleport to a different experience (using DestinationUrl).
- False: teleport within the current scene (using DestinationPos and DestinationFwd).

• DestinationUrl
- Paste the Atlas URL of the Sansar world to teleport to.
- Example: https://atlas.sansar.com/experiences/morganeparis/mpp-mainstore

• DestinationPos
- Set the X, Y, Z coordinates for a local teleport.

• DestinationFwd
- Set the rotation X, Y, Z. Use <0,0,0> to keep the user’s current heading.

• LocationName
- Name shown in the confirmation popup.

• ButtonLabel
- Text shown on the clickable object.

• RequireConfirmation
- True: shows the confirmation popup (Yes/No).
- False: teleport happens instantly, no popup.

• PlaySound
- True: plays a sound effect after confirmation.

• TeleportSound
- Select a sound asset from inventory.

• SoundRepeat
- Number of times to repeat the teleport sound.

• SoundDurationSec
- Duration in seconds for each sound repeat.

• SoundLoudnessPercent
- Playback volume (0 = mute, 100 = original loudness, up to 200).

• TeleportDelaySec
- Delay in seconds before teleport if no sound is played.
________________________________________
EXAMPLES

To teleport to another world:
- Set TeleportWorld to true
- Provide the destination URL

To teleport within the same scene:
- Set TeleportWorld to false
- Provide DestinationPos and DestinationFwd

To choose activation method:
- Set UseClick to true for click
- Set to false for trigger/collision
________________________________________
TIPS FOR CREATORS

- Use meaningful LocationName values to inform your visitors.
- Test all settings in Visitor mode.
- Duplicate and configure objects for unique destinations or different behaviors.
________________________________________
Changelog

v1.7:
- Unified cooldown now applies to both click and trigger activation.
- Added volume control for teleport sound.
v1.6:
- Option to disable confirmation popup.
- Looped sound playback and custom sound duration.
v1.5:
- Introduced anti-spam cooldown for trigger collisions.
- Added teleport delay after confirmation for sound playback.
v1.4:
- First release version

Useful Links:
- Teleporter - Pad: https://store.sansar.com/listings/ed49b5c4-cff6-4144-b831-a0798515445b/teleporter-pad---unscripted
- Teleport - Sound: https://store.sansar.com/listings/ec6e965f-311c-44e0-a32c-069d1cdc3f71/teleportation-sound---airplane-seatbelt-beep

------------------------------

Enjoy and Keep Good Vibes.
Hugs from Morgane.

------------------------------