Store Listing Opener Script

Description

Version 1.3.1 Deliver a seamless shopping experience: convert any in-world object into a direct link to its Sansar Store listing. Paste the full listing link (or the listing UUID alone), Build, and a click opens the built-in Store panel of that listing for the visitor. Perfect for virtual showrooms, gallery displays and event booths. The same opener can be driven by an MPP - Action Button, for a "Buy" button on a control desk. No scripting skills needed. New in 1.3: a per-visitor cooldown (0.75 s by default) with a private "please wait" message for a click that comes too soon; the listing opens first, then the sound plays; the link is checked once at start, with a clear warning when it is not usable (the object is then not clickable, instead of a dead button); Sound Volume 0 is silent; the hover text is kept to one line. Settings grouped by category and a Debug Logging switch. Fully standalone; works with MPP - Action Button. ________________________________________ Key Features Listing • Paste the full Store link, or the listing UUID alone: the UUID is extracted for you • A link without a UUID (an Atlas link, for example) opens as a location detail view Activation • Click on the object, with your own hover text ("View Details", "Buy Now"...) • Or a Script Event sent by MPP - Action Button: the listing opens for whoever pressed the button • Per-visitor cooldown (0 to 60 s) with a private "please wait" message showing the remaining time, customizable or silent; a silent double-click protection always remains Sound • Optional sound played at the object when the listing opens, volume 0 to 200 % (0 = silent) ________________________________________ Technical Details • 11 settings in four groups: Activation, Listing, Sound, Debug • The listing opens before the sound plays; a listing refused by Sansar for a moment is reported in the script console • An empty or unusable link gives a warning at start and no interaction (no hover text, no click, no event) • One event name per opener: give each opener its own • Optional Debug Logging with the avatar handle and UUID of every opening and refusal ________________________________________ Example Uses • A product that opens its own listing in a showroom • A poster wall, one poster per product • A "Buy" button on an Action Button control desk • Event booths and gallery displays ________________________________________ Full documentation online: https://mpp-mainstore.com/sansar/StoreListingOpener/ ________________________________________ Updating from 1.2 • Your settings are kept when you update the script: the 8 settings keep their values, only their labels change and move into groups. Take a screenshot of the Build panel first, update one opener and check it before doing the others. • Three new settings at their defaults: Cooldown Seconds (0.75), Cooldown Notice (on), Cooldown Notice Text. • What changes: a second click of the same visitor within 0.75 s is ignored with the "please wait" message; the sound plays after the listing opened; a value without a UUID that is not an http(s) link now gives a warning and no interaction; Sound Volume 0 is silent. Changelog — Version 1.3.1 • Version number only. Changelog — Version 1.3.0 • Per-visitor cooldown with a private "please wait" message (customizable, or silent). • The listing opens first, the sound plays only when it did. • Link checked once at start: unusable value = warning and no interaction. • Sound Volume 0 = no sound; hover text kept to one line of 128 characters. • Guarded calls; the Script Event avatar lookup no longer fails when someone leaves. • Settings grouped by category, Debug Logging. Changelog — Version 1.2 • ActionButton / ScriptEvent compatibility, optional ScriptEvent trigger mode. Changelog — Version 1.1 • New Sansar Store link format, UUID alone accepted, fallback for other links. Changelog — Version 1.0 • First release. Useful Links: • Action Button Script: https://www.sansar.com/store/listings/3e1a3546-6c79-4527-bc1e-78d02648d19e/action-button-script ________________________________________ Enjoy and Keep Good Vibes. Hugs from Morgane. ________________________________________