# 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/`. 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: "'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) | Property | Type | Default | Description | |---|---|---|---| | Store/Creator Handle | string | "MorganeParis" | Handle of the creator, as in the profile link; `@` ignored; empty = not clickable | | Sound/Click Sound | SoundResource | (none) | Sound played at the object on click | | Sound/Sound Volume | integer, 0-200 | 100 | Loudness in percent; 0 = no sound | | Debug/Debug Logging | bool | Off | Writes the start summary and each click to the script console | --- ## Version Notes | Version | What changed | |---|---| | V1.0 | First release: creator name, click sound, volume. Sold until V1.1.1 | | V1.1.0 | Creator Handle with `@` ignored and warnings, empty handle = no interaction, silent anti double-click, Sound Volume 0 silent, guarded calls, labels and groups, Debug Logging | | **V1.1.1** (this version) | Version number only | ### 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 | Symptom | Check | |---|---| | The object has no hover text | `Creator Handle` is empty (warning at start) | | The store does not open | Check the handle spelling on the creator's profile link; a warning at start signals a space, a `/` or an `@` inside the value | | Two clicks, one opening | The one-second anti double-click: on purpose | | No sound | A sound in `Click Sound`, `Sound Volume` above 0 | | I want to know what the script does | Turn `Debug/Debug Logging` On: the script console shows the start summary and each click | --- ## Limits - One creator per object: for several creators, use several objects. - The script cannot verify that a handle exists. --- ## Related MPP Items | Item | What it adds | |---|---| | **Store Listing Opener Script** | Opens one listing instead of the whole store, by click or Action Button. Store: https://www.sansar.com/store/listings/8c7e1415-e339-4db5-98d1-6dfacee78d14/store-listing-opener-script | | **Send Website To Nearby Chat Script** | Sends a website link in the chat. Store: https://www.sansar.com/store/listings/2b1465e7-ca59-4f7c-b01f-797ffb860ebe/send-website-to-nearby-chat-script | --- *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*