Teleport Hybrid Pro Script

Description

USER GUIDE: TELEPORT (HYBRID PRO) Version 1.7.2 ________________________________________ 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. - Optional hover hint text can display the destination name for visitors. 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. ------------------------------