# Scene ### [![Response_Scene_Load.png](https://simlab-soft.com/help/uploads/images/gallery/2024-11/response-scene-load.png)](https://simlab-soft.com/help/uploads/images/gallery/2024-08/response-value-number-add.png) Load Scene [![Screenshot 2024-11-04 160632.png](https://simlab-soft.com/help/uploads/images/gallery/2024-11/scaled-1680-/w6Gimage.png)](https://simlab-soft.com/help/uploads/images/gallery/2024-08/add-node.jpg)The **Load Scene node** is used to teleport between different scenes within your VR Experience. Enhancing the overall immersion and interactivity of the experience. #### #### Example [![Add_Example2.jpg](https://simlab-soft.com/help/uploads/images/gallery/2024-11/scaled-1680-/WFMimage.png)](https://simlab-soft.com/help/uploads/images/gallery/2024-08/add-example.jpg) In this example, the **Load Scene Node** is used to transition the user from one scene to another. This node facilitates changing scenes, allowing for a dynamic experience as users navigate through different environments within the VR application. > [![Discord_Icon.png](https://simlab-soft.com/help/uploads/images/gallery/2024-08/discord-icon.png)](https://simlab-soft.com/help/uploads/images/gallery/2024-08/response-value-number-add.png)[ Tutorial is available on SimLab VR Discord server](https://discord.com/channels/1062715275805470821/1307969317068869664 "Tutorial is available on SimLab VR Discord server") --- ### [![Response_Scene_Home.png](https://simlab-soft.com/help/uploads/images/gallery/2024-11/response-scene-home.png)](https://simlab-soft.com/help/uploads/images/gallery/2024-08/response-value-number-add.png) Home Scene [![Screenshot 2024-11-04 160632.png](https://simlab-soft.com/help/uploads/images/gallery/2024-11/screenshot-2024-11-04-160632.png)](https://simlab-soft.com/help/uploads/images/gallery/2024-08/add-node.jpg)The **Home Scene node** enables users to return to the initial scene of the VR Experience. This node provides a straightforward way for users to reset the VR Experience to the starting point, ensuring a user-friendly navigation experience. #### #### Example [![Add_Example2.jpg](https://simlab-soft.com/help/uploads/images/gallery/2024-11/scaled-1680-/image.png)](https://simlab-soft.com/help/uploads/images/gallery/2024-08/add-example.jpg) In this example, the **Home Scene Node** is used to return the user to the main scene when the trigger event occurs. This allows you to teleport back to the primary environment, enhancing the user experience by providing a clear and intuitive way to return to the starting point. > [![Discord_Icon.png](https://simlab-soft.com/help/uploads/images/gallery/2024-08/discord-icon.png)](https://simlab-soft.com/help/uploads/images/gallery/2024-08/response-value-number-add.png)[ Tutorial is available on SimLab VR Discord server](https://discord.com/channels/1062715275805470821/1307969317068869664 "Tutorial is available on SimLab VR Discord server") --- ### [![Response_Scene_Home.png](https://simlab-soft.com/help/uploads/images/gallery/2025-01/scaled-1680-/response-scene-import.png)](https://simlab-soft.com/help/uploads/images/gallery/2024-08/response-value-number-add.png) Import Scene [![Screenshot 2024-11-04 160632.png](https://simlab-soft.com/help/uploads/images/gallery/2025-01/scaled-1680-/Mg3image.png)](https://simlab-soft.com/help/uploads/images/gallery/2024-08/add-node.jpg)The **Import Scene** node is used to load an external scene into the current VR Experience. This allows users to dynamically bring in additional environments, objects, or elements as needed during runtime. #### #### Example [![image.png](https://simlab-soft.com/help/uploads/images/gallery/2025-01/scaled-1680-/xguimage.png)](https://simlab-soft.com/help/uploads/images/gallery/2025-01/xguimage.png)[![image.png](https://simlab-soft.com/help/uploads/images/gallery/2025-01/scaled-1680-/NMTimage.png)](https://simlab-soft.com/help/uploads/images/gallery/2025-01/NMTimage.png) In this example, the **Import Scene node** is used to load a car model into the scene when the "Import" object is triggered. The Node Triggered event detects user interaction and executes the Import Scene node, which then loads the specified car model from an external VR package file. This allows the car to appear dynamically within the VR environment. --- ### Reload Scene Restarts the scene that is currently running, bringing it back to the way it was at the start. #### What it does When this node runs, it reloads the current scene from the beginning. Everything in the scene starts over — objects return to their starting positions and the scene plays as if it had just been opened. It’s a handy way to give the user a “start over” or “try again” option, such as a reset button that puts a training exercise back to the beginning. #### Inputs

Port	Type	What to connect
Execute	Trigger	Wire this from the previous node’s Execute output — for example, from a button click or another action that should restart the scene.

#### Outputs This node has no outputs. #### Example

**Execute** input

Wired from a “Restart” button so that clicking it starts the scene over from the beginning.

#### Tips - Reloading starts the scene over completely, so any progress the user has made will be lost — use it when you want a clean fresh start. - This node has no Execute output, so it’s always the last step in its chain — nothing runs after it. --- ## Enterprise VR Packages An **Enterprise VR Package** is a complete VR experience saved as a single, **protected** `.evrpackage` file. These packages are **encrypted**, so only a viewer that has the matching enterprise key can unlock and open them, and creating them is part of a SimLab **Enterprise** licence. The node below brings one of these packages into the running Viewer and adds it to the **main menu**, ready to be opened. ### Add Enterprise VR Package To Viewer Fetches an Enterprise VR Package from a web address, unlocks it, and adds it to the Viewer's main menu. #### What it does Give this node the address of an Enterprise VR Package (an `.evrpackage` file) and, while your experience is running, it downloads the package, unlocks it with its enterprise key, and adds it to the Viewer's **main menu** — the list of experiences someone can open. The package is stored **locally** on the device, so from then on it can be opened from the menu like any other entry. **It does not put anything into the scene that's currently playing.** This node makes a whole package available to open from the menu; it does not drop models or other content into the running scene. If what you want is to bring content *into* the current scene, use the **Import** node instead — that's what it's for. Because these packages are protected, this only works with genuine Enterprise VR Packages, and the Viewer has to be able to unlock the file. The **Success** output tells you whether the package was added. #### It waits until the package is ready Downloading a package and unlocking it isn't instant — it takes a moment, and it happens quietly in the background so the rest of your experience keeps running. This node handles that waiting for you. Its **Execute** output does *not* fire the moment the node runs; it fires only once the package has been added to the menu *or* the attempt has failed. So **the nodes you wire after this one run when the package is ready**, not the instant it's requested, and you don't need to add any delay of your own. Because **Execute** fires whether it worked or not, always check **Success** first. #### Inputs

Port	Type	What to connect
Execute	Trigger	Wire this from the previous node's Execute output.
URL	Text	The web address of the Enterprise VR Package (an `.evrpackage` file) to add. A local file path on the device also works.

#### Outputs

Port	Type	What you get
Execute	Trigger	Fires once the node has finished — whether the package was added or not.
Success	True / false	Yes if the package was downloaded, unlocked, and added to the main menu; No otherwise — for example the address was wrong, the download couldn't be completed, or the package couldn't be unlocked.

#### Example

URL input	`https://enterprise.example.com/packages/assembly-training.evrpackage`
Success output	Yes — the package now appears in the Viewer's main menu

#### Tips - **It adds to the menu, not the scene.** The package becomes available to open from the Viewer's main menu. To bring content *into* the scene that's currently playing, use the **Import** node instead. - **Enterprise VR Packages only.** This works only with protected `.evrpackage` files. Ordinary files won't be added — use **Import** for those. - **The Viewer must be able to unlock it.** These packages are encrypted. If the file is damaged, its key isn't available, or there's no connection to download it, **Success** comes back **No** and nothing is added. - **Check Success first.** Wire the **Success** output into a **Branch** node so the rest of your experience only relies on the package on the “Yes” side. - **No need to add a delay.** The node already waits for the download and unlock to finish before its **Execute** output fires, so the nodes after it run at the right time on their own. --- ## Scene actions These nodes work with the experience that’s currently running — finding out which scene is open, returning to the home screen, saving how the scene looks, and sending the scene back to the cloud. None of them change what’s in your scene; they read from it or move the viewer somewhere else. ### Get Running Scene GUID Gives you the unique ID of the scene that is currently running. #### What it does Every scene (VR package) has its own unique ID — a long piece of text that no other scene shares. This node hands you that ID for the scene that is open and running right now. It only reads the ID; it doesn’t change anything about the scene. You can use the result to tell scenes apart, to label saved data so you know which scene it came from, or to pass along to other nodes that need to know which scene is loaded. #### Inputs

Port	Type	What to connect
Execute	Trigger	Wire this from the previous node’s Execute output.

#### Outputs

Port	Type	What you get
Execute	Trigger	Fires once the node has finished.
Result	Text	The unique ID of the scene that is currently running, as text.

#### Example

**Result** output

`3f2a9c7e-1b4d-4e8a-9c2f-7a1e5d6b0c84`

#### Tips - Two different scenes always have different IDs, so this is a reliable way to check which scene is loaded before running scene-specific steps. - The exact text will look different for every scene — treat it as a label to match or store, not something to read by eye. ### Home Screen Takes the viewer back to the application’s home screen — the main start screen they see when SimLab Composer first opens. #### What it does When this node runs, it closes out of the current scene and returns the viewer to the home screen, where they can choose what to open next. Think of it as a “back to the main menu” button you can trigger from your scripting. This node doesn’t change or delete anything in your scene — it simply switches the view back to the home screen. Note that this is different from the **Home Scene** node, which moves to the home scene inside the content you have open rather than leaving for the main screen. #### Inputs

Port	Type	What to connect
Execute	Trigger	Wire this from the previous node’s Execute output. The moment it fires, the viewer is taken back to the home screen.

#### Outputs This node has no outputs. #### Example

**Execute** input

Connect this to a “Quit” or “Exit to menu” button so that pressing it returns the viewer to the home screen.

#### Tips - Use this when a training session is finished and you want the viewer returned to the main screen rather than left in the scene. - If you only want to jump to the home scene *within* the open content, use the **Home Scene** node instead. ### Save Visual Settings Saves how your scene currently looks — its lighting and environment, color adjustments, background, and the appearance of every material — to a visual-settings file (a `.vis` file) you can import back into SimLab Composer to re-apply that look. #### What it does This node takes a snapshot of the scene’s current visual style and stores it under the name you give it. The snapshot covers the lighting and environment (sun and sky, the surrounding environment light, and fog), the color and exposure adjustments (such as contrast, saturation, white balance, tint, and overall brightness), the background (whether it’s an image, the environment, or a solid color), and how every material in the scene looks (its color, shininess, transparency, reflection, and similar settings). Saving doesn’t change your scene at all — it only reads the current values and stores them, so everything keeps looking exactly the same. The settings are written to a **visual-settings file** (a `.vis` file) named after the name you provide; saving again with the same name replaces the earlier file. Leaving the name empty saves it under a default name. #### Applying a saved look The `.vis` file this node creates can be **imported back into SimLab Composer** to apply the saved look to the scene. Save and import it **within the same session** — don’t close and reopen the scene in between. The saved look is tied to the scene’s internal IDs, and those can change when the scene is reopened, so a file saved in an earlier session may not apply correctly. #### Inputs

Port	Type	What to connect
Execute	Trigger	Wire this from the previous node’s Execute output.
Name	Text	The name for the visual-settings file to create, such as `Daytime` (saved as `Daytime.vis`). If you leave it empty, a default name is used. Saving again with the same name replaces the earlier file.

#### Outputs

Port	Type	What you get
Execute	Trigger	Fires once the node has finished.
Name	Text	The same name you provided, passed along so you can reuse it in later nodes.

#### Example

Name input	`Daytime`
Name output	`Daytime`

#### Tips - **Save and import in the same session.** Apply the `.vis` file before closing and reopening the scene — if the scene is reopened first, its internal IDs may have changed and the saved look might not apply correctly. - Give each look a clear, memorable name (for example `Daytime`, `Night`, or `Sunset`) so it’s easy to recognize when you import it back into Composer. - Reusing a name on purpose is a handy way to update a saved look — the new save simply replaces the earlier `.vis` file under that name. ### ShareBack Scene Sends the current scene back to the cloud, saving your changes as a new version of the experience it came from. #### What it does When this node runs, the Viewer shows a “Share Back Scene” prompt and the current scene is saved up to the cloud as a new version of the original experience it was opened from. This lets the changes the viewer made travel back to the shared cloud copy of the experience. The node waits for the save to finish before it continues, so its result is ready by the time the next node runs. The **Success** output then tells you whether it worked: `true` if the scene was saved back as a new version, or `false` if it couldn’t be shared back right now. This does not change the scene that is currently running — it just publishes a copy back to the cloud. #### Inputs

Port	Type	What to connect
Execute	Trigger	Wire this from the previous node’s Execute output, for example from a button the viewer presses when they want to send their changes back.

#### Outputs

Port	Type	What you get
Execute	Trigger	Fires once the scene has finished being shared back — whether it succeeded or not. Check Success before assuming the save worked.
Success	True / false	`true` if the scene was saved back to the cloud as a new version; `false` if it couldn’t be shared back — for instance if the scene didn’t come from the cloud, the viewer isn’t signed in or doesn’t have permission to update it, or there’s no connection.

#### Example

Execute input	Wired from a “Save my changes” button in the scene
Execute output	Continues to a Branch node that reacts based on Success
Success output	`true`

#### Tips - Because the Execute output fires whether the save worked or not, check the **Success** output first — a Branch node is a handy way to show a “Saved!” message on `true` and a “Couldn’t save” message on `false`. - This only works for scenes that were opened from a cloud experience, and the viewer needs to be signed in with permission to update it.