# Get Started

## **What is GMetri?**

**GMetri is a no-code browser-based metaverse toolkit** - providing the complete web 3.0 infrastructure to create, publish and track your own metaverse.

GMetri helps individuals and businesses create, share and track collaborative metaverse experiences for training, online stores, product showcases, immersive tours, stories and more.

{% content-ref url="/pages/gqTwgPetTkl8GYx6zwTs" %}
[Quickstart](/readme/overview)
{% endcontent-ref %}

{% content-ref url="/pages/Lfsq99S86bQ1sQLFwdbj" %}
[Tutorials](/readme/tutorials)
{% endcontent-ref %}


# Quickstart

Account Creation, Project Listing, First Experience, Deploy

Here's a short video to get you familiar with the GMetri Platform:

{% embed url="<https://youtu.be/26v3S5Diwqg>" %}
GMetri 15 Minute Intro
{% endembed %}

## Create a GMetri Account

* Start by creating a free account at <https://portal.gmetri.com/register>
* Login at <https://portal.gmetri.com/signin>
* The page you see after you log in is the [*Portal*](/metaverse/build/portal). The portal lists all your experiences.&#x20;
* Click on any project to open the Experience [*Editor*](/metaverse/build/editor).
* Go through the [Tutorials](/readme/tutorials) to go through the basics of creating a Metaverse Experience

## Want to jump into *your* Metaverse?

* Go through the other sections in [Build Your Metaverse](/metaverse/build) to delve deeper

***Step 1***: Login and click on "Enter Room". *There is no step 2.*

<figure><img src="https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mgll1jjQMRTVj7p6n7g%2Fuploads%2FHAO1ZC6uGov1zuYs0R9J%2Fimage.png?alt=media&#x26;token=8bcf4501-5379-4597-88af-993763e725ff" alt=""><figcaption><p>My Metaverse Rooms</p></figcaption></figure>

Copy this Invite Link, and share it with your friends, to have a chat with them in the metaverse. Use "Join Call" to start an audio session.

## How can I modify the room?

This is where the real fun begins!&#x20;

For a quick intro to GMetri head over to [tutorials](/readme/tutorials). Go through [Build Your Metaverse](/metaverse/build) to get a lay of the GMetri land.

To get a hand-hold session that goes through both basics and advanced topics of GMetri, [join our Free Webinars](https://www.gmetri.com/webinar).

See you on the other side!


# Tutorials

## Webinar Recording

Here's a playlist of GMetri Tutorials/Webinars:

{% embed url="<https://www.youtube.com/playlist?list=PLh46tSVsmkaSghc374ZkKviudzs3eIlFR>" %}

## Demo

Here's a demo Metaverse experience with [E-Commerce integration](/metaverse/integrations/e-commerce-with-gmetri) enabled.&#x20;

{% hint style="success" %}
Use the arrow keys or the joystick you see on your mobile to move around. Click on the products in display to get a detailed Product Card. You can also try purchasing the items to get redirected to their respective pages (though with integrations like Shopify even shopping carts work within the Metaverse).
{% endhint %}

{% embed url="<https://rxhhkr.gmetri.com/retail_storedemo>" %}
Retail Metaverse Demo
{% endembed %}

## Digital Twins

GMetri excels at creating Digital Twins for training, simulations, virtual facilities, facility tours, product showcases, events, employee onboarding, recruitment to name a few use cases.

{% embed url="<https://youtu.be/jSfmzeeae4U>" %}


# Wizards

Use wizards to get started with prebuilt GMetri experiences in 5 minutes!

{% hint style="info" %}
Wizards are forms that use ready-made templates to generate a Metaverse for you, in your own GMetri account. Wizards are a great way to get your first Metaverse up and running in a matter of minutes.
{% endhint %}

Here's a 17 min session by [@NoCodeDevs](https://www.youtube.com/channel/UC4_jeBnLBx2hlWJronvPB2g) that takes you through a Wizard to get your first Metaverse experience.

{% embed url="<https://youtu.be/Jk9uB9-fSBs>" %}

### Steps to get your Collaborative Metaverse in 15 minutes

1. If you don't have a GMetri account already, [create one here](http://gmetri.com/signup)
2. Open the wizard you want (use any wizard link below), fill it by uploading assets/images, and submit.
3. **Done!**

**Wizard links:**&#x20;

* [Collaborative Event Metaverse](https://forms.gle/n42EipbBNEZ4Qtft5)
* [Collaborative Retail Metaverse](https://forms.gle/xp2bS4Tfz46RCcyh6)

Check your email to get the link to your personalized experience with 5 minutes of filling the wizard.

To make further customizations to this experience, access your [GMetri Portal](https://portal.gmetri.com) to find these experiences listed there.

### Collaborative Retail Metaverse Demo

{% embed url="<https://rxhhkr.gmetri.com/retail_storedemo?embed=true>" %}

Here's the [detailed guide](https://www.gmetri.com/justaboutreal/wizard-building-a-collaborative-retail-metaverse-on-gmetri/) you can follow to create a collaborative retail metaverse of your own.

### Collaborative Event Metaverse Demo

{% embed url="<https://rxhhkr.gmetri.com/eventsMetaverse?embed=true>" %}

Here's the [detailed guide](https://www.gmetri.com/justaboutreal/wizard-building-a-custom-collaborative-metaverse-on-gmetri-in-15-minutes/) you can follow to create a collaborative event metaverse of your own.


# Features

## Collaboration

<table data-column-title-hidden data-view="cards"><thead><tr><th>Name</th><th>Description</th><th>Type<select><option value="b572d7e67c90484ca7574ec4856a5995" label="Collaboration" color="blue"></option></select></th><th data-hidden data-card-cover data-type="files"></th></tr></thead><tbody><tr><td><a href="/pages/o3bLvi3r9pt7qzbAHDZN">AVATARS</a></td><td>Personalized Avatars with Ready Player Me integration</td><td><span data-option="b572d7e67c90484ca7574ec4856a5995">Collaboration</span></td><td><a href="/files/4YPtUqGIOGUrOcC6WBtV">/files/4YPtUqGIOGUrOcC6WBtV</a></td></tr><tr><td><a href="/pages/90A5HpyeYSZnHPoE1yq7">SCREENSHARE</a></td><td>Screen Sharing - in 3D</td><td><span data-option="b572d7e67c90484ca7574ec4856a5995">Collaboration</span></td><td><a href="/files/HDbaEM4Gbj5SvlpIMUZ6">/files/HDbaEM4Gbj5SvlpIMUZ6</a></td></tr><tr><td><a href="/pages/eQCmlMnNOCp1UWYCFHJp">VOICE CHAT</a></td><td>Voice Chat with others in the Metaverse, like in Zoom/Teams or GMeet</td><td><span data-option="b572d7e67c90484ca7574ec4856a5995">Collaboration</span></td><td><a href="/files/dEoCyEBTlnDAjJ5NjaOr">/files/dEoCyEBTlnDAjJ5NjaOr</a></td></tr><tr><td><a href="/pages/fm382iUJtChw25kHX3zz">COMMENTS</a></td><td>Post feedback on 360 Panoramas</td><td><span data-option="b572d7e67c90484ca7574ec4856a5995">Collaboration</span></td><td><a href="/files/nb2K9Xjem762fH6B1rqy">/files/nb2K9Xjem762fH6B1rqy</a></td></tr><tr><td><a href="/pages/upTtzZI35oBtEHTFTD2R">NOTIFICATIONS</a></td><td>Send notifications to everyone who is in a deployment</td><td><span data-option="b572d7e67c90484ca7574ec4856a5995">Collaboration</span></td><td><a href="/files/iJBvyXv862Je1SGECztN">/files/iJBvyXv862Je1SGECztN</a></td></tr><tr><td><a href="/pages/p5W0xVdddYh2QZWCmHD8">TEXT CHAT</a></td><td>Text Chat with everyone in the same space </td><td><span data-option="b572d7e67c90484ca7574ec4856a5995">Collaboration</span></td><td></td></tr><tr><td><a href="/pages/11ax3HyHBCzYJzqDROsO">SHARE REACTIONS</a></td><td>Communicate with your team using Emojis</td><td><span data-option="b572d7e67c90484ca7574ec4856a5995">Collaboration</span></td><td></td></tr><tr><td><a href="/pages/IQqla6v4di1TteBbqiMx">FIRST/THIRD PERSON</a></td><td>Toggle between first and third person views </td><td><span data-option="b572d7e67c90484ca7574ec4856a5995">Collaboration</span></td><td></td></tr></tbody></table>

## Editor

<table data-column-title-hidden data-view="cards"><thead><tr><th>Name</th><th>Description</th><th data-card-cover data-type="files">Cover</th><th>Type<select><option value="b73d2c2cd3fb4002bd3bb36e8114b749" label="Editor" color="blue"></option><option value="3c4a725f4f434288a6c23c6435e531de" label="UI" color="blue"></option><option value="6ca0387d396b4c3e9ae1e13ffd7c4a3c" label="Analytics" color="blue"></option><option value="4b7aea0eea414f0cafef3ba6ba3c3b57" label="Collaboration" color="blue"></option><option value="d5dfab5e75334beb89a3dfc6513ac276" label="Publishing" color="blue"></option></select></th></tr></thead><tbody><tr><td><a href="/pages/6iCk4WJ2VVfAzdMXatrr">ASSET MANAGER</a></td><td>Manager your assets on the cloud</td><td><a href="/files/dYIDQeokwE2d3elvZq8G">/files/dYIDQeokwE2d3elvZq8G</a></td><td><span data-option="b73d2c2cd3fb4002bd3bb36e8114b749">Editor</span></td></tr><tr><td>REALTIME EDITING</td><td>See changes from your teammates real-time Google Docs style</td><td><a href="/files/hL5W1u4j9oSJxSQNw1Dv">/files/hL5W1u4j9oSJxSQNw1Dv</a></td><td><span data-option="b73d2c2cd3fb4002bd3bb36e8114b749">Editor</span></td></tr><tr><td><a href="/pages/mJPqUjlr5B6jUW6h6LBY">RULES</a></td><td>Create logic using No-Code sentence based Rules engine</td><td><a href="/files/MvvDeyB3bHps4ljyOQKi">/files/MvvDeyB3bHps4ljyOQKi</a></td><td><span data-option="b73d2c2cd3fb4002bd3bb36e8114b749">Editor</span></td></tr><tr><td><a href="/pages/rtUPMYzaInz3MBuFObw3">TEXT TO SPEECH</a></td><td>Create Speech Audio by entering text</td><td><a href="/files/JtgjiBzkhvIs1U0k48dw">/files/JtgjiBzkhvIs1U0k48dw</a></td><td><span data-option="b73d2c2cd3fb4002bd3bb36e8114b749">Editor</span></td></tr><tr><td><a href="/pages/lZp1LcJc5wFFDYsuLGJR">EMBED HTML</a></td><td>Embed HTML pages as part of the experience</td><td><a href="/files/IsBujXrYeQX3tVz3SUZA">/files/IsBujXrYeQX3tVz3SUZA</a></td><td><span data-option="b73d2c2cd3fb4002bd3bb36e8114b749">Editor</span></td></tr><tr><td><a href="/pages/4FdURXtqhp12wn0WgUZi">VARIABLES</a></td><td>Store progress data, and add logic, calculate formulas</td><td><a href="/files/pobcIR6Te8qBqoLwqpba">/files/pobcIR6Te8qBqoLwqpba</a></td><td><span data-option="b73d2c2cd3fb4002bd3bb36e8114b749">Editor</span></td></tr><tr><td><a href="/pages/tK6IVaUhCHZGmX5ppdHU#random-number">RANDOM NUMBER GENERATOR</a></td><td>Introduce randomness in games</td><td><a href="/files/4qypAhMvqjJDuUwZuJDp">/files/4qypAhMvqjJDuUwZuJDp</a></td><td><span data-option="b73d2c2cd3fb4002bd3bb36e8114b749">Editor</span></td></tr><tr><td><a href="/pages/UzHm6k5J45gBkwCKgpUJ">GREEN SCREEN</a></td><td>Selectively make videos transparent</td><td><a href="/files/YuniqCBsgHzhC34eHTwh">/files/YuniqCBsgHzhC34eHTwh</a></td><td><span data-option="b73d2c2cd3fb4002bd3bb36e8114b749">Editor</span></td></tr><tr><td>3D MODELS</td><td>Add 3D Models directly from your computer, or use the SketchFab plugin to import models</td><td></td><td><span data-option="b73d2c2cd3fb4002bd3bb36e8114b749">Editor</span></td></tr><tr><td>MY METAVERSE ROOMS</td><td>Use ready-made spaces as a starting point for your experiences</td><td></td><td><span data-option="b73d2c2cd3fb4002bd3bb36e8114b749">Editor</span></td></tr><tr><td>PRODUCT CARD </td><td>Product Card pop-outs for showcasing your products</td><td></td><td><span data-option="b73d2c2cd3fb4002bd3bb36e8114b749">Editor</span></td></tr><tr><td>CAMERA CONTROLS</td><td>Toggle between first person and fly controls</td><td></td><td><span data-option="b73d2c2cd3fb4002bd3bb36e8114b749">Editor</span></td></tr><tr><td><a href="/pages/l5ji8UGPiY9OkL7CZSXG">SCENE TYPES</a></td><td>Combine 3D Scenes, 360 Scenes and Orbit Scene into a single experience</td><td></td><td><span data-option="b73d2c2cd3fb4002bd3bb36e8114b749">Editor</span></td></tr><tr><td><a href="/pages/eTF2EEteeXv7MgxuqUC9">ELEMENTS</a></td><td>Add images/videos/PDFs etc</td><td></td><td><span data-option="b73d2c2cd3fb4002bd3bb36e8114b749">Editor</span></td></tr><tr><td><a href="/pages/eEa4ADd56U925lHmuDqU">PREVIEW</a></td><td>Keep previewing your experience while building it</td><td></td><td></td></tr></tbody></table>

## Platform

<table data-column-title-hidden data-view="cards"><thead><tr><th>Name</th><th>Description</th><th>Type<select><option value="4eedd83e8e374591848ac58a1a693267" label="Platform" color="blue"></option></select></th></tr></thead><tbody><tr><td><a href="/pages/0AgoWxVnzhJmUuJTJkah">FINE-GRAINED CONTROLS</a></td><td>VR Mode, Gyroscope, Zoom controls, Volume controls</td><td><span data-option="4eedd83e8e374591848ac58a1a693267">Platform</span></td></tr><tr><td><a href="/pages/wRZfhlxDznzpK6IYqFtz">ECOMMERCE PLUGINS</a></td><td>Plug your Shopify or WooCommerce accounts into the Metaverse</td><td><span data-option="4eedd83e8e374591848ac58a1a693267">Platform</span></td></tr><tr><td><a href="/pages/fnMtJNFoa7orgULX0mlp">SDK</a></td><td>A powerful SDK for deeper integration using Webhooks and APIs</td><td><span data-option="4eedd83e8e374591848ac58a1a693267">Platform</span></td></tr></tbody></table>

## UI

<table data-column-title-hidden data-view="cards"><thead><tr><th>Name</th><th>Description</th><th>Type<select><option value="68ae76f29ce34e29b12407f122496d48" label="UI" color="blue"></option></select></th></tr></thead><tbody><tr><td>WEBGL 2 SUPPORT</td><td>GMetri uses the most up to date version of the WebGL API and is able to drop back to WebGL 1 when required</td><td><span data-option="68ae76f29ce34e29b12407f122496d48">UI</span></td></tr><tr><td>PHYSICALLY BASED RENDERING (PBR)</td><td>Realistic rendering using the latest techniques for 3D Models</td><td><span data-option="68ae76f29ce34e29b12407f122496d48">UI</span></td></tr><tr><td>HDR GRAPHICS PIPELINE</td><td>Support for the latest WebXR standards to generate room-scale and mobile XR experiences</td><td><span data-option="68ae76f29ce34e29b12407f122496d48">UI</span></td></tr><tr><td>WEBXR SUPPORT</td><td>HDR pipeline: automatic gamma-correction, support for HDR cubemaps</td><td><span data-option="68ae76f29ce34e29b12407f122496d48">UI</span></td></tr><tr><td>ANIMATIONS</td><td>Support for animation on your models</td><td><span data-option="68ae76f29ce34e29b12407f122496d48">UI</span></td></tr><tr><td>ENVIRONMENT MAPS</td><td>Live-like reflections on 3D models for that extra layer of realism</td><td><span data-option="68ae76f29ce34e29b12407f122496d48">UI</span></td></tr><tr><td>SELECTIVE BLOOM</td><td>Ability to add a glow effect on 3D Models</td><td><span data-option="68ae76f29ce34e29b12407f122496d48">UI</span></td></tr><tr><td><a href="/pages/dXffJciG9CR91BQ9AOCg">TOUR MODE</a></td><td>A special mode to cycle across all 360 Panoramas automatically</td><td><span data-option="68ae76f29ce34e29b12407f122496d48">UI</span></td></tr></tbody></table>

## Publishing

<table data-column-title-hidden data-view="cards"><thead><tr><th>Name</th><th>Description</th><th>Type<select><option value="b568ef544a554eb2a8605b4b26e137e8" label="Publishing" color="blue"></option></select></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><a href="/pages/dLeckKVzaYdIFuYYxss0">AUTHENTICATION</a></td><td>A plethora of authentication options ranging from Public,  Token, Custom List, Password based</td><td><span data-option="b568ef544a554eb2a8605b4b26e137e8">Publishing</span></td><td></td></tr><tr><td><a href="/pages/WpUQRZpFORy8IwgqV7Bi">ENTERPRISE SSO</a></td><td>Enterprise login methods for Google, Azure, SAML based SSO</td><td><span data-option="b568ef544a554eb2a8605b4b26e137e8">Publishing</span></td><td></td></tr><tr><td><a href="/pages/-MgscsZ-8FORfuKglNw-">SCORM SUPPORT</a></td><td>Publish your experience as a SCORM 1.2 or SCORM 2004 module</td><td><span data-option="b568ef544a554eb2a8605b4b26e137e8">Publishing</span></td><td></td></tr><tr><td><a href="#publishing">ONE-CLICK PUBLISHING</a></td><td>Publish your experience on the web with a single click</td><td><span data-option="b568ef544a554eb2a8605b4b26e137e8">Publishing</span></td><td></td></tr><tr><td><a href="/pages/MrCIy4CcwDQ5jL4tVXkg">WEBSITE/APP EMBED</a></td><td>Embed experiences easily into your website or your apps</td><td><span data-option="b568ef544a554eb2a8605b4b26e137e8">Publishing</span></td><td><a href="/pages/MrCIy4CcwDQ5jL4tVXkg">/pages/MrCIy4CcwDQ5jL4tVXkg</a></td></tr><tr><td><a href="/pages/kED8DMtwRGKyQMhkdrlL">UNIVERSAL HARDWARE SUPPORT</a></td><td>GMetri experiences work everywhere - as they run on your browser.</td><td></td><td></td></tr></tbody></table>

## Analytics

<table data-column-title-hidden data-view="cards"><thead><tr><th>Name</th><th>Description</th><th>Type<select><option value="5104b72253c8414b9bc259c35de20a16" label="Analytics" color="blue"></option></select></th></tr></thead><tbody><tr><td><a href="/pages/0zAXfgci5A5OzBRnwZmR">LEADERBOARD</a></td><td>Score based leaderboard out of the box</td><td><span data-option="5104b72253c8414b9bc259c35de20a16">Analytics</span></td></tr><tr><td><a href="/pages/zBQQRAxKfhalsS7Ra7u3#views">VIEWS</a></td><td>See views over time in the analytics dashboard</td><td><span data-option="5104b72253c8414b9bc259c35de20a16">Analytics</span></td></tr><tr><td><a href="/pages/zBQQRAxKfhalsS7Ra7u3#views-over-time-graph">TIME SPENT</a></td><td>Check time spent on individual scenes</td><td><span data-option="5104b72253c8414b9bc259c35de20a16">Analytics</span></td></tr><tr><td>REALTIME SCENE DASHBOARD</td><td>Check real-time which user is at what Scene</td><td><span data-option="5104b72253c8414b9bc259c35de20a16">Analytics</span></td></tr><tr><td><a href="/pages/zBQQRAxKfhalsS7Ra7u3#analytics-dashboard">LOCATION ANALYTICS</a></td><td>Track location of each of your viewer and get a density map on your dashboard</td><td><span data-option="5104b72253c8414b9bc259c35de20a16">Analytics</span></td></tr><tr><td>COMPLETION STATUS</td><td>Check which rules get triggered by which User</td><td><span data-option="5104b72253c8414b9bc259c35de20a16">Analytics</span></td></tr></tbody></table>


# Release Notes


# 2024


# 04-05 Apr Update

v0.5.5728 / 05 Apr 2024

## ⏫ Improvements

* **Streamlined Avatar System**: Simplified the avatar system to include only three options: Ready Player Me, Custom, and None. Removed the outdated "Basic" avatar system that used conical avatars for a more streamlined experience.
* **Introduction of "Basic" Brain Type**: Added a new "Basic" brain type, allowing users to set the AI prompt directly on the right bar, eliminating the need to select a specific brain.

## 🔐 S**ecurity Enhancements**

* **Enhanced Preview Link Generation**: Revised the method for generating preview links to bolster security measures.
* **Improved Data Encryption**: Updated the encryption process for enhanced data security.

## 🐞 Bug Fixes

* **Mobile - Walking Straight**: Resolved the issue of walking straight on mobile devices using the third-person joystick, ensuring smoother navigation.
* **Character Element Audio Issue**: Fixed an issue related to the Character element audio for improved functionality.
* **3D Asset Loading Bugs**: Addressed several bugs in the loading process of 3D assets utilizing KTX compression, ensuring proper loading and display.


# 03-27 Mar Update

v0.5.5697 / 27 Mar 2024

## ⏫ Improvements

* **Walking Speed Multiplier**: Implemented a walking speed multiplier, allowing users to accelerate the experience by adjusting the walking speed.
* **Character Element Events**: Added two new events to the Character element: "Finishes Speaking" and "Finishes AI Response," facilitating smoother integration of events in interactive storylines involving character elements.
* **Mobile “Tap to Start” Screen**: Introduced a new "Tap to Start" screen on mobile devices to ensure the audiocontext is unlocked, improving user experience.
* **Multiline Text Input:** Enabled multiline text input in various then actions, including "Set to String," "Speak," "Show Notification," and "Replace Screen Reader Text," enhancing flexibility and functionality.
* **Wider Rule Name Input Boxes**: Increased the width of rule name input boxes to accommodate longer rule names, improving visibility and usability.
* **Autogenerated Variable Table Enhancement**: Updated the autogenerated variable table to display variable categories on the Variables Settings page for improved organization and management.

## 🔐 S**ecurity Enhancements**

* **Password Expiry**: Implemented password expiry for GMetri editor accounts. Accounts older than a specified period will prompt users to update their passwords for enhanced security.
* **Reduced Third-party App Usage**: Minimized the utilization of third-party applications accessing GMetri data to bolster data security and privacy.

## 🐞 Bug Fixes

* **Movement Speeds**: Fixed movement speeds for both first-person and third-person modes, providing smoother navigation.
* **Autogenerated Variable Headers Alignment**: Corrected the alignment of autogenerated variable headers for consistency and clarity.
* **Logic Map Sorting**: Ensured correct sorting of logic map rules and when events for better organization and ease of use.
* **Gyro Permissions**: Fixed the issue where gyro permissions were being requested in third-person mode on iOS devices. Gyro permissions are now requested only in first-person experiences.
* **Player Count Variable Changes**: Rectified the issue where changes in player\_count\_var weren't triggering when events, ensuring proper functionality.
* **Initial Hidden States of Actionbar Items**: Addressed the issue with the initial hidden states of actionbar items for improved consistency and usability.


# 02-07 Feb Update

v0.5.5440 / 07 Feb 2024

## 🚀 Major Features

We have released some features this time that are great for creating multiplayer games!

### 🔄 **Shared Rules Update**:

* **"Shared" Property** 🤝: Rules can now be marked as "Shared". When activated, these rules apply to everyone in the same room, enhancing multiplayer interactions.
* **Enhanced `on_var_change`** 🔄: This function has been updated to work with Shared Rules, enabling real-time variable syncing across all players. You can now set a rule “When variableA changes, variableA should capture data”. If this is a shared rule, the value of variableA will be synced with all players.

### 🔍 **Advanced Variable Comparison**:

* **Variable Substitution in When Conditions** 📊: You can now use variable substitution in the "When" part of rules, allowing for dynamic comparisons. For example, set conditions like "When a > {{b}}".

### 🎮 **Player Count Enhancements**:

* **New Variables**: Introducing two auto-generated variables for player counts:
  * `player_count_var` 🧑‍🤝‍🧑: Tracks the number of players in your current game instance.
  * `player_count_all_var` 🌐: Shows the total number of players in the entire game room.

### 🔐 **Improved Session Management**:

* **"Remember Me" Option** ✅: Users can now choose to be remembered after logging in, streamlining access for subsequent sessions. This feature is available for "Social" logins and other methods configured in Viewer Groups.

### 📱 **PWA Support**:

* **Install as PWA** 🚀: GMetri experiences can now be installed as Progressive Web Apps (PWAs) on most modern browsers, offering a more app-like experience directly from your browser.

## ⏫ Minor Improvements

* **Japanese Language Option** 🇯🇵 The viewer bubble now supports Japanese fonts also
* **Faster Avatar Thumbnails**⚡ Default avatars selection screen now load more quickly, enhancing the user experience right from the start.
* **Max Rooms Configuration** 🔀 Setting the maximum number of room instances to more than 1 allows for separate moderator rooms. However, setting it to 1 keeps moderators and attendees in the same space, ideal for scenarios like classroom interactions where the teacher needs moderation control.
* **Resizable Deployment Slug Input** ✍️: The input box for deployment section slugs now automatically adjusts its size based on the input length, making it easier to work with longer URLs.
* **Integrated Passcode in Moderator URL** 🔑: The moderator URL now includes the passcode for streamlined access. You have the option to enter the passcode separately if preferred, by removing it from the URL.

## 🐞 Bug Fixes

* **SCORM File Extension** 📦: Fixed an issue where SCORM files downloaded from the deployment section were missing the .zip extension. Now, files are correctly labeled for easy identification and use.
* **Collider Visibility Control** 🚫: The hide/show functionality now properly applies to collider elements as well, ensuring consistent visibility settings across your project.
* **Rule Label Correction** 🏷️: Corrected the labels for the “When number is between”. “< than” and “> than” now accurately reflect the intended conditions.
* **Accurate Moderator Link** 🔗: The moderator link in the Deployment section now accurately reflects the correct URL, even when the workspace slug has an alias.
* **Global Variable Protection** 🔒: Resolved an issue where the editor allowed unintended modifications to the default values of Global boolean variables.
* **Improved URL Editing** ✏️: Enhanced the functionality of the “cancel” button while editing URLs in the deployment section for a smoother user experience.
* **Variable Name Editing** ✍️: Made improvements in the variables section of the editor to facilitate easier renaming of variables.
* **Drag-and-Drop Fixes** 🖱️: Resolved issues with dragging functionality for Variables, Menu, and TourMode sections under Settings for more intuitive interface interaction.
* **Single Player Experience Stability** 🕹️: Addressed and fixed several errors in Single Player Experience to ensure a smoother experience.
* **Moderator Reactions** 💬: Fixed an issue where reactions from moderators were not being sent to moderator rooms, ensuring that all interactions are properly communicated.
* **Cleaned Up Editor Scripts** 🧹: Removed unnecessary Facebook and segment.io scripts from the editor to streamline performance and user experience.


# 01-23 Jan Update

v0.5.5365 / 23 Jan 2024

## 🚀 Major Features

🎮 **New Multiplayer System Released**

We released **a new Multiplayer System** today, which culminates a long journey of upgrades that started last year. These include the [v6 release](/features/release-notes/2023/08-14-aug-update) that made our underlying JSON robust and efficient, and a new multiplayer written in-house, keeping the future in mind so that we aren't limited by multiplayer scale and room limits - even for the foreseeable future.

<figure><img src="/files/xOffvH1RhRC6K6gbPhkR" alt=""><figcaption><p>Testing performance with a 100 NPCs</p></figcaption></figure>

The new multiplayer system also brings with it a host of improvements and bug fixes.&#x20;

* 💡 Developed in-house
* 🌐 Now supports up to **100 users** simultaneously in a single room.
* 📍 Fixed issues with initial player positions.
* 🔝 Room capacity increased to 100 for *enterprise customers*. (Room instances still work like before).
* 🎙️ Combined host and broadcast modes into a 'Moderator' feature, in line with other chat systems.
* 🏷️ User display names are now retained across sessions.
* 🚶‍♂️ Enhanced avatar movement for smoother walking. (better interpolation).
* 🚀 Improved performance with multiple avatars.
* 🔔 More effective error notifications.

### Editor Updates:

* 📚 GMetri SCORM API now supports multiple SCORM elements within the same scene.
* 🌐 Ability to **Show/Hide Groups** in the structure tree. (**Note:** This doesn't work on colliders currently).

<figure><img src="/files/99iZaGpcDbN7ap1GGP8k" alt=""><figcaption><p>Ability to hide groups (folders)</p></figcaption></figure>

* 📂 Implemented rules to control visibility of entire groups.

<figure><img src="/files/FIaC7lvXkA3dohiH2rDy" alt=""><figcaption><p>Rules for folders</p></figcaption></figure>

* ⌨ **Shift-select** multiple items in the Structure tree (Ctrl-select remains).

## ⏫ Minor Improvements

* 🖼️ New template for custom Share URL patterns in Product Card elements.
* 📝 Expanded template variables, fully documented here: [String Substitution](/metaverse/build/variables/string-substitution#what-are-the-values-that-i-can-substitute)
* 🔐 Direct passcode entry in moderator URL using `?passcode=yyyy`.
* 🎨 UI enhancements in the Structure Panel, including alignment fixes.

## 🐞 Bug Fixes

* 🔄 Fixed a bug in "Load from another deployment" authentication affecting viewer’s state.
* 💾 Enhanced memory usage with multiple avatars and scene transitions.
* 📺 Fixed screen source switching issues in Screenshare Element.
* 🎲 Addressed multiplayer to single-player downgrades.
* 🔄 Corrected erratic avatar scaling when changing scenes.
* 🗨️ Fixed the order of comments.


# 01-05 Jan Update

v0.5.5265 / 05 Jan 2024

## :arrow\_double\_up: Minor Improvements

* New rule to show toast notifications
* Removed restriction to have an empty action in rules
* New rule to register clicks on the SHARE button in product card element
* Simplified avatar selection process for all authenticated experiences
* Display name will now persist across all deployments with an origanization (if used with authentication)

## :bug: Bug Fixes

* Fixing experience starting issues when using `load from deployment` authentication method
* Fixed GLB and GLTF file uploads in the editor


# 2023


# 12-18 Dec Update

v0.5.5142 / 18 Dec 2023

## 🚀 Major Features

* UI  to show historical conversation with the Character Element
* Support for KTX2 compressed 3D models
* Minimap element (beta)

## ✨ Improvements

* Stricter restrictions on File Uploads
* Support for controlling Avatar quality
* Product card - checkbox for enabling share button
* Support for controlling Avatar quality
* Product card - on clicking share button copies a link to the clipboard and shows notification
* Product card - when a shared link is loaded, the product card appears.

## 🐛 Bug Fixes

* Reduced poly count for zone element
* Fixed idle and talking animations for Character element
* Fixed PDF Viewer for Popup element
* Fixed render order issue for Zone element
* Fixed styling issue for Instruction element
* Fixed movement controls when shift key is pressed before WASD
* Fixed editor sluggishness when using arrow or wasd keys to move around


# 11-30 Nov Update

v0.5.5101 / 30 Nov 2023

## 🚀 Major Features

* UI  to show historical conversation with the Character Element
* Support for KTX2 compressed 3D models
* Minimap element (beta)

## ✨ Improvements

* Support for KTX2 compressed 3D models
* OpenAI Assistant support for Character element
* Added an additional audio to character element when the character is thinking about an answer
* Improvements to VR mode render pipeline
* Minimap element (beta)

## 🐛 Bug Fixes

* Adding back TrackJS
* Fixed Shopify Plugin
* Added variable templating to Embed  3D element


# 10-30 Oct Update

v0.5.5015 / 30 Oct 2023

## 🚀 Major Features

* Updated Signup flow - Added ability to add organization details, reference and purpose<br>

  <figure><img src="/files/dMCkWWcnDjgVsYtSoeEz" alt=""><figcaption></figcaption></figure>

## ✨ Improvements

* Updated substitute nomenclature to Variants for Image, Audio, Audio TTS and Text elements
* Added capability to rules to change view mode
* Added CTA to open scene properties in the Structure tree
* Restricting conversational brain to an Enterprise only feature.
* Added AI token usage basis month in the billings section.
* Added language selection for preview mode

## 🐛 Bug Fixes

* Fixed order of elements inside groups in rules UI dropdowns
* Fixed ability to use delete key for input fields in editor


# 10-04 Oct Update

v0.5.5015 / 4 Oct 2023

## 🚂 Editor Upgrade: V4 to V6

We released the v5 editor in November 2021 and introduced v6 in August 2023. Both of these releases marked major upgrades in terms of the underlying technology and the way we store GMetri projects.&#x20;

During the transition from v4 to v5, we did not automatically update older projects. Instead, we have continued to support the older v4 format in legacy mode for approximately two years.&#x20;

Throughout this time, GMetri's feature set has expanded significantly.&#x20;

We are planning to decommission the v4 editor in the near future. Fortunately, this change will not impact your deployments. This is because, for an extended period, v4 projects have been viewed using the latest viewer. In the viewer we update v4 projects on the fly to the latest version (to v6), without saving them back, to ensure that you can still use the v4 editor, while getting the benefits of our latest viewer.&#x20;

However please be aware that before the next release, when you access older projects, you will start seeing the new editor instead of the older v4 editor.

## ✨ Improvements

* Unfocused windows no longer cause audio events to not fire
* Updated supported browser versions: <https://docs.gmetri.com/guidelines-compatibility/compatibility/supported-browsers>

## 🐛 Bug Fixes

* Fixed orientation issues with VR mode
* Fixed Point To action in VR mode
* Fixed variable templating for Embed 3D element


# 09-18 Sep Update

v0.5.4986 / 18 Sep 2023

## 🚀 Major Features

* Introduced ability to add substitutes for image, audio and text elements based upon variable value<br>

  <figure><img src="/files/5SfUYp51UHCpW8rUTCFU" alt=""><figcaption></figcaption></figure>

## ✨ Improvements

* Added ability to delete multiple selected elements from structure tree
* Fixed history for chats


# 09-11 Sep Update

v0.5.4972 / 11 Sep 2023

## 🚀 Major Features

* Updated UX for Avatar Selection<br>

  <figure><img src="/files/HJf0xV8xFDULbEvk0Tel" alt=""><figcaption></figcaption></figure>
* New reactions for Players\
  ![](/files/IIR0oi9ythxWOr9pElb8)
* Introducing a new Brain type: Role Play (can hold conversations given a personality)

## ✨ Improvements

* Shortcut for deleting elements updated from Ctrl + Delete / Cmd + Delete to Delete
* Introducing 10 new talk animations for characters
* Performance Monitor to calculate Videos, Audios and GIFs overhead
* Improvements in Brain selection UI
* Introducing optimized scene transition type for 360 to 360 scene
* Adding Preset avatars for RPM Avatar system for easier and faster access
* Adding gendered animations for custom avatar system

## 🐛 Bug Fixes

* General optimisations to reduce RAM usage
* Fixed Copy and Paste for elements
* Fixed Experience renaming
* Popup showing slides in sorted order now


# 08-28 Aug Update

v0.5.4910 / 28 Aug 2023

## ✨ Improvements

* 🪑 Better UX while using the *Seat element* in the editor - a model on a seat is now displayed while placing the element.

<figure><img src="/files/f9brr3CxZHhYpu2fUOZq" alt=""><figcaption><p><a href="https://en.wikipedia.org/wiki/Doctor_Manhattan">Dr Manhattan</a> is here to help you place the <em>Seat Element</em></p></figcaption></figure>

* 🔊 Added a “matches duration” event for *Audio TTS element*.
* 🎭 Animations are now applied to compatible Characters selected even from outside of Ready Player Me.
* 📚 Updated UI used to create and add files to a *Character element's* Brain.
* 🆘 Better help options in the top bar of the Portal. More visible help icons on the Editor top bar.

<figure><img src="/files/azEms6N5R1WJWVe2a5uo" alt=""><figcaption><p>Hint: We <strong>realllly</strong> want you to join our <a href="https://g3d.in/discord">Discord Community</a>!</p></figcaption></figure>

* 📁 You can now select Character files from the File Manager for custom avatars.
* 🧑‍🎨 Added a configure avatar link in the deployment page (takes you to avatar preferences), and a few UI improvements.

<figure><img src="/files/7HUMXj7MpS8whFnWUCdr" alt=""><figcaption><p>Better Deployment Section UI</p></figcaption></figure>

* 🖼️ Better icons and thumbnails for *Screenshare*, *Zone*, *Seat*, and *Embed3d* in the “Add Element” page.

#### In The Viewer:

* 📝 Removed cursor instruction for third-person view (as they aren't needed there). Also, we now show instructions when scene changes from 360 to 3D.
* 🌐 The optimization that happens to a project while viewing a link - which causes dormant scenes to be removed from it, is no longer applied while previewing the project. This is because the editor might be working on a project that is currently inaccessible but might later link it into the project.
* 🇯🇵 Translation updates: *Capture Input element*'s copy for Japanese.

## 🐛 Bug Fixes

* 🔄 When a browser tab with a GMetri view link was duplicated, the session id used to get duplicated - and viewer updates used to get overwritten. This is now fixed.
* ➕ Deleting an element and then trying to add a new element without selecting anything from the Structure Panel used to fail. This is now fixed.
* 📝 Entering text in input boxes should no longer moves the camera. This issue used to sometimes bring the camera down to ground level (because of the “e” *reduce camera height* shortcut). ***Fixed!***
* :man\_in\_lotus\_position: The input box for camera height no longer loses focus while modifying it.
* 📊 Fixed viewer sessions table UI in analytics. It wasn’t being rendered correctly in case there a large number of columns as a result of a large number of variables.
* 📈 In certain cases, the analytics page used to show errors and the page refused to render. This is now fixed.

#### In The Viewer:

* 🎮 Controller movement fixes for **VR mode** on headset devices.:tada:
* 📷 Fixed camera height and name bubble position while sitting.
* 🔁 Reset rotation property wasn’t being applied for Third person mode. This is now fixed.


# 08-14 Aug Update

v0.5.4866 / 14 Aug 2023

## 🚀 Major Features&#x20;

* :seat:Seat element released in beta

{% embed url="<https://www.youtube.com/watch?v=qi9mrMmrxUA>" %}
Seat Element
{% endembed %}

## ✨ Improvements

* ⚡ The Rules section now works better (around 5x speed improvement). The list of elements in dropdowns is now ordered according the Structure Panel.

Here's a before vs. after comparison when scrolling the Rules UI:

<img src="/files/lf5ehbXMhXy78SKhf5bD" alt="" data-size="original"><img src="/files/48DCbDljkFwLrTE5HY1y" alt="" data-size="original">

* :man\_standing: Idle animations of Avatars improved.
* :woman\_standing: There are a few issues in some animations in female avatar. Changes were made to help fix that in the coming few days.
* 🛠️ Japanese translations in screenshare and multiplayer mode (when "Japanese" is selected as "Viewer UI Language" from Settings.
* 📈 The project body that gets sent to viewer is now being optimized before it is sent. Any non-reachable scenes, disabled rules etc. are first removed from the project before sending it to the viewer to save network bandwidth.
* :tanabata\_tree: The right bar Structure Panel tree now works slightly better during drag-drop operations.
* :musical\_score: A new property "Background" added to Audio elements. Checking "Background" on an audio element loads it differently (using html5 audio). Background audios:
  * Take lesser memory (important if you are building for iOS)
  * Have a limitation on iOS that they can't perform volume changes using rules, and only work at volume 100% (so bake in the low volume into the audio in case you want lower volume)

## 🐛 Bug Fixes

* 🛠️ The editor has now transitioned to v6. Most of the issues cased by the v5 to v6 have been resolved.
* 💾 Code optimizations done to reduce memory usage.
* 🎯 Copying (ctrl-c, ctrl-v) scenes across projects now also copies variables that were referenced in the rules for that scene. (Note: global variables are not copied over).
* 📱 There were certain menu entries in some project that didn't link to any scenes. This is now fixed - the ghost menu entries should go away on their own the next time you open the editor.
* 📋 Duplicating large projects across workspaces no longer fails. There was a log limit that was being reached for large projects.
* 🛠️ Rules for audios used to get applied on audios twice. This had no impact on functioning, but used up more memory.
* 📝 Two experimental flags:
  * `use_html5_audio=true`: html5 is a new internal audio format for GMetri that uses lesser memory. It has a limitation that it's volume can't be anything other than full (100) and its volume can't be changed by rules. All audios that have 100 volume and don't have any volume rules on them automatically become html5 audios when this flag is passed.
  * `ios_mute_videos=true`: Mutes all videos & removes mute/unmute rules. iOS automatically pauses some GMetri experiences containing audios and videos. This helps prevent that by muting all videos & removing mute/unmute rules.


# 07-23 July Update

v0.5.4656 / 23 July 2023

## ✨ Improvements

* ⚡ Slight performance improvement in the editor.
* 🔄 Rules can now be rearranged.
* 🛠️ Minor UI fixes in Rules top-bar.
* 🎯 Dragging and dropping in the “Structure” tree is now much smoother.
* 📈 Slight improvement in project size. Initial load times should be slightly faster.
* ⏱️ Precision of video, audio, and timer duration rules is now 250 milliseconds.
* 🤫 Ability to mute all users as the host using a single click.

## 🐛 Bug Fixes

* 💾 Editor changes now consistently get saved, with more efficient diffs generation.
* 🎯 Multiple rules with the same "when" conditions now get triggered as expected.
* 📱 Action bar no longer covers the joystick and caller options on mobile.
* 📋 Duplicate and ghost entries in the "Structure" tab no longer form.
* 📝 Copying and pasting a scene and an element now includes the element in the current scene as expected.


# 07-14 July Update

v0.5.4597 / 14 July 2023

## ✨ Improvements

* 🗣️ New Language options for Text-to-Speech Element and Character element voice options
* 🎯 Trigger Radius default changed to 3M for all new character elements: Enjoy more intuitive and accurate interactions with characters in your experiences
* 🖼️ Improved Embed 3D element performance: Smoother rendering and faster loading times for your 3D models.
* 👤 Improved Avatar Selection for quicker entry into the experience: Jump right into the action with faster access to your chosen experience.
* 🇯🇵 Japanese Language translations for collaboration controls: Seamless navigation and collaboration with Japanese language support.
* 🎭 Better random Avatar names: Embrace a new era of diverse and appropriate Avatar names.

## 🐛 Bug Fixes

* 🔊 Fixed an issue where audio match rule didn’t work after seek to operation: Audio triggers now function correctly after seek operations.
* ⌛ Fixed an issue where timer match rule didn’t work after seek to operation: Timers now operate accurately after seek operations.
* 🔌 Fixed an issue where Agora was loaded even in non-multiplayer deployments, improving loading time.
* 🖼️ Fixed Element renaming issue when selected from structure panel.
* 🧠 Fixed issue with renaming AI Brains.
* 🔍 Fixed issue with rules search when searching by color.


# 06-16 June Update

v0.5.4439 / 16 June 2023

## 🚀 Major Features

* 🌐 We've introduced a new element, Embed 3D (beta), that allows you to add web embed codes into the 3D world. This exciting feature opens up a whole new realm of possibilities for your 3D creations!

⏫ Minor Improvements

* 🎮 We've added a pitch range to 3D scenes for more customization options.&#x20;
* 🚫 We've added an option to disable jump for 3D scenes for more control over your 3D environment.&#x20;
* 🚫 We've added an option to disable mouse jump at the experience level for a smoother editing experience.

## 🐛 Bug Fixes

* 🐞 We've fixed the CTRL/CMD + D shortcut that resulted in infinite movement on 3D scenes for a more controlled viewing experience.&#x20;
* 🐞 We've fixed random movement when the Popup element is open and the user presses WASD or arrow keys on 3D scenes for better navigation.&#x20;
* 🐞 We've fixed model issues with the latest GLTF spec for improved 3D model rendering.&#x20;
* 🐞 We've fixed occlusion issues with the GMetri default avatar for a more realistic avatar representation.&#x20;
* 🐞 We've fixed an issue with gender-specific animations from Ready Player Me for more accurate animations.&#x20;
* 🔄 We've changed the defaults for the character element height for better character representation.


# 06-6 June Update

v0.5.4398 / 6 June 2023

## ⏫ Minor Improvements

* 📝 We've made the "is in list" and "is not in list" rule events case insensitive for a more user-friendly experience.
* 🚫 We've removed userguiding to streamline the editing process.
* 🎮 We've added a pitch range for 3D scenes to give you more control over your 3D environment.
* 👾 We've made cosmetic changes to the AI character element to enhance its visual appeal.

## 🐛 Bug Fixes

* 🐞 We've fixed the background clipping for the text element (without background) to ensure a seamless viewing experience.&#x20;
* 🔄 We've fixed the point to action while moving between different scene types for smoother transitions.&#x20;
* ✅ We've fixed the close button clickability for popups for better user interaction.&#x20;
* 🔒 We've fixed the access issue for the leaderboard page while logged out to ensure secure access.
* 🔄 We've updated the Agora version for improved performance.&#x20;
* 🔄 We've updated project calls for both client and server for better synchronization.


# 05-16 May Update

v0.5.4293 / 16 May 2023

## 🚀 Major Features

* [Broadcast mode](/metaverse/multiplayer/broadcast-mode) for deployments that allow broadcasters to send audio stream and be visible in all rooms instances.
* [Linked Popups](/metaverse/build/elements/linked-popups) - Image and video elements can be linked to popups that opens when the element is clicked

## ⏫ Minor Improvements

* Changed defaults for new experiences. Default scene - 3D scene, default camera controls - 3rd Person
* On duration matches rule for Audio Element

## 🐛 Bug Fixes

* Fixed keyboard shortcuts when using chat and comments
* Fixed Comments for 3D Scenes
* Fixed scaling issue for character element between editor and viewer
* Fixed popup rendering issue for older experiences
* Fixed name templating in emails
* Fixed editor crash when user name doesn’t exist


# 03-31 Mar Update

v0.5.4119 / 31 Mar 2023

## 🚀 Major Features

* A new [Performance Monitor](/guidelines-compatibility/guidelines/experience-optimizations/scene-optimizations/performance-monitor) to check the estimated performance and metrics about the scene (accessible via navbar)&#x20;
* A better color management scheme for new projects. This change brings in more accurate color reproduction for all textures and solid colors&#x20;
* A new design for the Popup Element
* A new Live analytics section added to Advanced Analytics

## ⏫ Minor Improvements

* Better UI for the Screenshare element
* Added relevant tooltips for Collaboration controls for multiplayer

## 🐛 Bug Fixes

* Fixied rotation of avatars between third person and first person views
* Fixed inconsistent default avatar model&#x20;
* Fixed menu height for mobile devices
* Fixed rules search


# 03-16 Mar Update

v0.5.4027 / 16 Mar 2023

## 🚀 Major Features

* Redesigned Publish section for easier sharing
* Ability to control camera height for editing in multiple levels - Change camera height from Navbar

<figure><img src="/files/SAB2pJwWwnfjh1fA0PPN" alt=""><figcaption><p>Camera Height</p></figcaption></figure>

* Ability to toggle between First Person and Fly controls in the editor from Viewport properties. Use ALT + Q as a shortcut to toggle switch

<figure><img src="/files/RxjMaWyK8pd0RjRdB3Ij" alt=""><figcaption><p>Fly Controls Toggle</p></figcaption></figure>

* Better color reproduction for Lights and 3D shapes

## ⏫ Minor Improvements

* Deprecated Geofencing
* New metadata “description” added to view links

## 🐛 Bug Fixes

* Fixed issue with DRAG TO MOVE UI appearing over menu
* Fixed scrolling issue with menu
* Fixed incorrect UI states for AND/OR rules


# 03-10 Mar Update

v0.5.3959 / 10 Mar 2023

## 🚀 Major Features

* ReadyPlayerMe Integration for [Avatar](/metaverse/player/avatars) System

<figure><img src="/files/BthIVrSEH5FoL3Mdy1j7" alt=""><figcaption><p>Avatar Selection</p></figcaption></figure>

* A new [Character element](/metaverse/build/elements/character) and ReadyPlayerMe Plugin for Filemanager. Characters can be imported from ReadyPlayerMe.

<figure><img src="/files/I0TZoV8vSxZjYBamLC1c" alt=""><figcaption><p>Character Plugin</p></figcaption></figure>

* Viewer Camera Mode - First Person/Third Person for 3D Scenes. Use [keyboard shortcuts](/metaverse/player/viewer-keyboard-shortcuts) to switch between the two.
* Branding feature consolidation - [Custom Loader](/metaverse/build/editor/project-settings/branding#custom-loader) is now a Professional tier feature, whereas [Remove Splash Screen](/metaverse/build/editor/project-settings/branding#remove-splash-screen) and [Remove 'Powered by GMetri' watermark](/metaverse/build/editor/project-settings/branding#remove-powered-by-gmetri-watermark) are Enterprise tier features.
* There is no longer a Starter Plan. Check available plans here:[Billing](/platform/billing#plans). Older customers who are already on the Starter Plan can continue to remain there.

## ⏫ Minor Improvements

* Preview URLs now start with “preview\.gmetri.com/…”
* On headset, a persistent overlay is visible to enter into Immersive mode
* Actionbar UI improvements
* Streamlined UI for menu, hamburger menu on top-right of the page uses only the required amount of space
* Rotation controls for Meta Quest controllers using the left thumbstick
* Button B interactivity for Meta Quest controllers
* Token expiry screen when viewer token expires

## 🐛 Bug Fixes

* Avatar heights are in sync between non-immersive and immersive modes
* Sideways running issue in 3D scenes in 3rd person view is fixed
* WASD keypress on properties/structure doesn’t trigger movement of the user
* Toast notifications are shown for all operations correctly
* Typo fixes for branding section
* Fixed lighting issue with 3D models
* Avatar Rotation in 3rd person mode
* Resolved UI issues with screenshare element
* Is In List rule for number variable
* Fixed issues in Comment Pins


# 02-07 Feb Update

v0.5.3839 / 07 Feb 2023

## 🚀 Major Features

* You can now add a Screenshare element and use it to share your screen with your peers in a 3 dimensional setting<br>

  <figure><img src="https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mgll1jjQMRTVj7p6n7g%2Fuploads%2FrtVfVoNogbRRc52DHZcd%2Fimage.png?alt=media&#x26;token=c22c37bc-c06b-4bd7-9fda-14054f6d0e50" alt=""><figcaption></figcaption></figure>

## ⏫ Minor Improvements

* Updated embed code to allow VR mode to work in embeds
* Aria-labels added for EmbedHtml elements
* Added placer 3d to pano elements
* Updated structures for signin signup pages (required for Google SEO)

## 🐛 Bug Fixes

* Handling expired preview links better
* Handling editor access errors better
* Removed rules from Collider Meshes - appear / disappear doesn’t work on colliders as of now
* In the area above the viewport, elements were not draggable. This is now fixed.
* Fixed an issue where the right bar properties tab doesn’t update when switching elements by adding a new element
* Fixed scrolling for metadata tab in File manager


# 01-24 Jan Update

v0.5.3778 / 24 Jan 2023

## :rocket: Major Features

* The Editor now shows the **sync status** for any changes made - just like Google Docs!

<figure><img src="/files/HYa06mObU9oX2MH5EIbZ" alt=""><figcaption><p>Editor Sync Status</p></figcaption></figure>

## :arrow\_double\_up: Minor Improvements

* Performance Improvements for the avatar system
* Performance improvements for beta features
* Improved mobile usability for multiplayer deployments using beta features and 3rd person mode
* In case of any network issues - the user is warned in around 30 seconds that changes aren't getting saved

## :bug: Bug Fixes

* Fixed tooltips on navbar
* Misc UI fixes for navbar
* Fixed rendering for Date-time picker for current time element in rules


# 01-10 Jan Update

v0.5.3734 / 01 Jan 2023

### :rocket: Major Features

* WooCommerce integration. There is now a WooCommerce plugin in GMetri. You can bring your existing stores built on WooCommerce easily into the Metaverse.
* A **Brand new Editor UI** [🥳](https://emojipedia.org/partying-face/) 🎉

  We have removed the left bar, and moved a lot of the functionality to a new bar, paving way for a sleeker UX and faster improvements

<figure><img src="/files/G49vVstOEEVwe0Re37Ds" alt=""><figcaption><p>New Editor UI</p></figcaption></figure>

* Improved Avatar System

### :arrow\_double\_up: Minor Improvements

* A lot more ready to use "My Metaverse Rooms" added

### :bug: Bug Fixes

* Fixed issue with EmbedHTML and EmbedSCORM element where it makes a unnecessary request to server.&#x20;
* Fixed issue where screen gets locked in mobile phones
* My Metaverse Rooms use organization cname if present
* Fixed search in Resources Panel
* Fixed duplication of deployment for My Metaverse Rooms
* Fixed jittery transform control while dragging elements. Sometimes while dragging elements the controls used to disappear
* Fixed loading issue for V4 editor


# 2022


# 12-08 Dec Update

v0.5.3589 / 08 Dec 2022

### :rocket: Major Features

* A new section at the top of you portal - **My Metaverse Rooms** which is a set of deployments that you can use out of the box with a GMetri account.

<figure><img src="/files/ocA8qU7wABjPucEstu5o" alt=""><figcaption><p>My Metaverse Rooms</p></figcaption></figure>

* Replaced "Cube Collider" with "**Collider Volume**" elements that allows many shapes like sphere cube, cone, cylinder, sphere, polygon and torus.
* Added a new element "**Collider Mesh**" that allows you to specify a 3D file (glb or gltf) as a collider.
* Added a new property "**Mouse Jump**" to both collider elements that lets you decide if the user should be allowed to jump on the collider using right click or not.
* Added a new element "**Workspace Logo**" that gets replaced with the Workspace Logo (or the Project Logo if you have specified that) depending on which workspace the project is in.
* Added a new property to 3D elements - **Environment Map Intensity**. This can be used to reduce any "burn" in  a 3D Model caused by the environment map selected in a scene.

### :arrow\_double\_up: Minor Improvements

* Added **Fly Controls** to editor. This can be toggled only through the shortcut `alt` + `q` as of now.
* Added ability to both add and replace users to the Viewer Group type "**Custom List**".
* In **Host Mode,** in case the number of participants is large, a few of the names go below the page. Now there’s a scrollbar to help with this.
* **Team Members count** is a lot more lenient now in accordance with the latest pricing.
* Rules are now **tracked** even for the rule (“**Open URL**” on the same tab). Earlier, because of the page switch, the rule didn’t get tracked

### :bug: Bug Fixes

* In the rules "Open Deployment", fixed overflowing content in the open deployment modal to choose deployments from
* Fixed API where on renaming deployment name, the new deployment name should not be a part of deployment list
* Better WebGL crash messages
* The default rule that was part of a new experience crashed viewer. This is now fixed.
* Fixed an issue where in certain cases, audio chat didn't work in scenes with long names


# 11-13 Nov Update

v0.5.3429 / 13 Nov 2022

### :rocket: Major Features

* **Adaptive Graphics** that adjust the graphic details according the hardware device The editor can control the initial value for adaptive graphics between high, low, and adaptive (default).

<figure><img src="/files/cmi2T01hy4QfVssyXP9Z" alt=""><figcaption><p>Adaptive Graphic Controls</p></figcaption></figure>

* Ability to select any **Custom Environment Maps** by selecting an .HDR or image file as the environment map for the whole scene, apart from the default options provided.

### :arrow\_double\_up: Minor Improvements

* Removed mouse jump controls from scene bounds, walls and ceiling.
* **Collaboration controls displayed above screen-share** - so the user can mute/unmute mic while a screen is being shared.

<figure><img src="/files/UiG9GWww2HzxKgJaNSnL" alt=""><figcaption><p>Collaborations controls are now over the screenshare</p></figcaption></figure>

* Screenshare section now **shows name** of the user sharing it.

<figure><img src="/files/fsFOhqrNJRA6fKCcG5El" alt=""><figcaption><p>Name of the person sharing screen show up above the screen</p></figcaption></figure>

* **Ripple animation** on the mobile joystick to direct the user’s attention to it. Tooltip added to the joystick.

<figure><img src="/files/o6vWat6QgLVaHpItXWY0" alt=""><figcaption><p>Ripple animation on Joystick</p></figcaption></figure>

* **Lights** can now be shown/hidden via Rules.

<figure><img src="/files/LMesvBbwRxT9U6jdZ7fv" alt=""><figcaption><p>Lights can be shown/hidden via rules</p></figcaption></figure>

* In Rules, Point To and Change to Scene are now **“Viewer” actions** instead of Environment and Scene earlier.

<figure><img src="/files/AmXv24jS2548ngPrzvxY" alt=""><figcaption><p>Change to scenen and Point to actions moved to "Viewer"</p></figcaption></figure>

* Defaults for multiplayer settings call/screenshare/chat are now checked.

### :bug: Bug Fixes

* Tooltip on top of the mouse jump control now disappears on time.
* Scene bounds in certain cases weren’t editable. This is now fixed.
* Certain bugs in timezone and date/time selection in “Current Time” rules fixed.
* Fixed issue with End Experience rule when current scene and initial scene are same.
* Updated error messages for load from another experience deployment type.


# 11-07 Nov Update

v0.5.3381 / 07 Nov 2022

### :rocket: Major Features

* **3D Scenes** are now no longer Beta!
* **Simple Movement Controls** for Desktop - now you can right click to move

<figure><img src="/files/m6I2VTbyS08hfTGg7O7I" alt=""><figcaption></figcaption></figure>

### :arrow\_double\_up: Minor Improvements

* Sign up pages now look a litte more exciting

### :bug: Bug Fixes

* Zone actions (via rules) now work even if they were hidden earlier once and then “shown” later (via appear rule)Fixed an issue with USDZ generation for 3D models


# 10-26 Oct Update

v0.5.3331 / 26 Oct 2022

### :rocket: Major Features

* **DRACO** compressed models are now supported. This allows you to use models that are highly optimized for the web. Learn more about DRACO compression [here](https://google.github.io/draco/).
* The **Control Panel** underwent an upgrade. You now get "Fullscreen", "VR mode", "Reset rotation" neatly tucked into it. Comments too have been moved inside. It's also now easier to join calls.

<figure><img src="/files/E6XLUbwtvGsCFPjuCWxg" alt=""><figcaption><p>New Control Panel</p></figcaption></figure>

* **Branding section** now contains logo, metadata and support message options

<figure><img src="/files/vSWFHhFyIP1tIX8iRJul" alt=""><figcaption><p>New Branding Section</p></figcaption></figure>

### :arrow\_double\_up: Minor Improvements

* Added ability to **purchase credits** from the billing page
* **Performance upgrade** for the editor. This was a major internal rewrite of the editor. The editor should now feel "snappier"

### :bug: Bug Fixes

* Docs links in the editor fixed
* Fixed an issue with USDZ generation for 3D models
* Fixed miscellaneous crashes when modifying elements like quiz and actionbar
* Fixed issues with removing users from the Team Members list
* Fixed issues with invalidation of user invites


# 10-14 Oct Update

v0.5.3231 / 14 Oct 2022

### :rocket: Major Features

* **PBR materials** are now supported in 3D Models
* New name bubble design over Avatars
* Restructured **Branding section.**

### :arrow\_double\_up: Minor Improvements

* New deployments are **Live** by default
* There are new auto-generated variable for tracking the viewer's last name and full name
* Users are hidden when they enter the spawn zone

### :bug: Bug Fixes

* Preventing access to the editor without a valid uuid
* Fixed inconsistency with durations on the Deployment Analytics page
* Fixed styling issues on Analytics page
* Fixed clickability issues with Colliders
* Viewer name gets computed correctly for CustomList login
* Fixed movement when typing inside chatbox
* Fixed the avatar selection screen
* Fixed OEmbed URL expansion when using an alias for workspace name
* Editor blocked on unsupported browsers


# 10-01 Oct Update

v0.5.3179 / 01 Oct 2022

### :rocket: Major Features

The much awaited VR mode support is finally here! :tada:

* You can now **move within VR mode** using headset controllers. You can move using either the **thumbstick** or **cursor click**.
* Editors can upload upto **6 custom avatars** that can be used by viewers
* Editors can specify **room member and instance limits** to control how many viewers can stay in a room simultaneously.
* Using **host mode** you can now **kick and mute viewers** in the room.
* Send **notifications to all viewers** on a link!
* You can now trigger **rules based on a time** by using "current time" in the rules dropdown.

### :arrow\_double\_up: Minor Improvements

* **Firefox** support added
* Ability to **change viewer height** from scene properties
* Other viewers are hidden when they are within 1.5M of the player
* A **new analytics page** to check all viewer sessions

### :bug: Bug Fixes

* File Manager: Fixed post processing for 3D models - Thumbnail and USDZ generation
* File Manager: Small UI fixes to improve usability
* Fixed leaderboard when lead generation is enabled
* Made a security fixes to plug an XSS scripting attack vector
* Initial implementation of Webhooks.


# 08-26 Aug Update

v0.5.2753 / 26 Aug 2022

### :rocket: Major Features

* You can now add **rules to load another GMetri experience**. This allows you to create a web of Metaverses from a single central space.
* You can now **select different 3D Avatars** for multiplayer deployments.

{% embed url="<https://youtu.be/A4ThVqOy8OE>" %}
Selecting your own Avatar
{% endembed %}

* **Collaboration section re-structured** for better visibility of available features.
* You can now send **Notifications** to all Viewers live on a particular deployment. This works only if Multiplayer is enabled.

{% embed url="<https://youtu.be/EzwANP6QIXM>" %}
New Collaboration Section, Notifications
{% endembed %}

### :arrow\_double\_up: Minor Improvements

* You can **select a Project thumbnail** via Settings. This is the thumbnail that gets used when sharing the published project (deployment) in social media.
* Large number of assets added to the "**Assets by GMetri**" file manager plugin. This should help you get started faster.
* "Hide" enabled for **ambient light**, and "Hide" and "Lock" enabled for **directional light**.

<figure><img src="/files/xZngfpUETnvE3iZcPez2" alt=""><figcaption><p>Ability to hide lights</p></figcaption></figure>

* Appropriate **warnings** are now shown while selecting files that don't meet asset recommendations.

<figure><img src="/files/S0MPphZzNrF5DbNYd3MI" alt=""><figcaption></figcaption></figure>

### :bug: Bug Fixes

* Fixed rotation of 3D scenes.
* Duration column in Analytics section fixed.


# 08-02 Aug Update

v0.5.2894 / 02 Aug 2022

### :rocket: Major Features

* **Collider Boxes** and **Scene Bounds** for 3D scenes. These allow you control where a player can move, and improve collision detection performance. 3D scenes are now smoother as a result.

<figure><img src="/files/iRAuZauE0xlmHYmd9hFz" alt=""><figcaption></figcaption></figure>

### :arrow\_double\_up: Minor Improvements

* We reworked how the **preview button** works at the top right corner of the editor. <img src="/files/P5bYZtqwjx3JN5lYPexH" alt="Preview" data-size="original"> The Preview popup now shows options to open the preview in new tab, scan a QR code or go to deployments to publish the experience

<figure><img src="/files/T06ITS56auQcbIaJAavb" alt=""><figcaption><p>Preview Popup</p></figcaption></figure>

* New display options have been added to the **SCORM element - Fullscreen, Fullscreen without close**. The SCORM element allows you to embed SCORM modules within a GMetri experience.
* Email verification screen is shown when a user’s email isn’t verified

### :bug: Bug Fixes

* Fixed workspace logo updates
* Thumbnails are correctly generated whenever projects are duplicated
* Fixed an issue with SCORM files processing
* Correct error messages are shown in preview links whenever the preview session expires (15mins)


# 07-01 July Update

v0.5.2753 / 01 July 2022

### :rocket: Major Features

* Environment element now allows user to select any custom file as the environment

{% embed url="<https://twitter.com/amit_rajput1992/status/1544267934691762176?s=20&t=DdffMrzPda_F9rl4YYzmWQ>" %}

* Billboarding now supports 3 modes - Y, XY and XYZ

{% embed url="<https://twitter.com/_sahilahuja/status/1544565106893213697?s=20&t=xIfZFt1SYIXoqQ80UC23yQ>" %}

* Text chat for Multiplayer.
* Spawn zones in 3D scenes. This allows setting the starting position in a 3D Scene.
* Multiplayer mode now enabled in all scene types - 360 scene, Orbit scene and 3D scene.

### :arrow\_double\_up: Minor Improvements

* Allowing custom project thumbnail from Settings -> Upload Project thumbnail
* Uploaded files in file manager no longer need a refresh to become selectable
* More structure and files added to `Assets by GMetri` Plugins

### :bug: Bug Fixes

* Fixed green screen color defaults
* Fixed horizontal alignment on text elements
* Fixed Zone Element’s scaling uniformity
* Fixed hotspots compatibility with VR mode and flickering issues&#x20;


# 06-08 June Update

v0.5.2642 / 08 June 2022

![Environment Maps](/files/nvxFqaqwd9rHL1ypsTdS)

### :rocket: Major Features

* Bloom effects for 3D objects&#x20;
* Environment Maps for 3D objects

{% embed url="<https://twitter.com/_sahilahuja/status/1537504887390339073?s=20&t=tjergWiugF7F6LBBNnKHZg>" %}

### :arrow\_double\_up: Minor Improvements

* Upgraded screens for Premium Features&#x20;
* Added Teasers for upcoming features
* Simplified billing

### :bug: Bug Fixes

* Fixed a few issues with links built on older version


# 05-20 May Update

v0.5.2508 / 20 May 2022

### :rocket: Major Features

* New joystick developed for navigation on mobile phones&#x20;
* ProductCard element simplified to work with e-commerce plugins

### :arrow\_double\_up: Minor Improvements

* Horizontal alignment fixed for Text element&#x20;
* Locked and hidden properties added to Hotspot element

### :bug: Bug Fixes

* Fixed bug with sketchfab imports when opened from the properties panel
* Removed un-used actions from light element


# 05-05 May Update

v0.5.2383 / 05 May 2022

A major release this time with 3D Scenes

![](/files/IzyWug3PMvviWFWhe0du)

### :rocket: Major Features

* 3D Scenes enabled for all users :partying\_face: &#x20;
* Added a new element - Environment (Environments are 3D spaces)
* New SignUp and SignIn pages!

### :arrow\_double\_up: Minor Improvements

* Adding scenes now adds relevant elements like lights and pano Improved PointTo algorithm to ensure rotation is always linear

### :bug: Bug Fixes

* Fixed an issue with invites&#x20;
* Fixed an issue where users were getting logged out of the editor, ensured users always have fresh session tokens


# 04-25 Apr Update

v0.5.2306 / 25 April 2022

### :rocket: Major Features

You can now share your screen on multiplayer mode!

### :arrow\_double\_up: Minor Improvements

* Improved file processing UX.&#x20;
* Added a preview for PDFs.&#x20;
* We now stream Y positions while viewing others' avatars in 3D scenes. (You can now see people jump.)

### :bug: Bug Fixes

* Added support for mpeg audio files.&#x20;
* Fixed click issue for touchscreen laptops.&#x20;
* Massive performance updates in 3D mode.


# 02-11 Feb Update

February 2022 Update (Teaxr v0.5.1902)

### :rocket: Major Features

* Editor
  * Users are greeted with an **onboarding guide**
  * **Rolling out V5 Editor** as default editor for new projects and option to upgrade existing v4 projects to v5 projects
  * A new **Resource Panel** has been added with lots of useful links and guides
  * Ability to **convert TTS to Audio** element
* Viewer
  * Option to **"Enable Multiplayer mode"** which shows all the connected viewers on view links. Option can be paired with comments and enabled from the publish section
  * Ability to use **"find and replace"** rules with string variables
* Website
  * New website rollout

### :arrow\_double\_up: Minor Improvements

* Editor
  * **Scroll position** now doesn’t reset when switching between Properties and Structure Tabs
  * 3D Models can be previewed in the File Manager
  * Ability to control the **preview banner of any video** element being shown in the Editor, controlled within the Preview Popup
  * Search now works in Rules’ dropdowns
  * Element/Scene address can now be copied from the Properties Panel toolbar

### :bug: Bug Fixes

* Editor
  * Copy-Paste actions fixed for group elements
  * Fixed File Manager searching for Drew Pano and GMetri Pano Plugins
  * Correct mimetype added to TTS files
  * **Text alignment** properties now work consistently between the editor and viewer
  * **Color picker** in the right bar now picks up correct colors
* Viewer
  * Improved error handling and error reporting
  * Fixed billboarding for Oculus Quest 1


# 01-28 Jan Update

January 2022 Update (Teaxr v0.5.1839)

### :rocket: Major Features

* Editor
  * New properties for text element including background color, background opacity, border color, border thickness. Also added ability to upgrade any existing text element to enable all the new properties
  * A new grow animation option added to all 3d elements.

### :arrow\_double\_up: Minor Improvements

* Editor
  * Documentation for GMetri Plugin Ecosystem
  * Elements can be added inside groups directly from the add element UI
* Viewer
  * Viewer performance optimizations to reduce network calls overhead

### :bug: Bug Fixes

* Viewer
  * Actionbar element styling fix for devices with smaller resolutions
  * Capture text element matches text with regex validation correctly
  * Embed HTML element appears in popup mode when pip is selected to maintain consistency of the UI
* Portal
  * Fixed views and viewers count on deployment analytics page


# 01-10 Jan Update

January 2022 Update (Teaxr v0.5.1723)

### :rocket: Major Features

* Portal
  * New Pricing pages and billing setup for new subscribers
* Viewer
  * GMetri view links are now oEmbed compatible
* Editor
  * Unlimited deployments for all tiers
  * Fonts support for timer element

### :arrow\_double\_up: Minor Improvements

* Portal
  * User profile page now shows an API token that can be used with the plugin system
* Editor
  * Elements can be copy-pasted inside groups

### :bug: Bug Fixes

* Editor
  * Fixed issue with sketchfab imports
  * Fixed issue with deletion of grouped elements
  * Fixed issue with settings panel for projects migrated from v4
  * Rules can be added to actionbar items + Files can be selected for actionbar items when element is inside a group
* Portal
  * Fixed advanced analytics links
  * Deployment analytics and org analytics pages show same data and date range filters
  * Fixed date range selection on deployment analytics page


# 2021


# 12-10 Dec Update

December 2021 Update (Teaxr v0.5.1632)

### :rocket: Major Features

* Portal
  * Leaderboard analytics enabled for all tiers
* Editor
  * Unlimited deployments for all tiers
  * Fonts support for timer element
* Viewer
  * New Anchored mode for EmbedHTML element which allows to fix HTML content on top of a target element
  * Improved login and viewer state management for deployment links

### :arrow\_double\_up: Minor Improvements

* Portal
  * General improvements to increase responsiveness on analytics pages
  * Feature restrictions w\.r.t to Pricing 2021
  * For new signups 1st project created is always V5
* Editor
  * Volume option can be enabled from preferences
  * Instructions element renamed to Stories

### :bug: Bug Fixes

* Editor
  * Fixed issue with audio element preview and file selection
  * Fixed issue with AR element file selection
  * Removed textbox placeholders from unwanted places
  * Fixed dropdown displays for boolean variables
* Viewer
  * Actionbar UI fixed for device having < 360px of height in landscape mode
  * Fixed issue with whitespace on iOS devices
  * Fixed issue with Viewer Form data save
  * Fixed dropdown styling on shopping card
* Portal
  * Back to Experience links fixed on analytics page
  * Fixed google login


# 12-01 Dec Update

December 2021 Update (Teaxr v0.5.1567)

### :rocket: Major Features

* Portal
  * A new section with Variable Stats added to the Analytics page
  * Advanced Analytics show more information about per scene analytics

### :arrow\_double\_up: Minor Improvements

* Editor
  * Renaming viewer form fields also renames the linked variables
  * General UI improvements
* Viewer
  * Scene names are tracked and can be seen in the advanced analytics section
  * Control panel doesn’t appear If no items can be shown

### :bug: Bug Fixes

* Editor
  * Color Picker crashes fixed
  * Removed hidden operation for Popup element from toolbar
  * Allow selection of sprite files for Popup sprite mode
* Viewer
  * Media Upload camera output can be seen correctly on iOS devices
  * Better scene transitions when 2D elements are involved like Popup/Quiz/Actionbar etc


# 11-26 Nov Update

November 2021 Update (Teaxr v0.5.1524)

### :bug: Bug Fixes

* Editor
  * New scenes will automatically get added to the menu
  * QRMatcher rules show correct entries in rules
  * Directional light impacts all 3D models correctly
  * Timer position shows correctly in editor and viewer
  * Green screen effect on videos
  * Fixed issue with viewer form not working when there all entries are deleted
  * Fixed issue inconsistent menu entries when scenes are deleted
  * Geolocation can now be used from the deployment section
  * Linked variables with media upload are shown correctly in the “Autogenerated” variables section
* Viewer
  * Multiple fonts for text elements can be used on iOS devices
  * Fixed fluctuations on mobile devices when using scene range locks
  * Instructions element skips entries that don’t have any asset selected
  * Removed viewer state save calls for preview mode
  * Large viewer state updates now allowed
* Portal
  * Deprecated editor login
  * Fixed Azure login


# 11-17 Nov Update

November 2021 Update (Teaxr v0.5.1483)

### :rocket: Major Features

* Editor
  * Added safe names for files uploaded and variables names to resolve special characters.

### :arrow\_double\_up: Minor Improvements

* Editor
  * Updated preferences page in deployment section
  * Added functionality to download comments from the Publish section
  * Improved updates from number/decimal properties
  * Revamped variables and support sections.
  * Added relevant toasters and loading indicators.
* Viewer
  * For embed HTML element, popup mode becomes full screen on mobile phones
  * Error screen with refresh button added for experiences with stale login.

### :bug: Bug Fixes

* Viewer
  * Fixed inconsistent height for quiz element
  * Fixed multiple updates in singular option not happening in quiz element
* Portal
  * Fixed analytics page views table UI and functionality.
  * Fixed geolocate failures


# 11-12 Nov Update

November 2021 Update (Teaxr v0.5.1446)

### :rocket: Major Features

* Viewer
  * Better transparency management and rendering of all elements
* Editor
  * Undo-Redo can be accessed using keyboard shortcuts. The list of all keyboard shortcuts is published [here](https://www.gmetri.com/docs/platform/create/experience/keyboard_shortcuts)

### :arrow\_double\_up: Minor Improvements

* Editor
  * Adding new element when a group element is selected adds it within the same group
  * For all elements that have background\_source, 3d\_model\_source, a new option to remove the selected assets
  * Deprecated text length from viewer form

### :bug: Bug Fixes

* Editor
  * `On End` event added to instructions element. Fires when all stories have finished
  * FOV change shows up correctly in the 360 environment
  * Updates to experience can be viewed correctly in the preview/view links. Experience data/cache gets updated correctly.
  * Correct updates to deployment authentication
* Viewer
  * Fixed billboarding in VR mode
  * Fixed issue with Product card where it doesn't show `3D Model` button


# 11-09 Nov Update

November 2021 Update (Teaxr v0.5.1426)

### :rocket: Major Features

* Viewer
  * Shopping element and product card redesign

### :arrow\_double\_up: Minor Improvements

* Editor
  * Toaster is shown on all updates in the publish section
  * Rightbar panel design updates
  * On adding new section in popup, all previous sections auto collapse
  * Add red bounding box even when elements are locked
* Viewer
  * Deprecated: Scene pitch correction. All scene pitch correction in scene gets converted into point to rules automatically.

### :bug: Bug Fixes

* Editor
  * Reset view not working in orbit mode fixed
  * Dragging in Orbit mode fixed
  * Changed all docs links on portal and editor
  * Action bar rules’ 3rd element inconsistency when updated from v4 to v5 fixed
  * Project property defaults shown correctly
* Viewer
  * Pitch range min value not working fixed
  * Product card, quiz position fixes
* Portal
  * Fixed new project creation flow.


# 11-02 Nov Update

November 2021 Update (Teaxr v0.5.1406)

### :rocket: Major Features

* Editor
  * All connected user can be seen on the bottom left on the editor window.

### :arrow\_double\_up: Minor Improvements

* Editor
  * General UI updates for properties and structure panels
* Viewer
  * An error message is displayed to the viewers when there is network disconnection

### :bug: Bug Fixes

* Editor
  * Improved element/scene deletion resolution for multiplayer system
  * Timer element durations are correctly displayed in the editor
  * Nested elements within groups can be selected from Structure Panel
  * Pivot point support added for 3D Shapes (Polygon/Cube/Sphere/Cone/Torus/Cylinder)
  * Rules delays show correct values in the rules panel
  * UI updates for Capture Input, Share and Product card elements
  * Fixed element renaming from properties panel
  * Increased text box character limit to 5000 characters
  * Fixed Rules UI Logic map loading states
  * Popup element - Added correct restrictions for selecting files from File Manager
  * Fixed rules updates when elements are deleted from the scene
* Viewer
  * Pivot point support added for 3D Shapes (Polygon/Cube/Sphere/Cone/Torus/Cylinder)
  * Quiz element shows at least 4 items without a scrollbar.
  * Quiz element - Fixed background
  * Quiz element - Correct scores shown when quiz failed
  * Media element - Added correct restrictions for selecting files from device storage
  * Zoom disabling fixed for Android/iOS devices
  * Unsupported Browser warning added for firefox
* Portal
  * Docs links updated across the platform


# 10-26 Oct Update

October 2021 Update (Teaxr v0.5.1379)

### :rocket: Major Features

* Viewer
  * VR mode supports Point to action
  * VR mode supports animations during scene transitions
  * VR mode supports scene offset rotations

### :arrow\_double\_up: Minor Improvements

* Editor
  * Deprecated: Height from text elements
  * Deprecated: width/height/depth from cylinder
  * Improved updates from number/decimal properties
* Viewer
  * Deprecated: Scene pitch correction. All scene pitch correction in scene gets converted into point to rules automatically.

### :bug: Bug Fixes

* Editor
  * Gracefully handling all resource failures to remove any unwanted crashes
  * Fixed errors while adding new text elements
  * Updates to experience can be viewed correctly in the preview/view links. Experience data/cache gets updated correctly.
  * Correct updates to deployment authentication
* Viewer
  * Disallow rotation using mouse scroll when gyro lock is enabled in a scene
  * Fixed text input in comments to clear text on submit and prevent text clipping
* Portal
  * Fixed new project creation flow.


# 10-21 Oct Update

October 2021 Update (Teaxr v0.5.1362)

### :rocket: Major Features

* Multi-user editing support for editor
* Improved analytics views for deployments
* UI Upgrade for editor

### :arrow\_double\_up: Minor Improvements

* Editor:
  * Improved copy and paste operations for scenes and elements
  * Updated dynamic event and action selection logic for rules when switching between elements
  * Updated correct steps for all properties using number inputs

### :bug: Bug Fixes

* Portal:
  * Advanced Analytics page access fixed for users with analytics roles
  * Geolocation and maps in analytics shows correct locations
  * Login fix for experiences using SCORM packages
* Viewer:
  * Added a few missing emoji icons
  * Fixed page crashes when navigating quickly between scenes from menu


# 10-14 Oct Update

October 2021 Update (Teaxr v0.5.1315)

### :rocket: Major Features

* Speed improvements for view links for USA and surrounding regions
* Copy and Paste functionality for scenes and elements using CTRL+C/CTRL+V keyboard shortcuts
* New docs at <https://www.gmetri.com/docs/>

### :arrow\_double\_up: Minor Improvements

* Editor: User notifications when network gets disconnected while editing an experience

### :bug: Bug Fixes

Editor:

* Fixed project duplication for v5 projects
* **has been clicked** event added back to the list of events in rules page
* Fixed issues with elements inside duplicated groups

Viewer:

* Fixed viewer token forwarding issue


# 09-27 Sep Update

September 2021 Update (Teaxr v0.5.1224)

### :rocket: Major Features

* Editor version 5 beta released and enabled for partners
* Update Viewport controls for editor v5 includes Bounding Box, Orbit mode and Gizmo options
* Dynamic loading for rules UI
* Videos/Audio/PDF can be uploaded via Media Upload element

### :bug: Bug Fixes

* Hover action disables built-in bounce animation
* Leaderboard and analytics fixes
* Project duplication to a different workspace correctly copies all files
* Updated preview link for experiences in portal listing page
* Design fix for mobile devices for Popup and Embed HTML


# 08-31 Aug Update

August 2021 Update (Teaxr v0.5.876)

### :arrow\_double\_up: Minor Improvements

* Project duplication is instantaneous

### :bug: Bug Fixes

* Fixed WebGL crashes due to video memory leaks
* Org users with member access can now access viewer groups page
* AR elements shows selected file name when
* Fixed transitions when going from a gyro locked scene to a non gyro locked scene.
* Instruction element now shows the full length of the video
* Fixing sketchfab imports
* Media upload element allows uploading videos


# 07-20 July Update

July 2021 Update V2 (Teaxr v0.5.761)

### :rocket: Major Features

* New Volume and Tour mode controls for viewer links
* 0 downtime releases of services to production
* Progressive loading of pano elements. Shows a low res image to start the scene and loads the high res pano in the background.

### :arrow\_double\_up: Minor Improvements

* Tour mode speed reduced to avoid dizziness
* Viewer analytics now captures and show full URLs (vs. just the path like before)
* Added option for custom CNAME for viewer links
* Popup element - Increased visibility on sprite slider
* Global volume now applies in between scene changes
* Org admins can change role of team members to analytics

### :bug: Bug Fixes

* Fixed End Experience rule
* Default GMetri panos are not visible in experiences
* Fixed leaderboard filters
* Project search is now case insensitive
* Fixed zoom controls visibility based on project properties
* Fixed Product card and Popup heading issues
* Fixed text element render when using templates with urls
* QR Matcher now handles special characters (like in URLs) correctly


# 07-02 July Update

July 2021 Update (Teaxr v0.5.683)

### :rocket: Major Features

* V5 Viewer official release

### :arrow\_double\_up: Minor Improvements

* Logout and offlining option removed from Viewer Preferences
* Allow fullscreen and Allow VR are default checked in Viewer Preferences
* Preview section shows correct thumbnail on the Rightbar
* Better user role management on the portal

### :bug: Bug Fixes

A whole lot of bug fixes in the V5 viewer:

* Fixed initial rotation on mobile devices with gyro
* Fixed reset view on mobile devices
* VR mode disabled in unsupported devices
* Android edge is now supported without VR functionality
* Fixed hover functionality on all 3D elements
* Fixed timer pause and timer match events
* Media upload and QR matcher are now mobile compatible
* Smarter checks for rendering 3D elements


# 06-31 June Update

June 2021 Update (Teaxr v0.5.622)

### :rocket: Major Features

* Updated browser whitelisting for different OS and browsers
* 2 events are available as clickable actions: is\_clicked (resettable) and has\_been\_clicked (not-resettable)
* Actionbar notch now shows a contrasting color to the background
* Full support for Macbook touchpad in V5 viewer

### :arrow\_double\_up: Minor Improvements

* Ability to delete and update org logo from the settings page
* UI fixes on V5 screens
* Duplicate To dropdown in portal is now searchable. Search can be done on org slug or org name
* Removed option to Import and select for File manager plugins (sketchfab/flickr/GMetri panos/Drew panos)
* V5 deployment links can be accessed from publish section on the editor
* Reset View button can be enabled/disabled from editor
* UX changed on deployment slug renames when there are clashing deployments with same slug. User sees a toaster and the changes are reverted

### :bug: Bug Fixes

A whole lot of bug fixes in the V5 viewer:

* Hover events will now works correctly for 0 secs durations
* All Viewer Screens (Leadgen, Language, VR instructions etc) work seamlessly on mobile devices
* Actionbar variations on all devices (mobile/tablet/desktop) work as expected
* Fixed crashing Popups with 3d Models and AR elements on iOS devices
* Capture text no longer allows itself to be submitted with an empty string
* Media Upload UI fixed
* Fixed timer seek\_to and on\_end events
* Fixed scrolling issue on viewer screens for V5 viewer
* Fixed Custom list login page for V5 Viewer
* Enforce landscape screen shows a better graphic
* Fixed orbit controls clicks on mobile devices
* Mouse dragging works during scene transitions
* GMetri watermark is shown if whitelabel is disabled

Also,

* Fixed team invite flow on portal
* Automatically adding new scenes to menu if auto add new scene to menu property is checked on settings screen inside editor
* Non-live deployments are blocked from V5 viewer
* Fixed contact Drew page link


# Building


# Portal

The Portal give you an overview of all your experiences

An experience in GMetri is like a file in Photoshop or a project in MovieMaker.

## Portal Overview

You can see all your experiences in the *Portal*. To create a new Experience, click on "Create new Experience", type its name and press the arrow next to it.

![Experiences](/files/npIHzQCIZLYhaZTC1w5K)

{% hint style="info" %}
Duplicate experiences to version and backup your work
{% endhint %}

* Click on the experience to edit the experience by opening the *Editor*
* Use the bottom left menu to access more options

![](/files/gnTCOec2SZX9DobI5yFW) ![](/files/nDKvYTbMU9YfXCegzn9M) ![](/files/mK29yM0gRqYWLnn69ipu)

## Duplicate an Experience

Use the bottom left menu on the Experience thumbnail in the *Portal* to duplicate the experience.

## Duplicate an Experience to a different Workspace

* Use the bottom left menu on the Experience thumbnail in the *Portal* and select "Duplicate To"
* Select the Workspace you want to duplicate the Experience into

![](https://s.vrgmetri.com/image/q_90/gb-web/portal-docs/assets/img/screenshots/duplicate_to_modal.png.jpg#boxShadow)

* As the operation might take some time, you will get an email once the duplication is completed


# Team Members

## Teams

After signing up on GMetri, you get a default Workspace. You are the admin of your workspace. Admins can add team members and team members can create experiences in the workspace.

### Adding Team Members​ <a href="#adding-team-members" id="adding-team-members"></a>

To add a team member, head over to the settings page.

![Settings page](https://s.vrgmetri.com/image/q_90/gb-web/portal-docs/assets/img/screenshots/DAG/settings_navigation.png.jpg#boxShadow/)

* In the Team Members section click on `+ Invite` and then enter email address of the person you wish to add, to your organization.
* An invitation email is sent out to them.
* Once accepted, the person you invited gets added as a member of your organization.

### Removing Team Members​ <a href="#removing-team-members" id="removing-team-members"></a>

To remove a team member, head over to the Settings page and click on `remove` against a team member in the Team Members section and that team member will no longer have access to any of your organization's experiences.

### GMetri Portal role-based user access​ <a href="#gmetri-portal-role-based-user-access" id="gmetri-portal-role-based-user-access"></a>

GMetri users have three tiers of roles:

1. Admin (The first user of any workspace is the admin of that workspace)
2. Member
3. Analytics

If a user joins an already existing organization through an invite, the inviter has the ability to decide the role of that user using the “Team Members” section.

If a user joins an already existing organization (possible only if “auto join” for that workspace was enabled and the email domain matches) using the signup page, he/she is granted the member role after joining the organization. “Auto join” is a setting you see when creating a new workspace while signing up).

### What can the different roles access?​ <a href="#what-can-the-different-roles-access" id="what-can-the-different-roles-access"></a>

#### **Admin​**

An admin can do everything a member or an analytics user can do An admin additionally:

* Can access the settings page and change workspace related settings
* Has access to edit all experiences, and can add/remove collaborators from any experience

#### **Member​**

A member can do everything an analytics user can do. A member can additionally:

* Create new experiences. When you create a new experience you are automatically a collaborator of that experience.
* Any collaborator of an experience can invite more collaborators (who have an admin or member role) to collaborate on that experience. A “collaborator” of an experience is someone who can edit that experience.
* Publish projects they are a collaborator of and access analytics data for those experiences
* Access and modify “viewer groups” that can be used to restrict access and add authentication to published experiences

{% hint style="warning" %}
Note that members by default cannot edit all experience. Only those experiences to which they have been explicitly added as collaborators can be edited by them.
{% endhint %}

**Analytics​**

An analytics user can access aggregated analytics of all projects, and also access analytics of individual projects.


# Defining Global Variables

Global Variables are shared across all experiences in a workspace. These are helpful if you want to track your users journey across multiple GMetri experiences.

When the user moves from one experience to another in the same workspace, the values in global variables is preserved across experiences

## Defining Global Variables[​](https://www.gmetri.com/docs/platform/create/variables#defining-global-variables) <a href="#defining-global-variables" id="defining-global-variables"></a>

* Head over to `Settings` from the top right menu in your [Portal](/metaverse/build/portal).
* Click `Add Variable` in the `Global Variables` section

![Defining Global Variables](https://s.vrgmetri.com/image/q_90/gb-web/portal-docs/assets/img/screenshots/variables/defineglobalvars.png)

### **Adding the Global Variables defined above to the experience**[**​**](https://www.gmetri.com/docs/platform/create/variables#adding-the-global-variables-defined-above-to-the-experience)

* In the Project Editor, go to [Settings > Variables](/metaverse/build/editor/project-settings/variables-in-settings).
* Scroll down to see the `Global Variables` section. Use the dropdown to add the global variable you want to add.

Read more about Variables here:

{% content-ref url="/pages/4FdURXtqhp12wn0WgUZi" %}
[Variables](/metaverse/build/variables)
{% endcontent-ref %}


# Editor

The Editor is where you design and publish your experience

<figure><img src="/files/kmRZT5KUxC8iWWZnt7wC" alt=""><figcaption><p>The Editor</p></figcaption></figure>

The Editor is the interface you use to build your experience. It has 2 primary panels: Top bar and Right panel.

In addition, there's a Viewport Properties panel at the bottom left. Learn more about it at the link below:

{% content-ref url="/pages/qM8lDHuEjk191ApyHrY9" %}
[Viewport Properties](/metaverse/build/editor/viewport_properties)
{% endcontent-ref %}

## Top Bar

### Add Element

<figure><img src="/files/6ftstgGioNhsfj9S1V0m" alt=""><figcaption><p>Add Element</p></figcaption></figure>

Add various elements such as scenes, images, videos, GIFs, audio, and other multimedia components into your experience.

### Rules

<figure><img src="/files/cAcwHxycx37xbdfpMuHy" alt=""><figcaption><p>Rules</p></figcaption></figure>

Rules serve as the fundamental component of interactivity in your experiences.

{% content-ref url="/pages/mJPqUjlr5B6jUW6h6LBY" %}
[Rules](/metaverse/build/rules)
{% endcontent-ref %}

### File Manager&#x20;

<figure><img src="/files/6D4XLhuExxzkkjHs6qWl" alt=""><figcaption><p>File Manager</p></figcaption></figure>

You can manage/upload your assets from here.

{% content-ref url="/pages/6iCk4WJ2VVfAzdMXatrr" %}
[File Manager](/metaverse/build/editor/file-manager)
{% endcontent-ref %}

### Publish&#x20;

<figure><img src="/files/YIVkVgR95Xz5wacF53LE" alt=""><figcaption><p>Publish</p></figcaption></figure>

You can share your experience with the your viewers.

{% content-ref url="/pages/FBJg1PU2gN3DzxTTGLfC" %}
[Publishing](/metaverse/publishing)
{% endcontent-ref %}

### Preview&#x20;

<figure><img src="/files/wVEFUgYMUh0XRO0VbLee" alt=""><figcaption><p>Preview</p></figcaption></figure>

{% content-ref url="/pages/eEa4ADd56U925lHmuDqU" %}
[Preview](/metaverse/build/editor/preview)
{% endcontent-ref %}

You can preview your experience before going Live and sharing it with your viewers from here.

## **Right Panel**&#x20;

### Properties

You can adjust/ modify the properties of the currently selected element.

<figure><img src="/files/o8I8N5jUnS3nFOHYdvIT" alt=""><figcaption><p>Properties</p></figcaption></figure>

### Structure&#x20;

This displays a comprehensive list of all the elements, scenes, and lighting configurations used in your virtual environment.

<figure><img src="/files/rwzr2FH6uPDEXiEfGZ67" alt=""><figcaption><p>Structure</p></figcaption></figure>


# File Manager

All assets used in GMetri experiences are managed using the Fila Manager.

You can access the File Manager insider the editor by clicking on the **folder icon** on the left bar.

![File Manager](https://s.vrgmetri.com/image/q_90,w_500/gb-web/portal-docs/assets/img/screenshots/file_manager/file_manager_screen2.png.jpg#boxShadow)

## Uploading assets[​](https://github.com/gmetrixr/gitbook-docs/blob/main/metaverse/build/broken-reference/README.md) <a href="#uploading-assets" id="uploading-assets"></a>

To upload assets, **drag and drop** any number of file or folders to the file manager screen.

* Doing this will open up the uploader modal and add all the files and folders for uploading.

![File Manager](https://s.vrgmetri.com/image/q_90,w_500/gb-web/portal-docs/assets/img/screenshots/file_manager/file_manager_screen5.png.jpg#boxShadow)

* Click on the upload button on the bottom right to start the upload process. A progress bar at the bottom tells you the upload status.

![File Manager](https://s.vrgmetri.com/image/q_90,w_500/gb-web/portal-docs/assets/img/screenshots/file_manager/file_manager_screen4.png.jpg#boxShadow)

## Selecting files using File Manager[​](https://github.com/gmetrixr/gitbook-docs/blob/main/metaverse/build/broken-reference/README.md) <a href="#selecting-files-using-file-manager" id="selecting-files-using-file-manager"></a>

* Select the element that you want to change the file for, and click on properties tab. Then select the `File Select` icon.

![File Manager](https://s.vrgmetri.com/image/h_400,q_90/gb-web/portal-docs/assets/img/screenshots/file_manager_selection_mode.png#boxShadow#boxShadow)

* This opens the File Manager in `Selection Mode`. You can **Selection Mode** can be enabled by clicking on the upload icon in the element properties on the rightbar:

![File Manager](https://s.vrgmetri.com/image/q_90,w_500/gb-web/portal-docs/assets/img/screenshots/file_manager/file_manager_screen6.jpg#boxShadow)

{% hint style="danger" %}
You will not be able to select a file if you open the file manager from the left bar, as this opens the **"Browsing mode"** and not the **"Selection mode"**
{% endhint %}

### Uploading 3D Models[​](https://github.com/gmetrixr/gitbook-docs/blob/main/metaverse/build/broken-reference/README.md) <a href="#uploading-3d-models" id="uploading-3d-models"></a>

Steps for uploading `glb` and `gltf` (zip) models:

1. **GLB** - This is usually a single file that contains information for all images, textures and animations used in the 3D model. This file can be uploaded like any other asset such as image, audio or video.
2. **GLTF** - This is usually a combination of a few files. A sample gltf 3D model would contain at least 1 `.gltf` file, 1 or more `.bin` files and 1 or more `image` files. To upload and use a GLTF 3D model, simply **zip** up all the files keeping the folder structure intact, drag and drop on the file manager screen and click the upload button. This zip file will be available for use in a few moments after we are done processing the file.


# Selecting a file

When adding a file to your experience, there are two options.

## By selecting the available plugins from the GMetri inventory.

### Step 1: Select element in Stuture Panel

Upon adding an element (360Scene, Orbit Scene, 3D Scene), you will be automatically redirected to "Structure" on the right bar of your deployment.

<figure><img src="/files/8WGMSWolqoGVSDXqExBa" alt=""><figcaption><p>Structure in the workspace</p></figcaption></figure>

### Step 2: Open Properties Panel

To select a file, navigate to Pano image > Properties > Upload / Choose file.

<figure><img src="/files/ZZm0KK1ZfcPnnWAGzQik" alt=""><figcaption><p>Pano Image - choose file</p></figcaption></figure>

### Step 3: Click on any of the assets from Plugins

It will then redirect you to Files Manager > Plugins > Folders > Files

Click on any of the assets from Plugins tab to Explore the options.

<figure><img src="/files/731QMl2tTvKz2OtBTmVt" alt=""><figcaption><p>Choosing files from Gmetri Plugins</p></figcaption></figure>

### Step 4: Choose from the folders

You will then be redirected to the assets from the plugin you have chosen. There are folders that provide various options to add 3D models, Audio, GIF, Greenscreen videos, Images, Pano Images, Pano videos and videos.

<figure><img src="/files/AFSbukJ6ZTgeOn17pPo6" alt=""><figcaption><p>Selecting GMetri Asset</p></figcaption></figure>

### Step 5: Select from imported fileds

Navigate to Images > Files > Select the image > Import

<figure><img src="/files/IiOrahQ7apH0OHEXG8N4" alt=""><figcaption></figcaption></figure>

### Step 6: Imported files

Once you have imported the file, you will see a pop as below

<figure><img src="/files/Ds4i2gpUkbcgHqoUOb3A" alt=""><figcaption><p>Importing file pop-up</p></figcaption></figure>

### Step 7:  Select and upload your file

You can now go back to the deployment and choose Upload/ Choose file > File Manager > My Assets > Folders > My Imports > Images >Files > Choose the image and click "Select"

<figure><img src="/files/r33jIG59Kqkk8X0xi0an" alt=""><figcaption><p>My Imports</p></figcaption></figure>

<figure><img src="/files/ihuN9SaKSiAToC62O0YS" alt=""><figcaption><p>Selecting a file</p></figcaption></figure>

## By uploading files from your computer.

### [Step 1](#step-1) and [Step 2](#step-2)

### Step 3:  Upload from your computer

By clicking the "Upload" on the right side bar of your deployment, you can add the files from your computer.

<figure><img src="/files/LQf8Hk3ZcYGdwO6i1Ruv" alt=""><figcaption><p>Upload</p></figcaption></figure>

### Step 4: Drag and drop or browse your files

The pop-up box will let you drag and drop or browse files from your computer.

<figure><img src="/files/zmE2k3B8ChVdEzSONdwC" alt=""><figcaption><p>Drop files - Upload </p></figcaption></figure>

### Step 5: Upload a selected file

The selected file then will be available for you to upload.

<figure><img src="/files/fHd7lxuxBVEqWIe0Y65K" alt=""><figcaption><p>Upload a file</p></figcaption></figure>

### Step 6: Select from files

You can then go to File Manager >  Files > Select&#x20;

<figure><img src="/files/DKOSqw8L85CaKIFptvpm" alt=""><figcaption><p>Selecting a file</p></figcaption></figure>


# Sketchfab Integration

Sketchfab is a web-based platform that enables users to upload, share, and display 3D models and animations online.

Sketchfab.com makes it easy for anyone to publish and find 3D content online. With a community of millions of creators and published models, they are one of the largest platforms for immersive and interactive 3D content.&#x20;

Integrating with Sketchfab allows you to search the entire Sketchfab database of 3D assets and bring it right into your own Metaverse!

## Importing a Model from Sketchfab into your Asset Library

Once you click on 'File Manager', Sketchfab will become visible to you.

<figure><img src="/files/wU4wMgIMQYcjwLxdk6yz" alt=""><figcaption><p>Sketchfab from File Manager</p></figcaption></figure>

Simply click on 'Sketchfab' and choose 'Explore Sketchfab'.

<figure><img src="/files/5J6AoJqJ21TT7ry1jz5u" alt=""><figcaption><p>Explore Sketchfab</p></figcaption></figure>

You will be then redirected to 'Connect Sketchfab'

<figure><img src="/files/yro7SoYcHYiYEwaWAeWZ" alt=""><figcaption><p>Connect Sketchfab</p></figcaption></figure>

After clicking on 'Connect Sketchfab', a pop-up will appear like the one below. You can create your account using your email ID and password, or connect via social media logins, Google login, or your company SSO.

If you prefer, you can click on 'Create an account' to set up a new account.

<figure><img src="/files/RlcfGSCw4JIvbabbXEbq" alt=""><figcaption><p>Sketchfab Login</p></figcaption></figure>

After logging in, you will be redirected to the search page within the file manager.

To find the items or elements you're looking for, simply use the search bar to conduct a search.

<figure><img src="/files/InMOEe6871SEHwQUk7SX" alt=""><figcaption><p>Sketchfab - Searching for items</p></figcaption></figure>

After finding the desired item or element, select it and then click on 'Import'.

<figure><img src="/files/R9pcsgKWikzG9Sf7uAqC" alt=""><figcaption><p>Importing from Sketchfab</p></figcaption></figure>

The model you imported will be saved under `My Assets > My Imports > 3D Models` (or a similar location based on the type of element you imported).

<figure><img src="/files/iaZui509h0SKA6lB5H0o" alt=""><figcaption><p>My imports - 3D models</p></figcaption></figure>

## Using an imported Asset from your Asset Library

To add the downloaded item to your experience:

* Add a "3D Model" element
* Click on its file or "Upload / Choose File"
* In the File Manager that opens, navigate to `My Assets > My Imports > 3D Models` , then simply click on the imported model and then click 'select'

<figure><img src="/files/iTQwHVGQpBIb3efFxtNM" alt=""><figcaption><p>Selecting the downloaded item</p></figcaption></figure>


# Placement in 3D Space

## How do I place/move elements in my experience?

There are 3 ways to place/move elements in an experience, from viewport properties - [#drag](#drag "mention"), [#translate](#translate "mention") and [#rotate](#rotate "mention"). You can also do the same using [#transform-properties](#transform-properties "mention").

### Drag

By selecting the "Drag" option, you can use your mouse to move the item or element that you wish to relocate within your experience.

<figure><img src="/files/kYXKNDvkZ3ueEXJZvuRg" alt=""><figcaption><p>Placing items - Drag</p></figcaption></figure>

<figure><img src="/files/XjXVkrmymOmmelljQxfi" alt=""><figcaption><p>Drag</p></figcaption></figure>

### Translate

This allows you to move objects along the X, Y, and Z axes.

<figure><img src="/files/ZuX5XtrjpU3FgSyYExk9" alt=""><figcaption><p>Placing items - Translate</p></figcaption></figure>

It is possible to modify the position of your element along the X-Y, Y-Z, and X-Z axes.

<figure><img src="/files/53wDEnakFGfka9hy49qp" alt=""><figcaption><p>Translate</p></figcaption></figure>

### Rotate

"Rotating elements" refers to the process of changing the orientation or angle of virtual objects or elements within an experience.

This can be done using tools such as a "rotate" function from 'Viewport properties', which allows you to adjust the rotation of objects around the X, Y, and Z axes.

<figure><img src="/files/RkRrmurAxkaPCwmK8eNb" alt=""><figcaption><p>Rotate - Placing Items</p></figcaption></figure>

<figure><img src="/files/GM4FyhcxRn5eZqEueiSB" alt=""><figcaption><p>Rotate - Placing Items</p></figcaption></figure>

## Transform Properties

In addition to the three methods mentioned above, there is an additional option; Transform. This lets you to move or modify your elements and manipulate the axes as desired.

<figure><img src="/files/EyCksXHQlRhEdDtKIdmv" alt=""><figcaption><p>Transform</p></figcaption></figure>

## Axes

There are two types of axes available for the [translate ](#translate)and [rotate ](#rotate)transform modes.

### World Axis

World axes define the spatial orientation of your experience.&#x20;

They act as a reference point for positioning and manipulating objects within the environment.

The World axes consist of three perpendicular lines, labeled X, Y, and Z. \
X representing the horizontal axis, Y representing the vertical axis, and Z representing the depth axis.

<figure><img src="/files/cwNNwxIv3CV7TwPMbyep" alt=""><figcaption><p>Translate and Rotate - World Axes</p></figcaption></figure>

### Local Axis

Local axes define the spatial orientation of your experience.&#x20;

They act as a reference point for positioning and manipulating the object's position, rotation, and scale. Local axes consist of three perpendicular lines, labeled X, Y, and Z. These lines represent the object's internal coordinate system, which is defined by the object's orientation and pivot point.

<figure><img src="/files/koZEcCjER4M0QUNNPESf" alt=""><figcaption><p>Translate and Rotate - Local Axes</p></figcaption></figure>


# Project Settings

You can access your experience settings using the Settings (gear) icon on the top-bar.

<figure><img src="/files/zp6sB2XEp3hBVmTzaeg3" alt=""><figcaption><p>Settings</p></figcaption></figure>

Check the sub-pages to know more about each individual section.


# Preferences

To access your Preferences settings, you can click on the Settings icon located on the top-bar.

<figure><img src="/files/ZYWJjraO8KzpulVTtYeD" alt=""><figcaption><p>Where to find Preferences</p></figcaption></figure>

Let's explore each of the options on the **Preferences** settings page below.

## Initial Scene

The "Initial Scene" refers to the scene that starts first when a viewer launches your experience. This setting is particularly useful when you have multiple scenes in your experience and want to make sure that a specific scene is shown first.

<figure><img src="/files/1eEIGUR5DxbImJirdA66" alt=""><figcaption><p>Initial Scene</p></figcaption></figure>

## Field of View

This setting controls the field of view, which refers to the extent of the observable environment that is seen at any given moment in your experience.&#x20;

The default value is typically set to 75 degrees and in most cases, it is not necessary to change it.

<figure><img src="/files/GBeyTsp1sOGhnLEsNjUJ" alt=""><figcaption><p>Field of View</p></figcaption></figure>

## Graphics

If you are targeting low-end devices, you can set the Graphics to "**Adaptive**".

<figure><img src="/files/WS0ChfULLENZBVhqmKKh" alt=""><figcaption><p>Graphics</p></figcaption></figure>

## Viewer Camera

Learn more about the Viewer Camera Preference here: [Avatars](/metaverse/player/avatars#viewer-camera-preference)

## Automatically Track Rules

If this is checked, the rules applied to the experience will be tracked automatically through active analytics tracking.

<figure><img src="/files/opidrgGT41pvLBDf1vDY" alt=""><figcaption><p>Automatically Track Rules</p></figcaption></figure>

<figure><img src="/files/f7B6bDB3m1Bi15BUq6Jk" alt=""><figcaption><p>Active analytics in Rules</p></figcaption></figure>

## Before the Experience starts

### Show Navigation Instructions

If this is checked, the experience will show navigation instructions for 360 scenes, to the viewer.

<figure><img src="/files/TWvm7Qz8YaBbpcz6CBiV" alt=""><figcaption><p>Show Navigation Instructions</p></figcaption></figure>

<figure><img src="/files/L2nRKQsNqf4QiFhy6KXb" alt=""><figcaption><p>Navigation Instructions</p></figcaption></figure>

### Show Click to Start

If this is checked, "Start" button will appear for the viewer to enter the experience.

<figure><img src="/files/kkqqBp68iFUXUTpXCsfV" alt=""><figcaption><p>Show Click to Start</p></figcaption></figure>

<figure><img src="/files/YgJVWeTnGrzfhgV72am9" alt=""><figcaption><p>Click to Start button</p></figcaption></figure>

### Show Instructions for 3D scene

If this is checked, the experience will show navigation instructions for 3D scenes, to the viewer.

<figure><img src="/files/pn5bsSLxlsqcmD0aSugQ" alt=""><figcaption><p>Show Instructions for 3D scene</p></figcaption></figure>

### Experience Description

You can add a description that will appear below the "**Click to Start**" button for the viewer.

<figure><img src="/files/Rw5UH5HQgGTWSRzuFUxk" alt=""><figcaption><p>Experience Description</p></figcaption></figure>

<figure><img src="/files/AbLXA1hNYxbMNx87ksjh" alt=""><figcaption><p>Experience Description before click to start</p></figcaption></figure>

## Control Panel

### Allow VR Mode

This controls the visibility of the VR mode button, **if the hardware supports it**.

<figure><img src="/files/PeYwfSMPCxZMUu0DKXD5" alt=""><figcaption><p>Allow VR Mode</p></figcaption></figure>

<figure><img src="/files/AFFcRc3glYWrJGEWguaE" alt=""><figcaption><p>VR Mode</p></figcaption></figure>

### Allow Fullscreen mode

This controls the Fullscreen button.

<figure><img src="/files/yGiryjxVVgmhlNSfyMoI" alt=""><figcaption><p>Allow fullscreen button</p></figcaption></figure>

<figure><img src="/files/8mm5Ks7nL0AxVpNTTwUi" alt=""><figcaption><p>Fullscreen button</p></figcaption></figure>

### Show "Reset View" button

When the user clicks this button, the scene will realign to the initial view.

<figure><img src="/files/FIQF2YHAGZ8LIrj1MXLf" alt=""><figcaption><p>Show "Reset View" Button</p></figcaption></figure>

<figure><img src="/files/dKydo73dxxxPVFCg5wJw" alt=""><figcaption><p>Show "Reset View" button</p></figcaption></figure>

### Show Zoom controls

<figure><img src="/files/hb7IuPtwfjU8rdMWzogm" alt=""><figcaption><p>Show Zoom Controls (Desktop Only)</p></figcaption></figure>

<figure><img src="/files/tfqCbZSRszji5YPOdoUA" alt=""><figcaption><p>Zoom Controls</p></figcaption></figure>

### Show Volume Controls

Enabling this option will control the visibility of the volume button.

<figure><img src="/files/5TbLsrxe58iC45F5pGej" alt=""><figcaption><p>Show Volume Controls</p></figcaption></figure>

<figure><img src="/files/SqcuFP8MMTyAYuY46Nq0" alt=""><figcaption><p>Volume Controls</p></figcaption></figure>

## Advanced

### Enable Gyroscope

You can enable gyroscope view according to the viewer's position and perspective in real-time based on the movement of their device, creating an immersive and interactive experience.

<figure><img src="/files/Rs7fNOvtS9cNpFDKcADd" alt=""><figcaption><p>Gyroscope</p></figcaption></figure>

### Open only in supported browsers

Checking this option, controls whether a browser compatibility check will be performed.

<figure><img src="/files/UweL7RwaOF47pezsUQGy" alt=""><figcaption><p>Open Only in supported browsers</p></figcaption></figure>

When this option is enabled, and you use a browser that's not supported, you get the following blocker screen.

<figure><img src="/files/51jpI2PPW81O1xQDdwfQ" alt=""><figcaption><p>Browswer Blocker Screen</p></figcaption></figure>

### Enforce Landscape Mode on mobile devices

Checking this box will allow your experience to be viewed in landscape mode if it is designed to be viewed in that orientation.

<figure><img src="/files/emxrGoMDXY2pHZ5UXAWt" alt=""><figcaption><p>Enforce Landscape mode on mobile devices</p></figcaption></figure>

<figure><img src="/files/ydJOPZJPoc6Io1Jk2CIX" alt=""><figcaption><p>Enforce Landscape</p></figcaption></figure>


# Branding

Make the metaverse truly your own by utilizing the branding section.

You have several options to brand your experience.

### Remove Splash Screen

To remove the "Powered By GMetri" splash screen, use this option.

<figure><img src="https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mgll1jjQMRTVj7p6n7g%2Fuploads%2FSWfVflUynysqmCjwKtaV%2FRemove%20splash%20screen%201.png?alt=media&#x26;token=a4979447-f630-4693-9f13-eb46b2d71968" alt=""><figcaption><p>Remove Splash Screen</p></figcaption></figure>

<figure><img src="https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mgll1jjQMRTVj7p6n7g%2Fuploads%2Fmg01GKFs6AmopH9jR1Jj%2FFlash%20Screen.png?alt=media&#x26;token=2891f34d-5794-431b-8697-362a24cf5cdb" alt=""><figcaption><p>Flash Screen</p></figcaption></figure>

### Remove 'Powered by GMetri' watermark

A watermark appearing in the bottom left corner of your experience is displayed to the viewer. This watermark can be removed by checking the relevant checkbox.

<figure><img src="https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mgll1jjQMRTVj7p6n7g%2Fuploads%2F1lnVw0CjliGwJesoQSef%2FWatermark%201.png?alt=media&#x26;token=8df44b6f-b8f6-469c-8297-341f53ba87f1" alt=""><figcaption><p>Remove 'Powered by Gmetri' Watermark back end</p></figcaption></figure>

<figure><img src="https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mgll1jjQMRTVj7p6n7g%2Fuploads%2FHlCQwLE9huhKHuh9trfZ%2FWatermark.png?alt=media&#x26;token=f4489f61-e15d-475f-8a56-1f3358a91ea6" alt=""><figcaption><p>Watermark in GMetri Experiences</p></figcaption></figure>

### Custom Loader

Use the 'Custom Loader' option to update your organizational logo.

This logo gets used in the scene loader.&#x20;

Click "Choose file" to select the logo from the file manager if it's already uploaded.&#x20;

{% content-ref url="/pages/89Dj2jFYZ5UbZ0t6i2fd" %}
[Selecting a file](/metaverse/build/editor/file-manager/3rd-person-scenes)
{% endcontent-ref %}

<figure><img src="https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mgll1jjQMRTVj7p6n7g%2Fuploads%2FtfSFx3Np8YrNJRQNdl82%2FCustom%20branding%201.png?alt=media&#x26;token=d53f99b1-538a-456d-8b7d-f2bf0e03f205" alt=""><figcaption><p>Custom Branding Back End</p></figcaption></figure>

<figure><img src="https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mgll1jjQMRTVj7p6n7g%2Fuploads%2FZ8DYcVt0S4rmzpB0yZKa%2FCustome%20branding%201.png?alt=media&#x26;token=a51cf9bf-0493-4760-aa79-3063dea554d5" alt=""><figcaption><p>Custom Branding</p></figcaption></figure>

{% hint style="info" %}
If the Custom Loader option is checked but no custom loader file has been chosen, the workplace profile picture will get used. If no workspace profile picture is present, the loader logo will appear blank.
{% endhint %}

<figure><img src="https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mgll1jjQMRTVj7p6n7g%2Fuploads%2FSA6ussBHWR0KoHLh5027%2FProfile%20pic.png?alt=media&#x26;token=b92b1e89-37ba-4af0-ab32-4b65e33ae693" alt=""><figcaption><p>Workspace Profile Picture</p></figcaption></figure>

<figure><img src="https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mgll1jjQMRTVj7p6n7g%2Fuploads%2FDVQv7t7fvfQqd4SENkuD%2FNo%20profile%20pic.png?alt=media&#x26;token=5e529fc1-12fe-4fb7-8842-db734fd54136" alt=""><figcaption><p>No custom loader</p></figcaption></figure>

## Support Message

This message is displayed in case of errors and can be customized and updated as desired.

## Project Metadata

{% hint style="info" %}
Metadata refers to descriptive information about various materials such as documents, datasets, images, etc. It helps to increase the discoverability, accessibility, and usability of archived files by utilizing standardized terms and fields to describe the files.
{% endhint %}

To enhance the accessibility of your experience, you can create custom metadata. The title and description can be personalized to your specifications.

<figure><img src="https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mgll1jjQMRTVj7p6n7g%2Fuploads%2FQmFnbgwJkjWWVjTdWlX3%2FMetadata%20sample%201.png?alt=media&#x26;token=074d3395-23cc-4cf8-9490-c5a26df8cfe8" alt=""><figcaption><p>Metadata</p></figcaption></figure>

You can select a thumbnail by clicking "Choose file," which will be displayed when you share your deployment with a viewer.

<figure><img src="https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mgll1jjQMRTVj7p6n7g%2Fuploads%2FC0Tz2vyuGAXoYIW6B44K%2FProject%20Metadata%202.png?alt=media&#x26;token=6c37c41d-a317-4e1b-8b6b-885b5b2f3a3a" alt=""><figcaption><p>Front End Metadata</p></figcaption></figure>

Tags aid in search engine optimization. Adding multiple tags can increase the visibility of your experience.

<figure><img src="https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mgll1jjQMRTVj7p6n7g%2Fuploads%2F5W01KmcAQZMWI6ih8ZvW%2FTags.png?alt=media&#x26;token=ff2d9e64-e6c0-4507-8371-2fc8ccffe2f5" alt=""><figcaption><p>Tags</p></figcaption></figure>


# Collaborators

{% hint style="danger" %}
Make sure the person you are trying to add as a collaborator is already a [team member in your workspace](/metaverse/build/portal/team-members#adding-team-members).
{% endhint %}

Multiple editors can edit an experience at the same time.

To edit and experience, you need to be either an admin of the workspace, OR be added as a collaborator of that experience.

Use this tab to add new collaborators to the experience.

![Collaborators](https://s.vrgmetri.com/image/q_90/gb-web/portal-docs/assets/img/screenshots/z5/experience_collaborator_settings.JPG#boxShadow/)

* Click on `Add Collaborators` button under Collaborators section.
* Enter email address of a registered user who you want to collaborate with.

Members who are invited to collaborate on an experience will receive an email invitation. Once they accept the invitation, they will be allowed to access and edit the experience.

{% hint style="info" %}

* Any collaborator can invite more members to collaborate on the experience.
* Creator of the experience is **not** the owner of the experience and all collaborators including the creator have equal access to the experience.
* The **admins** of an organization are by default allowed to access and **edit** all the experiences of their organization.
* Once members have been added as collaborators, they will have access to all features including **editing experiences**, **creating/updating/deleting deployments**, and even **deleting the experience**. **Add your collaborators carefully.**
  {% endhint %}


# Menu

![Menu](https://s.vrgmetri.com/image/q_90/gb-web/portal-docs/assets/img/screenshots/z5/experience_menu_settings.JPG#boxShadow/)

This **Menu** tab is used to control the Menu used to toggle between Scenes.

The menu looks like this:

![Viewer Menu](https://s.vrgmetri.com/image/q_90/gb-web/portal-docs/assets/img/screenshots/viewer_menu_v5.jpg#boxShadow/)

It appears both in the editor and in the viewer. On the menu tab, you can control if you want this menu enabled or disabled. You can also control if you want any scene to be shown in the menu or not individually.


# Variables in Settings

Use the Settings > Variables page to add/remove Custom Variables, [Global Variables](/metaverse/build/portal/global-variables) and Autogenerated Variables.

{% hint style="info" %}
Global variables have to be first defined in [workspace settings](/metaverse/build/portal/global-variables) before you can add them to your experience from the Settings > Variables page
{% endhint %}

<figure><img src="https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mgll1jjQMRTVj7p6n7g%2Fuploads%2FPt1KiFNfL8mUykdmjCeD%2Fimage.png?alt=media&#x26;token=89f1d96e-5982-48f7-b6df-805f3f8c9e16" alt=""><figcaption><p>Settings > Variables page</p></figcaption></figure>

Learn more about Variables here:

{% content-ref url="/pages/4FdURXtqhp12wn0WgUZi" %}
[Variables](/metaverse/build/variables)
{% endcontent-ref %}


# Lead Generation

In case you want to collect any information from the viewer in your Metaverse. You can use this section to show a form to collect data from them.

This can be used for various purposes including training, registration, webinars, events etc. It allows viewers to enter a few details before entering your experience.

This can be set up from the “**Settings > Lead Generation**” page as shown below

<figure><img src="/files/9lU0i4l6b1zU4LAH2iE8" alt=""><figcaption><p>Setting up Lead Generation form</p></figcaption></figure>

The viewer is presented with a form like this when opening the deployment:

<figure><img src="/files/vqa1QpItRz4ZJfw2EHUb" alt=""><figcaption><p>Lead Generation form for the viewer</p></figcaption></figure>

### More Options

* Clicking on "Required" ensure that that question isn't skippable
* Clicking on Viewer Identifiers is useful if you want to store this response in the [v\_identifier\_var](/metaverse/build/variables#v_identifier_var) variable.


# Tour Mode

Use the tour mode to start a guided tour which starts after a few seconds of inactivity. The guided tour slowly rotates the scenes that the viewer is in and then transitions through all the scenes in the list below, one by one.

After enabling tour mode, you may select the scenes and the order in which to show them.

![Tour Mode](https://s.vrgmetri.com/image/q_90/gb-web/portal-docs/assets/img/screenshots/z5/expereince_tour_settings.JPG#boxShadow/)

Here's an example tour mode:

{% embed url="<https://xyecjf.gmetri.com/tour_mode_demo>" %}
Tour Mode Demo
{% endembed %}


# Advanced

![Advanced](https://s.vrgmetri.com/image/q_90/gb-web/portal-docs/assets/img/screenshots/z5/experience_advanced_settings.JPG#boxShadow/)

When working in the editor, some experiences require that custom logic be run when certain events occur, since this logic depends on specific use cases, the editor has a script property where a custom javascript can be entered. This script will be executed during the run time (i.e., in the view mode)

Here's an example that uses custom javascript:

{% content-ref url="/pages/kRdiXky3wjGF3bhyBGxP" %}
[Adding Background Music & Persistent Logo](/guidelines-compatibility/guidelines/workflows/adding-background-music-and-persistent-logo)
{% endcontent-ref %}


# E-Commerce in Settings

{% content-ref url="/pages/wRZfhlxDznzpK6IYqFtz" %}
[E-Commerce with GMetri](/metaverse/integrations/e-commerce-with-gmetri)
{% endcontent-ref %}


# Preview

While building an experience you can keep previewing it to check how viewers will experience it. Opening a preview always directly opens the scene that you were on in the editor.

<figure><img src="/files/6tTytweEWUY18qCh8cck" alt=""><figcaption><p>Preview</p></figcaption></figure>

<figure><img src="/files/55qqo2iliFhsvmH6rWdo" alt=""><figcaption><p>Preview</p></figcaption></figure>

{% hint style="info" %}
Feel free to preview your experience as many times as you want. Previews don't count towards your monthly view limits.
{% endhint %}

Note that these preview links are meant for previewing the experience only. The preview links fast - you should keep opening new preview tabs by every time you want to preview.

*Also read:*[/pages/qeJIoAGgJ3k4tWJhGuol#whenever-i-share-my-spaces-after-a-while-the-link-says-unauthorised-401.-do-links-expire-after-a-cer](https://docs.gmetri.com/metaverse/build/editor/pages/qeJIoAGgJ3k4tWJhGuol#whenever-i-share-my-spaces-after-a-while-the-link-says-unauthorised-401.-do-links-expire-after-a-cer "mention")


# Headset Testing - WebXR Emulator

Testing experiences designed for Headsets in Desktop Browsers using WebXR Emulator

During the creation process of a headset-based experience, testing the workings in a desktop-based environment is often easier. The design principles for headset experience and desktop experiences differ at times due to certain limitations on headsets.&#x20;

There is an easy way to test headset-based experiences on desktop devices.&#x20;

> This is ONLY for testing purposes. Experiences should be tested on headset before final deployment.

## There are 2 ways to setup the development environment

Follow the steps listed here <https://github.com/felixtrz/WebXR-emulator-extension#how-to-install-the-newest-version>

**OR**

Follow the steps listed below:

1. Download the package file from here: <https://s.vrgmetri.com/gb-web/dev/WebXR-emulator-extension.crx>
2. Navigate to chrome://extensions on your browser
3. Enable `Developer Mode` from the top right on your screen
4. Drag-n-Drop the downloaded file on this page
5. In the prompt that appears, click `Add extension` button

   <figure><img src="/files/7jUtyzDBW1ghBB9SWirW" alt=""><figcaption></figcaption></figure>

## How to use WebXR emulator Extension

1. Open developer tools on chrome using shortcut `CTRL/CMD + I`
2. Select `WebXR` option from the tabs
3. Select one of the devices from the dropdown

   <figure><img src="/files/ohJ3JtSb1szF3uNAv1Hp" alt=""><figcaption></figcaption></figure>
4. Click on the Enter VR button from the hamburger menu (on top-right) from the GMetriXR experience and enter VR mode on your desktop&#x20;

   <figure><img src="/files/ZSsvOxiKhNKjG6Z5hMSc" alt=""><figcaption></figcaption></figure>


# Viewport Properties

Viewport Properties is an [editor](/metaverse/build/editor) panel that facilitates the movement and placement of items within your experience.

<figure><img src="/files/sqU5xbA4jNrp96mnCANz" alt=""><figcaption><p>Viewport properties</p></figcaption></figure>

## Camera Mode

<figure><img src="/files/HF8pq6i6ZF83kKx9knv6" alt=""><figcaption></figcaption></figure>

### First Person Camera Mode

<figure><img src="/files/6F3mGlu43dXj42CA1tcj" alt=""><figcaption><p>First person camera mode</p></figcaption></figure>

First person mode allows you move along the plane at a given height using the WASD or the arrow keys. You can control this height from the Top Bar.

### Fly Camera Mode

<figure><img src="/files/BlYMimtDhFD00m2lr3yo" alt=""><figcaption><p>Fly Camera Mode</p></figcaption></figure>

In Fly Mode, you can:

* Use left click and drag to orbit around a point
* Use scroll bar to move forward and backward
* Use right click and drag to pan

## Transform Mode

The transform how you move elements in the editor.

There are 3 transform modes:

* Drag: Moves the element across a spherical plane with the camera as the center
* Translate: Shows the Transform arrows that allows you to move the element across `x`, `y` or `z` axes or `xy`, `yz` or `zx` planes.
* Rotate: Shows the Rotation controls that allow you to rotate the element across `x`, `y` or `z` axes.

{% hint style="info" %}
The axes in question above can be relative either to the World or the local element. Control this by using the Axis setting below.
{% endhint %}

You can refer to the below article to understand how this mode works in a 3D space.

{% content-ref url="/pages/AfIppqoDeneuruZzMj1Z" %}
[Placement in 3D Space](/metaverse/build/editor/placement-in-3d-space)
{% endcontent-ref %}

<figure><img src="/files/6MStw0IiXeob3s2vQg0f" alt=""><figcaption><p>Transform Mode</p></figcaption></figure>

## Axis

The translate and rotate controls can be relative to one of two available axes - World or Local.

<figure><img src="/files/MGMu8YNd42DRcFJHxvw5" alt=""><figcaption><p>Axis</p></figcaption></figure>

## Scene Bound Visibility

You can change the visibility of the scene boundary using this setting.

You can refer to scene bounds in the below article to understand how they work

{% content-ref url="/pages/3WcLIPQc5o8vlCYL8hUf" %}
[Colliders](/metaverse/build/scenes/3d-scene/colliders)
{% endcontent-ref %}

<figure><img src="/files/ioaQBtxZdxvlrfgrIZ2H" alt=""><figcaption><p>Scene Bound visibility</p></figcaption></figure>

## Bounding Box

This is 3D cuboid frame that encloses an element within the experience. It is used to represent the dimensions and position of an item.

Shown below are examples with and without bounding box visibility.

<figure><img src="/files/Xvn7HHefmFTLJuO1YZtR" alt=""><figcaption><p>Bounding box</p></figcaption></figure>


# Editor Keyboard Shortcuts

Keyboard Shortcuts for the GMetri Editor

| Action                      | Windows/Linux Shortcut | MacOS Shortcut        |
| --------------------------- | ---------------------- | --------------------- |
| Undo                        | `ctrl` + `z`           | `cmd` + `z`           |
| Redo                        | `ctrl` + `shift` + `z` | `cmd` + `shift` + `z` |
| Switch Properties/Structure | `` ` `` (backtick)     | `` ` `` (backtick)    |
| Fly Controls                | `alt` + `q`            | `option` + `q`        |
| Open Rules Panel            | `ctrl` + `space`       | `cmd` + `space`       |
| Delete Element / Scene      | `ctrl` + del           | `cmd` + `delete`      |
| Hide Element                | `ctrl` + `h`           | `cmd` + `h`           |
| Duplicate Element / Scene   | `ctrl` + `d`           | `cmd` + `d`           |
| Cycle Through Controls      | `ctrl` + `q`           | `cmd` + `q`           |
| Zoom In                     | `ctrl` + `]`           | `cmd` + `]`           |
| Zoom Out                    | `ctrl` + `[`           | `cmd` + `[`           |
| Zoom Reset                  | `ctrl` + `0`           | `cmd` + `0`           |

## 3D Scene Controls in the Editor

The following keyboard shortcuts in the editor only if you are in a 3D Scene and "Camera Mode" is "First Person"

| Action                | Shortcut                         |
| --------------------- | -------------------------------- |
| Move                  | ←, ↑, ↓, → OR `w`, `a`, `s`, `d` |
| Camera Height Up/Down | `q`, `e`                         |

## Also Check

{% content-ref url="/pages/vBsGQC922VCj6ysvo0mm" %}
[Viewer Keyboard Shortcuts](/metaverse/player/viewer-keyboard-shortcuts)
{% endcontent-ref %}


# Scenes

A *Scene* in GMetri is like a slide in a presentation or a chapter of a book. Scenes break-up an experience into many parts.

{% hint style="info" %}
Use Scenes to optimize load time of an experience. Only one scene is loaded at a time while running the experience
{% endhint %}

* Add a Scene by using the + icon in the top bar

<figure><img src="/files/CZK4LQPaaK6Do7Lbq5Ve" alt=""><figcaption><p>Add a scene into your experience</p></figcaption></figure>

## Types of Scenes

* [3D Scene](/metaverse/build/scenes/3d-scene)
* [360 Scene](/metaverse/build/scenes/360-scene)
* [Orbit Scene](/metaverse/build/scenes/orbit-scene)

{% embed url="<https://www.youtube.com/watch?v=MwTjLglQe-I>" %}
Types of Scenes in GMetri
{% endembed %}

### Also Read

[Publishing FAQs](/metaverse/publishing/publishing-faqs#how-can-i-send-someone-directly-to-a-particular-scene-when-they-click-the-experience-link)


# 3D Scene

3D Scenes allow viewers/players to roam freely within a space using **WASD** and **Arrow keys \[← → ↑ ↓]**. This is similar to walking, visiting and interacting with different parts of a room. You can also jump using the **SPACE** key on desktop devices.

{% embed url="<https://rxhhkr.gmetri.com/eventsMetaverse>" %}
Click on Start to expereince the 3D Scene
{% endembed %}

## Properties of a 3D scene

The properties panel in a 3D scene provides multiple options to adjust an element or an item in an experience.

<figure><img src="/files/MyIwUgMNeMbnaZVrRkQD" alt=""><figcaption><p>3D Scene Properties</p></figcaption></figure>

### View

* **Yaw** - It refers to the rotation of a virtual camera around its vertical axis. It is typically used to control the left and right movement of the camera, allowing the user to look around the experience
* **Reset Rotation** - By selecting this option, the user can reset the camera to its default position if the scene in an experience is set at a specific angle. This feature is especially useful in experiences with multiple scenes, as it allows the user to easily reset the camera's position in each scene.
* **Allow Zooming** - This will allow your viewers to control the zoom function for your experience.

<figure><img src="/files/doWAhLnyuBcLd7k4GXEh" alt=""><figcaption><p>Zoom</p></figcaption></figure>

* **Enable Collisions -** When Enable Collisions is turned on, virtual objects can collide with each other, resulting in realistic responses such as bouncing or sliding off each other.

* **Viewer Height -** This refers to the height from which a viewer will observe the experience. \
  Viewer height feature can be accessed on desktop and laptop devices, but unavailable for VR.

* **Spawn Zone** -  It is a starting point for new users entering an experience. It is a designated area within an experience where avatars or objects are initially placed when they are created.\
  \
  From the drop-down menu, you can select a zone of your choice and designate it as a Spawn zone.

* **Bounds -** From this section, you can make modifications or adjustments to the bounds of the scene.

### Advanced

* **Environment Map -** You can select different types of environment maps from the drop down.&#x20;

<figure><img src="/files/SVmyojOcK5LQtl37IrkS" alt=""><figcaption><p>Environment Map</p></figcaption></figure>

* **Selective Bloom -** Selective bloom is a visual effect in an experience that highlights certain areas of the virtual environment with a glowing or blooming effect.

## How can I add a new 3D Scene?​ <a href="#id-3d-scene-setup-with-collisions" id="id-3d-scene-setup-with-collisions"></a>

From the editor, add a new 3D scene by going to `Add Element > Scene > 3D Scene`. This also inserts a few default elements that are helpful in scene setup.

* **Pano** - A background for the entire scene
* **Environment** - A 3D model that will serve as the space for our scene. This can be replaced by selecting another 3D model from the file manager and adjusting positioning and scale to match life-size scale
* **Zone** - A spawn zone from where all the player will enter this scene. This can be moved around the scene to enable players entering the room from different locations.
* **Lights** - A default light setup to make the scene look good.

  ![](https://s.vrgmetri.com/image/q_90/gb-web/portal-docs/assets/img/screenshots/3D_scene/3D_scene_default_elements.png#boxShadow)

To add a new collider, add a new **Collider Volume** element.

* Align the element with one of the walls in the middle and adjust the scale.

From the Scene Properties, adjust the \`Scene Bounds\` to confine player movement within a space. This is automatically configured for the default environment that comes with every new 3D scene.&#x20;

## Concepts

### Avatars

Your digital representation in the Metaverse is called an Avatar. [Avatar System](/metaverse/build/scenes/3d-scene/avatar-system)

### **Colliders**

#### How do we prevent viewers from walking into walls/objects?

You can control the spaces where a user walks using colliders. [#colliders](#colliders "mention")

### **Zones**

Zones allow you to define interactive areas in a scene. [#zones](#zones "mention")

### Lights

Control the illumination of your Scene using lights. [#lights](#lights "mention")

### **Multiplayer Mode**

To collaborate with other people in your metaverse, you can use multiplayer mode. [Multiplayer](/metaverse/multiplayer)

### Camera Modes

Control how you move in the editor. [Viewport Properties](/metaverse/build/editor/viewport_properties#camera-mode)


# Avatar System

Use Avatars and Characters to place people/bots and add interactivity to your Metaverse.

#### Also see:

{% content-ref url="/pages/JZRKcmfxxay74h40vTjd" %}
[Character](/metaverse/build/elements/character)
{% endcontent-ref %}

**Avatars** are the digital representation of actual people (humans... for now). When you enter the metaverse, you enter as your Avatar. You also see other people as their avatars.

{% hint style="info" %}
Behind every Avatar is an actual person
{% endhint %}

## How do I select an Avatar System?

You can activate Avatars within your deployment settings and choose the most appropriate option based on your preferences.&#x20;

During the preview of the experience prior to going live, you can incorporate Avatars. You can choose from a variety of Avatar systems based on your interests.

<figure><img src="/files/vwEEVd8Xpa8bq1EAlj7E" alt=""><figcaption><p>Settings - Avatars</p></figcaption></figure>

## Choose your Avatar System

You can choose from several Avatar systems to suit your needs based on the type of experience you are building.

### **Basic + Ready Player Me**&#x20;

This system offers two choices: Basic and Ready Player Me. The Basic Avatar is the default cone Avatar included in Gmetri. Ready Player Me is a third-party platform that enables you to create a personalized Avatar by either uploading a picture or selecting one from the Gmetri Assets.

Check the corresponding viewer section here:

* [Avatars](/metaverse/player/avatars#ready-player-me)
* [Avatars](/metaverse/player/avatars#gmetri-avatars)

### **GMetri Avatars**

This system only provides basic cone-shaped Avatars that are pre-installed in Gmetri.

### **Basic + Custom**&#x20;

This system offers two options: Basic and Custom. By selecting the Custom Avatars option, you can upload a custom Avatar from your computer. Click on 'Add Avatar', select the file, and you will be directed to the file manager where you can upload your custom Avatar.

You can add up to 6 custom Avatars in any experience.

<figure><img src="/files/WmsIneH9AhNQSIovn6bl" alt=""><figcaption><p>Basic + Custom Avatar System</p></figcaption></figure>

{% hint style="info" %}
Make sure that all the custom Avatars you plan to upload are 3D models.
{% endhint %}

### **None**&#x20;

This system does not include any Avatars.

## Viewer Camera Preference

You can choose between two camera preferences, first person or third person, when setting up a 3D scene. You can create an Avatar and display your digital representation to others.

With the first person mode, you can view the experience from the editor's perspective. On the other hand, the third person mode lets you see yourself within the Avatar that you have constructed.

<figure><img src="/files/BX6riBheAuPUPgz1M5IA" alt=""><figcaption><p>Setting up Viewer camera</p></figcaption></figure>

You can check how a viewer perceives these modes here:

{% content-ref url="/pages/IQqla6v4di1TteBbqiMx" %}
[First/Third Person](/metaverse/player/first-third-person)
{% endcontent-ref %}


# Colliders

Colliders are structures that prevent viewers from walking through a space.

There are three types of colliders - Scene Bounds, Collider Volume, Collider Mesh

{% hint style="info" %}
For colliders to work, ensure that "**Enable Collisions**" is enabled in Scene Properties
{% endhint %}

## Scene Bounds

Scene Bound is the boundary of your scene. Every place that you want the viewer to visit should be within the Scene Bounds.

In the editor, scene bounds are visible as a grid and can be toggled from the **Viewport Properties**. Scene bounds are only visible in the editor - you can't see them in the deployed link.

<figure><img src="/files/mZtsXCx5h7UoPoyfyOXX" alt=""><figcaption><p>Scene Bounds</p></figcaption></figure>

### How can I change Scene Bounds?

To modify the Scene bounds of your scene, go to the 'Structure' option and select 'Scene'. Then, you can adjust the X, Y, and Z axis ranges to make the necessary changes.

<figure><img src="https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mgll1jjQMRTVj7p6n7g%2Fuploads%2FPKAyZgs1RBG1TnVzuPgz%2Fimage.png?alt=media&#x26;token=471122a0-ce19-4c9f-96ec-3df93983bd4a" alt=""><figcaption><p>How to change the scene bounds in your experience</p></figcaption></figure>

{% hint style="info" %}
If you want to remove Scene Bounds - set its size to 0
{% endhint %}

Here's an example experience for Scene Bound. The scene bounds prevent you from going near the windows.

{% embed url="<https://rnghud.gmetri.com/Scenebounds>" %}
Scene bounds - Sample experience
{% endembed %}

## Collider Volume <a href="#collider-box-element" id="collider-box-element"></a>

A Collider Volume is an invisible box/sphere/cone/volume that objects will rest on top of. Without colliders, viewers will fall through floors and go through walls and benches. The position, shape and dimensions of this volume can be adjusted from the properties panel.

<figure><img src="https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mgll1jjQMRTVj7p6n7g%2Fuploads%2F0FecCaIzBtp1ZFYvzQ02%2Fimage.png?alt=media&#x26;token=4e07abfe-2cbb-4605-9aa1-5c7fb1226e96" alt=""><figcaption><p>Collider box element</p></figcaption></figure>

In view, the collider box elements are represented as invisible cubes with which the players will collide and not walk through.

## Collider Mesh

Enhance your experience by incorporating a 3D object that has collision capabilities. You can either upload your own customized 3D model or choose one from our pre-installed libraries.

<figure><img src="https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mgll1jjQMRTVj7p6n7g%2Fuploads%2Fua2T8roCYYZH6c56cEw4%2Fimage.png?alt=media&#x26;token=aeb5b02d-469d-4e7f-a27f-2ebcccdc337b" alt=""><figcaption><p>Collider Mesh</p></figcaption></figure>

## Collider Example

Here's an example of how a collider works on an experience:

{% embed url="<https://rnghud.gmetri.com/colliders>" %}
Colliders - Sample experience
{% endembed %}

## Video Tutorial for Colliders

{% embed url="<https://www.youtube.com/watch?v=EDsC1Z2hRj4>" %}
Collider Tutorial
{% endembed %}


# Zones

Zones are *interactive areas* that can be used for a variety of purposes.

<figure><img src="https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mgll1jjQMRTVj7p6n7g%2Fuploads%2FxYPPx0LmNhYUXr5sfdOM%2Fimage.png?alt=media&#x26;token=9168ca19-aa6a-4fdf-a8d0-9fd0e4b3c9e7" alt=""><figcaption><p>Zones</p></figcaption></figure>

When you add a new 3D Scene, there's always a default Zone that gets added - which is the spawn zone. A Spawn Zone controls where viewers will spawn when they enter the 3D Scene.

### How can I set the spawn zone?

To include a 'Zone' in your experience, navigate to the 3D elements section and click the '+' icon. Then, select the 'Zone' element and add it to your experience.

<figure><img src="https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mgll1jjQMRTVj7p6n7g%2Fuploads%2FHJAuTQJHhtti2kmQ58L1%2Fimage.png?alt=media&#x26;token=747b1e42-8351-4806-91cc-74d76c23468f" alt=""><figcaption><p>Adding Zone to your experience</p></figcaption></figure>

To manage the 'Spawn Zone', access the properties panel by selecting the appropriate scene from the right panel. From there, navigate to the 'Spawn Zone' section and choose the desired zone to set as the Spawn zone.

<figure><img src="https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mgll1jjQMRTVj7p6n7g%2Fuploads%2FlvpELiq2oCQ5MOlk4znB%2Fimage.png?alt=media&#x26;token=a5e421b5-6c1e-496c-b79e-d4d5ab6fb903" alt=""><figcaption><p>Spawn Zone adjustment</p></figcaption></figure>

### How can I detect when a viewer enters a zone?

You can add a "Then Rule" to detect when the viewer enters a zone.

<figure><img src="https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mgll1jjQMRTVj7p6n7g%2Fuploads%2F8DaNgHZKWvd43kXyC9QI%2Fimage.png?alt=media&#x26;token=10ff3d30-8f1e-43a0-8b87-69508d971332" alt=""><figcaption><p>Rules to detect viewer entering zones</p></figcaption></figure>

### How can I teleport to a zone?

By incorporating rules, you have the ability to teleport your viewer to a different zone or scene.

<figure><img src="https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mgll1jjQMRTVj7p6n7g%2Fuploads%2FrlpCuylamNGKBxqdVLFV%2Fimage.png?alt=media&#x26;token=47fd71dc-8083-4a0e-a312-e586f44c6d79" alt=""><figcaption><p>Teleport a viewer - Rule</p></figcaption></figure>

## Also Read

{% content-ref url="/pages/mJPqUjlr5B6jUW6h6LBY" %}
[Rules](/metaverse/build/rules)
{% endcontent-ref %}


# Lights

When you add a new 3D Scene, there's a default light setup already present for you.

There are 3 types of lights in GMetri - Ambient, Point and Directional.

## Ambient Light

Ambient Light is a lighting technique used in an experience to provide an overall level of illumination to a scene or environment. It's a type of indirect lighting that simulates the light that is reflected or scattered from surfaces in a scene, such as walls or objects.

Ambient Light helps to create a more realistic and immersive environment, and it can be adjusted to different levels to change the mood and tone of the scene. It's also useful for providing a base level of illumination when other lighting sources, such as directional or point lights, are not sufficient.

In any experience, ambient light can be set and adjusted using tools and controls provided by the platform or development environment.

## Point Light

Point lights are often used in combination with other lighting techniques, such as ambient light or directional light, to create a more complex and realistic lighting setup. They can be placed in specific locations within a scene or environment to highlight or illuminate certain objects or areas.

In an experience, point lights can be adjusted and customized using tools and controls provided by the platform or development environment. The intensity, color, and range of the light can all be adjusted to achieve the desired effect. Additionally, multiple point lights can be used within a scene to create more complex lighting setups and add depth and dimensionality to the environment.

## Directional Light

Directional light is characterized by its constant intensity and parallel light rays that do not diminish with distance. It's particularly useful for creating dynamic and realistic outdoor environments, such as landscapes or cityscapes.

In an experience, directional light can be customized and adjusted using tools and controls provided by the platform or development environment. The color, intensity, and direction of the light can all be modified to achieve the desired effect. Additionally, multiple directional lights can be used within a scene to create more complex lighting setups and add depth and dimensionality to the environment.

The right panel allows you to manage the lighting in your experience. You can choose the lighting type, color, intensity, and target object from this panel.

<figure><img src="https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mgll1jjQMRTVj7p6n7g%2Fuploads%2FAlqsTMutB4pZqD5U0afh%2Fimage.png?alt=media&#x26;token=eaec99d7-8c7e-4aa6-8b64-3e06c9a5ba93" alt=""><figcaption><p>Light adjustment</p></figcaption></figure>

You can add a light to your experience by adding an element and choosing the 'Light' option under 3D elements.

<figure><img src="https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mgll1jjQMRTVj7p6n7g%2Fuploads%2FI0RMU032dp5C2iZ3lLZK%2Fimage.png?alt=media&#x26;token=02734a81-3797-4ba4-a821-a41bd29fca9b" alt=""><figcaption><p>Adding light into your experience.</p></figcaption></figure>

Here's an example of how the point light, directional light works. Walk towards the element Sphere and Cube to read through what they do.

An experience will be set with a default set of lighting which will include ambient light.

{% embed url="<https://rnghud.gmetri.com/lights>" %}
Lights - Sample experience
{% endembed %}


# 360 Scene

## Properties of a 360 Scene

The properties panel in a 360 scene provides multiple options to adjust an element or an item in an experience.

<figure><img src="/files/j53V8YLSf3VprHObDQGy" alt=""><figcaption><p>360 Scene properties</p></figcaption></figure>

### View

The functionalities of Yaw, Reset Rotation, and Allow Zooming in any experience are similar to those in a 3D scene.

* **Gyro Lock** - Enabling this option will lock the gyroscope view of the experience. If the option is not checked, the adjustments to the gyroscope view can be made by adjusting the yaw and pitch ranges.

### Advanced

Environment Map and Selective Bloom in any experience are similar to those in a 3D scene.

## How do I add a 360 panorama into my experience?

### Step 1: Add a 360 Scene

You can add a 360 scene by clicking on the '**+**' icon in the left bar and selecting '**360 Scene'.** <br>

<figure><img src="/files/qjGyyrz0PlVDHzK5ycYM" alt=""><figcaption><p>Add a 360 scene into your experience</p></figcaption></figure>

### Step 2: Go to properties of Pano Element and select Upload/Choose File

<figure><img src="/files/muXThmc3WkHLS8v4QGtn" alt=""><figcaption><p>Properties of Pano Element and select Upload/Choose File</p></figcaption></figure>

{% content-ref url="/pages/89Dj2jFYZ5UbZ0t6i2fd" %}
[Selecting a file](/metaverse/build/editor/file-manager/3rd-person-scenes)
{% endcontent-ref %}

### Example 360 Scene

{% embed url="<https://demo.gmetri.com/360_scene>" %}
360 Scene Example
{% endembed %}


# Orbit Scene

## Properties of an Orbit Scene

<figure><img src="/files/3dqW0BghLl0XvzhjlNtm" alt=""><figcaption><p>Orbit Scene Properties</p></figcaption></figure>

### View

You can select the target element from the drop down and choose the element that should be the target.

By considering the target element as the target, the environment can be rotated in accordance with it.

<figure><img src="/files/0R8UvH2LFVhF8EXnJBiK" alt=""><figcaption><p>Target Element.</p></figcaption></figure>

### Advanced

Environment Map and Selective Bloom in any experience are similar to those in a 3D scene.

## How to add an Orbit scene into your experience?

To add an orbit scene, click on + in the top bar and select Orbit scene

You then have an Orbit scene added to your experience.

## Setting up an orbit scene around a 3D object

Once you have added an Orbit scene, you can add a 3D object by clicking "**+**" in the top bar and choosing "**3D Model**".

<figure><img src="/files/6kzDoa5EgRTfMpM263zR" alt=""><figcaption><p>Choosing a 3D object</p></figcaption></figure>

### Example Orbit Scene

{% embed url="<https://demo.gmetri.com/orbit_scene>" %}
Orbit Scene Example
{% endembed %}


# Elements

Elements are the basic blocks you use to build an experience. Use the Add (+) icon to add elements.&#x20;

<figure><img src="/files/TairXOb8kbSAfV0wvdKq" alt=""><figcaption><p>Add Panel</p></figcaption></figure>

You can check all elements added to your scene in the Structure Panel

<figure><img src="/files/Jf0A6najwDTm2vA4kzDd" alt=""><figcaption><p>Elements in the Structure Panel</p></figcaption></figure>

{% hint style="success" %}
The unit used in GMetri for 3D placement is **meters**.

The unit used in GMetri for rotations is **degrees**.
{% endhint %}

## Universal Elements

Universal Elements work in VR Mode also

### Panorama

* Image 360
* Video 360

### Standard

* [Image](/metaverse/build/elements/image)
* [Video](/metaverse/build/elements/video)
* Text
* [GIF](/metaverse/build/elements/gif)
* Emoji
* Hotspot

### Audio

Also, check [Audio Optimizations](/guidelines-compatibility/guidelines/experience-optimizations/audio-optimizations).

* [Audio](#audio)
* [Text-to-Speech](/metaverse/build/elements/texttospeech)

### Polygons And Shapes

* 3D Model
* Polygon
* Cube
* Sphere
* Cone
* Torus
* Cylinder
* [Light](/metaverse/build/scenes/3d-scene/lights)
* [Zone](/metaverse/build/scenes/3d-scene/zones)
* [Collider Volume](/metaverse/build/scenes/3d-scene/colliders)
* [Collider Mesh](/metaverse/build/scenes/3d-scene/colliders)

## HTML only Elements

{% hint style="warning" %}
Beyond this point, the elements you add to the scene don't automatically show up in the editor. They only show in the Structure Panel.&#x20;

For most such elements in order to use them, you need to add a rule that says&#x20;

`when <something happens> then <Element> should appear`
{% endhint %}

{% hint style="danger" %}
All elements below (except Score and Timer) are elements that work only in the browser mode and **Not in VR Mode**. If you are designing for VR, restrict yourself to the elements above (along with Score and Timer).
{% endhint %}

* [Screenshare](/metaverse/multiplayer/screenshare)
* [Character](/metaverse/build/elements/character)

### Spatial

* AR
* QR Browser
* QR Matcher

### Gamification

* Score
* [Timer](/metaverse/build/elements/timer)
* Quiz&#x20;

### User Input

* Capture Input
* Media Upload

### User Interface

* [Actionbar](/metaverse/build/elements/actionbar)
* Pop-up
* Product Card
* Story

### Connect

* Embed HTML. (Check [EmbedHTML Snippets](/guidelines-compatibility/guidelines/workflows/embedhtml-snippets))
* Share
* [SCORM](/metaverse/integrations/scorm)


# Image

## Can I add images to my experience?

### Step 1: Add an Image

You can add an image by clicking on the '**+**' icon in the top bar.

<figure><img src="/files/l4uCf0rtNadzNAZaKWI5" alt=""><figcaption><p>Adding an Image</p></figcaption></figure>

### Step 2: Upload / Choose file

You can choose from the inventory of image or upload one from your computer.

Read below to know how to select a file to upload an image/ video.

{% content-ref url="/pages/89Dj2jFYZ5UbZ0t6i2fd" %}
[Selecting a file](/metaverse/build/editor/file-manager/3rd-person-scenes)
{% endcontent-ref %}

### Step 3: Adjust the Image element

The right panel offers various options for making adjustments. You can modify the image's width, height, scale, and opacity.

You can also animate, control the speed and modify other adjustments too, from here.

<figure><img src="/files/6i8qLC4Gn2PXyK1usi1D" alt=""><figcaption><p>Adjusting the Image</p></figcaption></figure>

## Also Check

{% content-ref url="/pages/FD9cNw48RcN5ttSRItCU" %}
[Image Optimizations](/guidelines-compatibility/guidelines/experience-optimizations/image-optimizations)
{% endcontent-ref %}

{% content-ref url="/pages/DOPkjC7oAlUxSs5Ixooa" %}
[Image Aspect Ratio](/guidelines-compatibility/guidelines/asset-guidelines/image-aspect-ratio)
{% endcontent-ref %}


# Video

## How do I add a video to my experience?

{% hint style="info" %}
To play your video at the desired time, make use of "Rules". Ensure that you apply the "play video" rule during any "is clicked" event.
{% endhint %}

Also read [Video Optimizations](/guidelines-compatibility/guidelines/experience-optimizations/video-optimizations#video-autostart-limitations)

### Step 1: Add a Video

You can add a video by clicking on the '**+**' icon in the top bar.

<figure><img src="/files/qxsYznc9csexXTUoKGMt" alt=""><figcaption><p>Adding a video</p></figcaption></figure>

### Step 2: Upload / Choose file

You can choose from the inventory of videos or upload one from your computer.

Read below to know how to select a file to upload a video.

{% content-ref url="/pages/89Dj2jFYZ5UbZ0t6i2fd" %}
[Selecting a file](/metaverse/build/editor/file-manager/3rd-person-scenes)
{% endcontent-ref %}

### Step 3: Adjust the Video element

{% hint style="info" %}
The reliability of the Video element is **increments of 0.25 seconds**. So if you have a rule that says when Video matches duration 7.2 seconds, it will probably trigger at 7.25 seconds.
{% endhint %}

On the right-hand side, there are multiple options available to modify your video element.&#x20;

You can replace the video, give it a new name, adjust its dimensions, transparency, and proportion, as well as other features.

You can also animate, control the speed and modify other adjustments too, from here.               &#x20;

<figure><img src="/files/W1dZKClpoZba3My0bnr8" alt=""><figcaption><p>Adjusting a video element</p></figcaption></figure>

## Also Read

{% content-ref url="/pages/TcvheDBaaw9NC5xGFOAH" %}
[Apply Green Screen to Videos](/guidelines-compatibility/guidelines/workflows/green-screen/apply-green-screen-to-videos)
{% endcontent-ref %}


# Audio

## Can I add audio to my experience?

{% hint style="info" %}
To play your audio at any desired time, make use of "Rules". Ensure that you apply the "should play" rule, when any event occurs.
{% endhint %}

### Step 1: Add an Audio Element

You can add an Audio file by clicking on the '**+**' icon in the top bar and selecting ‘Audio’.

<figure><img src="/files/f83Zj2mXlTrnMWw26xVw" alt=""><figcaption><p>Adding Audio element</p></figcaption></figure>

### Step 2: Upload / Choose file

On the right panel, go to properties and select 'Click to Upload'.

You can choose the audio file from your computer or select from the available templates.

Read below to know how to select a file to upload an audio element.

{% content-ref url="/pages/89Dj2jFYZ5UbZ0t6i2fd" %}
[Selecting a file](/metaverse/build/editor/file-manager/3rd-person-scenes)
{% endcontent-ref %}

<figure><img src="/files/pAiPlDgjFcuASHEOJ600" alt=""><figcaption><p>Selecting an audio file</p></figcaption></figure>

### Step 3: Adjust the Audio element

From the Properties Panel, you can preview the audio element, control the volume, silence it, or set it to loop.

<figure><img src="/files/nAc7UgFNtoYovrK0iKzF" alt=""><figcaption><p>Adjusting the audio element</p></figcaption></figure>

## Example Experience

{% embed url="<https://rnghud.gmetri.com/audio_1>" %}
Example Experience - Audio
{% endembed %}

The rules applied in the above experience are shown below

<figure><img src="/files/25K0mg4yEkHxzcFjv9Ut" alt=""><figcaption><p>Rules applied in the example experience</p></figcaption></figure>




---

[Next Page](/llms-full.txt/1)