MPP - Open Creator Store Script V1.1.1 - Documentation

Opens a creator's Sansar Store page from your scene: a click on the object opens the store of the creator whose handle you enter, for the visitor who clicked. Promote your own store, feature a partner, or let visitors discover the creators of your build. An optional click sound plays at the object.

This script is standalone - it does not require any other MPP script to function.

New in V1.1: the setting takes the creator handle (the name in the profile link), a leading @ is ignored, and a wrong-looking value gets a warning in the script console; an empty handle leaves the object without a click instead of a dead button; a silent one-second anti double-click per visitor; Sound Volume 0 is silent; the store opens even when the sound fails. Settings labelled and grouped, and a Debug Logging switch. V1.1.1 only changes the version number. Your settings are kept when you update: see "Updating from V1.0".

Quick Start

1. After purchase, the script is in your Inventory in Build mode. Add it to a sign, a shop front, a logo.
2. In Store/Creator Handle, enter the creator's handle: the last part of their profile link https://www.sansar.com/profiles/<handle>. The default is MorganeParis.
3. Build and visit: hover the object ("MorganeParis's Store"), click it, the creator's store opens.

That is all. The rest of this guide details every option.

How It Works

• The hover text is built from the handle: "<handle>'s Store".
• A click plays Sound/Click Sound at the object (everyone nearby hears it), then opens the creator's store for the visitor who clicked.
• A second click of the same visitor within one second is ignored, in silence: the store is already open for them. Other visitors are never blocked.

In the Build panel the settings are grouped by category: Store/, Sound/ and Debug/.

The Creator Handle

Store/Creator Handle is the creator's handle, as in the profile link, not the display name: for https://www.sansar.com/profiles/MorganeParis, enter MorganeParis. A leading @ is ignored. Use the exact spelling of the handle.

• Empty: the object gets no click interaction (no hover text), with a warning at start telling you what to fill.
• A value with a space, a / or an @ inside (a display name or a full link pasted by mistake): a warning at start, the value is used as it is.

The script cannot check that the handle exists: if the store does not open, check the spelling on the creator's profile page.

Sound

Sound/Click Sound: an optional sound from your inventory, played at the object on each accepted click. Sound/Sound Volume goes from 0 to 200 percent (100 = the sound as recorded, 0 = no sound).

Editor Properties Reference (4 total)

Version Notes

Updating from V1.0

• Your values carry over: the 3 settings of V1.0 keep their internal names and their values. As with any update, take a screenshot of the Build panel first.
• Labels: CreatorName becomes Store/Creator Handle, ClickSound becomes Sound/Click Sound, Volume becomes Sound/Sound Volume. Same settings, same values.
• One new setting at its default: Debug/Debug Logging (Off).
• What behaves differently: @MorganeParis now opens the store of MorganeParis (V1.0 sent the @ along); an empty handle gives no click at all (V1.0 played the sound and opened nothing); a double click opens the store once; Sound Volume 0 is silent (V1.0 played at -48 dB).

Recipes

A - Your own shop front. Your handle, a "cash register" click sound.

B - Partner wall. One object per creator, each with its handle: a small gallery of the creators of your scene.

C - Silent sign. Leave Click Sound empty: only the store opens.

Troubleshooting

Limits

• One creator per object: for several creators, use several objects.
• The script cannot verify that a handle exists.

Related MPP Items

MPP - My Pretty Pixels. Open Creator Store Script V1.1.1 (script MPP - Open Creator Store). Store: https://www.sansar.com/store/listings/3d87d439-c908-4c2d-bd55-3d9969d2a524/open-creator-store-script