# MOTAR Tutorials

***

{% hint style="warning" %}

### Warning: *You cannot login as multiple users in a single browser session.*

*If you would like to manage multiple users while testing MOTAR, you can open a new "incognito" tab and login as the second user or use a different browser for the second user.*
{% endhint %}

## 1 - Add Platform Owner and Platform Branding

{% stepper %}
{% step %}
**Click** the blue "Edit" button to add the **Owning company** details

**Cosmic Horizon** is the owning company name for this tutorial and most of this information will already be completed based on the license that you uploaded. The Company Image and Favicon for Cosmic Horizon can be found at:&#x20;

**`MOTAR-Tutorial-Files/Platform-Branding/Company Icon/`**`Cosmic-Horizons-Company-Image-100x100.png`

Some information will be auto-populated from the License. **Your information may vary, depending on your license.**

\
Fill in any other missing information for the Platform Owner page and **click** "Save"

<figure><img src="/files/Nz6eN49MhxLh8NA9ZP1s" alt=""><figcaption><p>Platform Owner details page</p></figcaption></figure>
{% endstep %}

{% step %}
**Click** on the Platform Branding tab and **click** the blue "Edit" button.

For this tutorial, fill out the fields using the following:

{% hint style="info" %}
If you are not conducting a trial of MOTAR, and are setting up a MOTAR Instance for your own use, you will input your company's information and upload your company's branding.&#x20;
{% endhint %}

<details>

<summary>Platform Branding Details</summary>

*If you are setting up a MOTAR Instance for your organization, you may input the information for those specific Partners.*

<pre data-title="Contact Support Email: " data-overflow="wrap"><code><strong>support@cosmic-horizons.com
</strong></code></pre>

{% code title="Account Creator Email:" overflow="wrap" %}

```
accounts@cosmic-horizons.com
```

{% endcode %}

{% code title="Platform Name: " overflow="wrap" %}

```
Multidimensional Ecosystem
```

{% endcode %}

{% code title="Landing Page Image:" overflow="wrap" %}

```
MOTAR-Tutorial-Files/Platform-Branding/Landing-Page-Image/ME-Landing-Page-Image-845x850.png
```

{% endcode %}

{% code title="Platform Brand Image:" overflow="wrap" %}

```
MOTAR-Tutorial-Files/Platform-Branding/Platform-Brand-Image/ME-Platform-Branding-Image-480x140.png
```

{% endcode %}

{% code title="Navigation Brand Image:" overflow="wrap" %}

```
MOTAR-Tutorial-Files/Platform-Branding/Navigation-Brand-Image/ME-Navigation-Brand-Image-No-BG-120x35.png
```

{% endcode %}

</details>

<figure><img src="/files/ugS4iKDZtUdy6rcwOCWn" alt=""><figcaption><p>Platform Branding with all details completed</p></figcaption></figure>
{% endstep %}
{% endstepper %}

***

## 2 - Create Partners/Contractors - Studio Groups - and Users

{% stepper %}
{% step %}

### Create Partners/Contractors

> A partner/contractor is an external organization that is allowed on your platform, they can **only** access content that has been shared with them

* Navigate to the Partners or Contractors tab located on the left navigation menu
* Click "+ Partner/Contractor"&#x20;

<figure><img src="/files/MMUCnzRSCSqTpRAGJv7G" alt=""><figcaption><p>"+ Partner" button location</p></figcaption></figure>

* The Partner/Contractor Details pop-up will open

<figure><img src="/files/oNUBsUqIWc12PlRUaK6v" alt=""><figcaption><p>Partner Details pop-up</p></figcaption></figure>

* Enter Partner/Contractor Details

> In this tutorial, we will create two partners/contractors, **Awesome XR** and **New Horizon XR**. These partners will be tasked with creating 3D models and immersive application development

* Enter each partner/contractor into the details pop-up
* **Click** "Add" button to save the new partner/contractor

*Expand the following section for Tutorial Partners/Contractors details.*&#x20;

<details>

<summary>Partners/Contractors Details</summary>

*If you are setting up a MOTAR Instance for your organization, you may input the information for those specific Partners.*

## Awesome XR

{% code title="Company Name: " overflow="wrap" %}

```
AwesomeXR
```

{% endcode %}

{% code title="Company Description: " overflow="wrap" %}

```
An XR Content Creator.
```

{% endcode %}

{% code title="Company Handle: " overflow="wrap" %}

```
@awesomexr
```

{% endcode %}

{% code title="Company Address: " overflow="wrap" %}

```
1969 Artemis Dr., Cape Canaveral, FL 32920
```

{% endcode %}

{% code title="Company Image:  " overflow="wrap" %}

```
MOTAR-Tutorial-Files/Company-Image-&-Favicon/AwesomeXR/AwesomeXR-Company-Image.png
```

{% endcode %}

{% code title="Contact First Name: " overflow="wrap" %}

```
Peter
```

{% endcode %}

{% code title="Contact Last Name: " overflow="wrap" %}

```
Lankton
```

{% endcode %}

{% code title="Contact Email: " overflow="wrap" %}

```
p.lankton@awesomexr.com
```

{% endcode %}

{% code title="Contact Phone Number: " overflow="wrap" %}

```
555-555-1234
```

{% endcode %}

***

## New Horizon XR

{% code title="Company Name: " overflow="wrap" %}

```
New Horizon XR
```

{% endcode %}

{% code title="Company Description: " overflow="wrap" %}

```
An XR Content Creator.
```

{% endcode %}

{% code title="Company Handle: " overflow="wrap" %}

```
@newhorizonxr
```

{% endcode %}

{% code title="Company Address: " overflow="wrap" %}

```
23 Jordan Way, Chapel Hill, NC 27514
```

{% endcode %}

{% code title="Company Image:  " overflow="wrap" %}

```
MOTAR-Tutorial-Files/Company-Image-&-Favicon/New-Horizon-XR/New-Horizon-XR-Company-Image.png
```

{% endcode %}

{% code title="Contact First Name: " overflow="wrap" %}

```
Andromeda
```

{% endcode %}

{% code title="Contact Last Name: " overflow="wrap" %}

```
Polaris
```

{% endcode %}

{% code title="Contact Email: " overflow="wrap" %}

```
a.polaris@newhorizonxr.com
```

{% endcode %}

{% code title="Contact Phone Number: " overflow="wrap" %}

```
555-555-5678
```

{% endcode %}

</details>

Once you have enter **both** Tutorial Partners, your Active Partners screen should match the following image:

<figure><img src="/files/p2lliJccR93gIPlqYpZM" alt=""><figcaption><p>Active Partners list (Tutorial Partners added)</p></figcaption></figure>
{% endstep %}

{% step %}

### Create Studio Groups

> A **Studio Group** functions like a department within a commercial organization. Users assigned to a Studio group are granted the "creator" role, giving them access to the Studio service.&#x20;
>
> Additionally, listings can be permissioned to specific Studio Groups, ensuring that only members of the appropriate group can access or manage them.&#x20;

* Navigate to the Studio Groups tab located on the left navigation menu
* **Click** "+ Studio Group"

<figure><img src="/files/YeSEBylhdVlaZujPSfS2" alt=""><figcaption><p>Active Studio Groups list (currently empty)</p></figcaption></figure>

* The Studio Group Details pop-up will open

<figure><img src="/files/eowIuiCwueAZat5O8GCm" alt=""><figcaption><p>Adding a Studio Group</p></figcaption></figure>

* Enter Studio Group details:&#x20;

> In this tutorial, you will create two Studio Groups: **Awesome XR Studio** and **New Horizon XR Studio**. These represent the functional studios for each partner, and individual users will be assigned to them accordingly.

* Enter each Studio Group into the details pop-up
* **Click** "Add" button to save the new Studio Group

{% hint style="info" %}
Although the Studio Groups created in this tutorial may appear identical to the Partners added in the previous step, it's important to understand that a single Partner can have multiple Studio Groups, similar to departments within a company. For example, **Awesome XR** might include both an **Production Studio Group** and an **Distribution Studio Group**. This structure allows for highly customizable permission settings across different teams or functions.
{% endhint %}

*Expand the following section for* Studio Group *details.*&#x20;

<details>

<summary>Studio Group Details</summary>

If you are setting up a MOTAR Instance for your organization, input the information for those specific Studio Groups.

### Awesome XR Studio

{% code title="Studio Group Name: " overflow="wrap" %}

```
Awesome XR Studio
```

{% endcode %}

{% code title="Studio Group Description: " overflow="wrap" %}

```
XR content creation team.
```

{% endcode %}

<pre data-title="Studio Group Handle: " data-overflow="wrap"><code><strong>@awesomexrstudio
</strong></code></pre>

{% code title="Studio Group Image:  " overflow="wrap" %}

```
MOTAR-Tutorial-Files/Company-Image-&-Favicon/AwesomeXR/AwesomeXR-Company-Image.png
```

{% endcode %}

{% code title="Contact First Name: " overflow="wrap" %}

```
Athena
```

{% endcode %}

{% code title="Contact Last Name: " overflow="wrap" %}

```
Pollo
```

{% endcode %}

{% code title="Contact Email: " overflow="wrap" %}

```
a.pollo@awesomexr.com
```

{% endcode %}

{% code title="Contact Phone Number: " overflow="wrap" %}

```
555-555-1234
```

{% endcode %}

***

### New Horizon XR Studio

{% code title="Studio Group Name: " overflow="wrap" %}

```
New Horizon XR Studio
```

{% endcode %}

{% code title="Studio Group Description: " overflow="wrap" %}

```
XR content creation team.
```

{% endcode %}

<pre data-title="Studio Group Handle: " data-overflow="wrap"><code><strong>@newhorizonxrstudio
</strong></code></pre>

{% code title="Studio Group Image:  " overflow="wrap" %}

```
MOTAR-Tutorial-Files/Company-Image-&-Favicon/New-Horizon-XR/New-Horizon-XR-Company-Image.png
```

{% endcode %}

{% code title="Contact First Name: " overflow="wrap" %}

```
Andromeda
```

{% endcode %}

{% code title="Contact Last Name: " overflow="wrap" %}

```
Polaris
```

{% endcode %}

{% code title="Contact Email: " overflow="wrap" %}

```
a.polaris@newhorizonxr.com
```

{% endcode %}

{% code title="Contact Phone Number: " overflow="wrap" %}

```
555-555-5678
```

{% endcode %}

</details>

Once you have enter **both** Tutorial Studio Groups, your Active Studio Groups screen should match the following image:

<figure><img src="/files/zRYQLJk4THZ6E9BDeYvg" alt=""><figcaption><p>The Studio Groups Tab</p></figcaption></figure>
{% endstep %}

{% step %}

### Create Users

* Navigate to the Users tab located on the left navigation menu
* **Click** "+ Add New User"

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

* The User Details pop-up will open

<figure><img src="/files/LYISSMxP4sndKAdIuvGd" alt=""><figcaption><p>User Details pop-up</p></figcaption></figure>

The pop-up contains three sections that must be completed in order. You must fill out all required fields in the current section before proceeding to the next. Use the tabs below to view each section:

{% tabs %}
{% tab title="User Details" %}

<figure><img src="/files/LYISSMxP4sndKAdIuvGd" alt=""><figcaption><p>User Details tab</p></figcaption></figure>
{% endtab %}

{% tab title="User Role(s)" %}

<figure><img src="/files/504rjtUa8Kofe3kWu2DD" alt=""><figcaption><p>User Role(s) tab</p></figcaption></figure>
{% endtab %}

{% tab title="Summary" %}

<figure><img src="/files/qX7iVxq5jZavGRPZE7v8" alt=""><figcaption><p>User Summary tab</p></figcaption></figure>
{% endtab %}
{% endtabs %}

> MOTAR offers multiple user roles:
>
> * **Standard User**: This role provides access to the platform features allowed by your license. It is selected by default. Standard users can interact with content according to the permissions set by the license.
> * **Auditor**: In addition to standard features, auditors can view, download, use, and distribute Hub listings. This role is ideal for users who need to audit or evaluate assets.
> * **Admin**: Admins have full access to the platform, including all administrative tools and settings.&#x20;
>   * **In this tutorial, you created an admin user during the initial installation setup.**

{% hint style="warning" %}
During this tutorial, we will switch between multiple user accounts. Each user must be assigned a password during creation, and they will be required to set a new password upon their first login.

For convenience, we’ve provided a **temporary password** and a **final password** that can be used across all tutorial users. These are intended for instructional use only, **do not use them for any real or secure accounts**.
{% endhint %}

For this **tutorial**, add the following **four** users via the users tab from the left menu, assign them to their respective **Partner Companies** and provision their respective roles.&#x20;

<details>

<summary>User Details</summary>

*All other **required** information (Salutation, etc.) can be arbitrary for this tutorial.* &#x20;

> For convenience, use the following shared passwords for all tutorial users:
>
> * **Temporary Password (used when creating the user profile):**&#x20;
>   * `Welcome12345!Test`
> * **Final Password (used when logging in for the first time, required):**&#x20;
>   * `Zebra$19plane!echo`
> * **Important:** These passwords are for **instructional use only**. Do not use them for securing real accounts.

***

{% hint style="info" %}
User handles are auto-generated during user creation. For this tutorial, each user will have **firstname-lastname** user handles. These will be noted during later steps.
{% endhint %}

## User 1

{% code title="First Name:" overflow="wrap" %}

```
John
```

{% endcode %}

{% code title="Last Name:" overflow="wrap" %}

```
Allen
```

{% endcode %}

{% code title="Primary Email:" overflow="wrap" %}

```
john@awesomexr.com
```

{% endcode %}

{% code title="Title:" overflow="wrap" %}

```
CTO
```

{% endcode %}

{% code title="Partner Company:" overflow="wrap" %}

```
Awesome XR
```

{% endcode %}

{% code title="Country:" overflow="wrap" %}

```
United States
```

{% endcode %}

{% code title="Role:" overflow="wrap" %}

```
Auditor
```

{% endcode %}

{% code title="Temporary Password:" overflow="wrap" %}

```
Welcome12345!Test
```

{% endcode %}

***

***

## User 2

{% code title="First Name:" overflow="wrap" %}

```
Kalvin
```

{% endcode %}

{% code title="Last Name:" overflow="wrap" %}

```
Smith
```

{% endcode %}

{% code title="Primary Email:" overflow="wrap" %}

```
kalvin@awesomexr.com
```

{% endcode %}

{% code title="Title:" overflow="wrap" %}

```
Manager
```

{% endcode %}

{% code title="Partner Company:" overflow="wrap" %}

```
Awesome XR
```

{% endcode %}

{% code title="Country:" overflow="wrap" %}

```
United States
```

{% endcode %}

{% code title="Role:" overflow="wrap" %}

```
Admin
```

{% endcode %}

{% code title="Temporary Password:" overflow="wrap" %}

```
Welcome12345!Test
```

{% endcode %}

***

***

## User 3

{% code title="First Name:" overflow="wrap" %}

```
Adam
```

{% endcode %}

{% code title="Last Name:" overflow="wrap" %}

```
Coder
```

{% endcode %}

{% code title="Primary Email:" overflow="wrap" %}

```
adam@newhorizonxr.com
```

{% endcode %}

{% code title="Title:" overflow="wrap" %}

```
Developer
```

{% endcode %}

{% code title="Partner Company:" overflow="wrap" %}

```
New Horizon XR
```

{% endcode %}

{% code title="Country:" overflow="wrap" %}

```
United States
```

{% endcode %}

{% code title="Role:" overflow="wrap" %}

```
Auditor
```

{% endcode %}

{% code title="Temporary Password:" overflow="wrap" %}

```
Welcome12345!Test
```

{% endcode %}

***

***

## User 4

{% code title="First Name:" overflow="wrap" %}

```
Tiffani
```

{% endcode %}

{% code title="Last Name:" overflow="wrap" %}

```
Bee
```

{% endcode %}

{% code title="Primary Email:" overflow="wrap" %}

```
tiff@newhorizonxr.com
```

{% endcode %}

{% code title="Title:" overflow="wrap" %}

```
Producer
```

{% endcode %}

```
Partner Company:

New Horizon XR
```

{% code title="Country:" overflow="wrap" %}

```
United States
```

{% endcode %}

{% code title="Role:" overflow="wrap" %}

```
Admin
```

{% endcode %}

{% code title="Temporary Password:" overflow="wrap" %}

```
Welcome12345!Test
```

{% endcode %}

***

</details>

Once you have enter **all four** Tutorial Users, your Active Users screen should match the following image:

<figure><img src="/files/OoYUDqARoBwLobwM4QuH" alt=""><figcaption><p>New users added</p></figcaption></figure>
{% endstep %}

{% step %}

### 3 - Add Users to Studio Groups

Now we want to **add** those **users** into their respective studio groups.&#x20;

* **Click** on "Studio Groups" in left menu
* **Click** the "Edit pencil" and open **New Horizons XR Studio** group page

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

* **Click** on the "Users" tab

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

* **Click** the "+ User" button

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

* Add Adam and Tiffani to this studio group by **clicking** the "+ Add" button next to their profiles
* **Click** "Done"

<figure><img src="/files/okWuyRuQUFZfEgEtITkI" alt=""><figcaption><p>Studio Gropu Add Users pop-up</p></figcaption></figure>

* Repeat these steps for the **Awesome XR** Studio&#x20;
* *Add **John** and **Kalvin to Awesome XR***
  {% endstep %}

{% step %}

### Logout

**Logout** of the platform as the Owning Company Admin by clicking the navigator menu > "Logout"

<figure><img src="/files/2xmtPOmSAd03EJsZ0Ega" alt=""><figcaption><p>Logout location</p></figcaption></figure>
{% endstep %}
{% endstepper %}

Now that you have Partners/Contractors, Studio Groups, and Users, you are ready to add content!

***

## 4 - Add Content to MOTAR Instance

As mentioned in the **Introduction video**, you are working with external partners who are aiding your corporation with **3D models** and **immersive application** development.&#x20;

This **content** needs to be added to the **MOTAR platform**, so that all company and partner users can access the content to achieve the contract's objectives.&#x20;

In this next step, you will first add the MOTAR Tutorial Video that you watched at the start of this tutorial to the MOTAR Instance, so that it can be referenced by company and partner users throughout the contract.&#x20;

Following that, you will add various 3D models that have been created by the Awesome XR Partner Organization, that will be used to create the application training users how to fly a UFO.

***

* Login as **Kalvin Smith** of the AwesomeXR

<figure><img src="/files/JlhnCaUjgkr9DDaXRRlx" alt=""><figcaption><p>MOTAR Login screen</p></figcaption></figure>

> Since this will be your first time logging in as this user, you will be required to change the password. Here are the logins:
>
> * **Username**:&#x20;
>   * `kalvin-smith`
> * **Temporary Password (used when creating the user profile):**&#x20;
>   * `Welcome12345!Test`
> * **Final Password (used when logging in for the first time, required):**&#x20;
>   * `Zebra$19plane!echo`

* **Navigate** to the Studio service

<figure><img src="/files/7nfjg3ubSdaFAykWuTuW" alt=""><figcaption><p>Studio page</p></figcaption></figure>

{% hint style="warning" %}

### The following steps may require you to log in and out of various users.

*You cannot login as multiple users in a single browser session!*

\
\&#xNAN;*If you would like to manage multiple users while testing MOTAR, you can open a new "incognito" tab and login as the second user **or** use a different browser for the second user.*
{% endhint %}

### **Create a Video Listing**

<details>

<summary>Video Listing Guide</summary>

Using the video downloaded from the [Broken mention](broken://pages/4ZrWu216oQkhsbq4nR9n), create a new video asset.

<figure><img src="/files/D3lyHCE6kicTPqImxY1G" alt=""><figcaption><p>Video Listing Details</p></figcaption></figure>

* **Click** on the "Create Video" button to open the new listing modal
  * **Modal: What Type of Listing are you creating?**
    * Select **New HUB Listing**

Use the following information for the video listing details:

* **Asset File Path:**
  * `MOTAR-Tutorial-Files/Listings/Video/MOTAR-Ghost-Tutorial-Video-v2.mp4`
* **Listing Name:**
  * *MOTAR Ghost Tutorial Video*
* **Listing Description:**
  * *This tutorial will guide you through the MOTAR Ghost installation on your laptop or in your preferred cloud environment.*
* **Thumbnail Image Path:**
  * `MOTAR-Tutorial-Files/Listings/App/learn_to_fly_ufo_icon.png`
* **Click** the "Create" button
* **Settings:**
  * Select **Standard**
* **Permission Wizard:**
  * **Click** the "plus icon" in the **Public Modify** section to grant full rights to the user
* **Check** the box:
  * *“I certify that the information above is correct and ready to share”*
* **Click** "Publish"
* When prompted, choose **"Keep the current permissions"**

{% hint style="success" %}
Now that you have your first asset, return to the Hub and check it out!
{% endhint %}

* Navigate to the Hub Service

<figure><img src="/files/jHOY51irO2roRC3rqFt8" alt=""><figcaption><p>Hub discover page</p></figcaption></figure>

* Watch your uploaded video

<figure><img src="/files/LUcm6Oh89EAzMik0oQ4f" alt=""><figcaption><p>Video listing Hub details</p></figcaption></figure>

* Return to the Studio service

<figure><img src="/files/SOxTtw2Ic8xlHb5m9F9M" alt=""><figcaption><p>Studio service page</p></figcaption></figure>

</details>

### Create 3D Model Listings

<details>

<summary>Power Cell Model Listings Guide</summary>

*For this step you will create three versions of a Power Cell. This will teach you about the Digital Thread and Remixes!*

Use the details below to create three 3D model listings.

#### Blue UFO Power Cell - V1.0

<figure><img src="/files/gnua3WkdMRM0fy0zpfeZ" alt=""><figcaption><p>3D Model Listing Details</p></figcaption></figure>

* Click on the **Create Model** icon
* **What Type of Listing are you creating?**
  * Select **New HUB Listing**

**Upload**

* **Asset File Path:**
  * `MOTAR-Tutorial-Files/Listings/3D-Model/Powercell/1-Blue-Power-Cell/UFO_Powercell_1.glb`

**Info**

* **Listing Name:**
  * *Blue UFO Power Cell*
* **Listing Description:**
  * *A Power Cell found near the crashed UFO found in the Outer Banks of North Carolina. This is believed to be the energy source of the UFO. Observations note that this Power Cell glows blue.*
* **Thumbnail Image Path:**
  * `MOTAR-Tutorial-Files/Listings/3D-Model/Powercell/1-Blue-Power-Cell/UFO_Powercell_1.png`
* **3D Preview File:** (Optional: REQUIRED for viewing when [MOTAR Holodeck](/motar-core-services/intro-to-core-services/devices/motar-holodeck.md))
  * `MOTAR-Ghst-Tutorial-Files/Listings/3D-Model/Powercell/1-Blue-Power-Cell/UFO_Powercell_1.glb`
* **Click** "Create"

**Settings**

* **Polycount:**
  * *10,000 – 100,000*
* **Textures Included:** Yes
* **Animations Included:** No
* **Click** "Save"

**Permission Wizard:**

* **Click** the "plus" icon in the **Partners Modify** section
  * Add **Cosmic Horizon** and their partners to grant exclusive rights to this listing
* **Check** the box:
  * *“I certify that the information above is correct and ready to share”*
* **Click** "Publish"
  * Select **Keep Current Permissions**

***

#### Yellow UFO Power Cell - V1.1

<figure><img src="/files/WW9OAQvPM1k0SeWHMBWD" alt=""><figcaption><p>3D Model child remix</p></figcaption></figure>

* **Click** on the "Create Model" icon to open the new listing modal
  * Modal: What Type of Listing are you creating?
    * Select **Add a new Version to my own listing**
* What Type of Version are you adding?
  * Select **Add a Remix Version**
* Select the asset to make a version of:
  * Choose ***Blue Power Cell** V1.0*
* Select Where you would like your new Version to Go:
  * Select **Add a Child Version**

**Upload**

* **Asset File Path:**
  * `MOTAR-Tutorial-Files/Listings/3D-Model/Powercell/1-Yellow-Power-Cell/UFO_Powercell_2.glb`

**Info**

* **Listing Name:**
  * Yellow UFO Power Cell
* **Listing Description:**
  * Found near the crash site, this Power Cell is believed to be the energy source for the crashed UFO found in the Tahoe National Forest. Dissimilar to the original Power Cell, this Power Cell glows Yellow.
* **Thumbnail Image Path:**
  * `MOTAR-Tutorial-Files/Listings/3D-Model/Powercell/1-Yellow-Power-Cell/UFO_Powercell_2.png`
* **3D Preview File:** (Optional: REQUIRED for viewing when [MOTAR Holodeck](/motar-core-services/intro-to-core-services/devices/motar-holodeck.md))
  * `MOTAR-Tutorial-Files/Listings/3D-Model/Powercell/2-Yellow-Power-Cell/UFO_Powercell_2.glb`
* Click **Create**

**Settings**

* **Polycount:**
  * *10,000 – 100,000*
* **Textures Included:** Yes
* **Animations Included:** No
* **Click** "Save"

**Permission Wizard:**

* **Click** the "plus icon" in the **Partners Modify** section
  * Add **Cosmic Horizon** and their partners to grant exclusive rights to this listing
* **Check** the box:
  * *“I certify that the information above is correct and ready to share”*
* **Click** Publish"
  * Select **Keep Current Permissions**

***

#### Purple UFO Power Cell - V2.0

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

* **Click** on the "Create Model" icon to open the new listing. modal
  * Modal: What Type of Listing are you creating?
    * Select **Add a new Version to my own listing**
* What Type of Version are you adding?
  * Select **Add a Remix Version**
* Select the asset to make a version of:
  * Choose ***Blue Power Cell** V1.0*
* Select Where you would like your new Version to Go:
  * Select **Add a Parent Version**

**Upload**

* **Asset File Path:**
  * `MOTAR-Tutorial-Files/Listings/3D-Model/Powercell/1-Purple-Power-Cell/UFO_Powercell_3.glb`

**Info**

* **Listing Name:**
  * Purple UFO Power Cell
* **Listing Description:**
  * Power Cell found near the UFO crash site in the Appalachian Mountains. Unlike the other two Power Cells, this one has a purple aura.
* **Thumbnail Image Path:**
  * `MOTAR-Tutorial-Files/Listings/3D-Model/Powercell/1-Purple-Power-Cell/UFO_Powercell_3.png`
* **3D Preview File:** (Optional: REQUIRED for viewing when [MOTAR Holodeck](/motar-core-services/intro-to-core-services/devices/motar-holodeck.md))
  * `MOTAR-Tutorial-Files/Listings/3D-Model/Powercell/2-Purple-Power-Cell/UFO_Powercell_3.glb`
* **Click** "Create"

**Settings**

* **Polycount:**
  * *10,000 – 100,000*
* **Textures Included:** Yes
* **Animations Included:** No
* **Click** "Save"

**Permission Wizard:**

* **Click** the "plus" icon in the **Partners Modify** section
  * Add **Cosmic Horizon** and their partners to grant exclusive rights to this listing
* **Check** the box:
  * *“I certify that the information above is correct and ready to share”*
* **Click** "Publish"
  * Select **Keep Current Permissions**

</details>

<details>

<summary>Flashlight Model Listings Guide</summary>

Now you will create two versions of a Flashlight listing. *(Version 1.0 without texture and Version 1.1 Remix with texture).*&#x20;

#### Untextured Flashlight

<figure><img src="/files/C9cwD5NAzaFo5EximZNS" alt=""><figcaption><p>Flashlight listing</p></figcaption></figure>

* **Click** on the "Create Model" icon to open the new listing modal
  * **What Type of Listing are you creating?**
    * Select **New HUB Listing**

**Upload**

* **Asset File Path:**
  * `MOTAR Tutorial Files > Listings > 3D Model > Flashlight > 1. Untextured Flashlight > Dynepic_Flashlight_1.gltf`

**Info**

* **Listing Name:**
  * MOTAR Demo Flashlight
* **Listing Description:**
  * A 3D Model of a Flashligh&#x74;*.*
* **Thumbnail Image Path:**
  * `MOTAR Tutorial Files > Listings > 3D Model > Flashlight > 1. Untextured Flashlight > Dynepic_Flashlight_1_ThumbnailImage_1.png`
* Click **Create**

**Settings**

* **Polycount:**
  * *1,000 – 10,000*
* **Textures Included:** No
* **Animations Included:** No
* **Click** "Save"

**Permission Wizard:**

* **Click** the "plus" icon in the **Partners Modify** section
  * Add **Cosmic Horizon** and their partners to grant exclusive rights to this listing
* **Check** the box:
  * *“I certify that the information above is correct and ready to share”*
* **Click** "Publish"
  * Select **Keep Current Permissions**

***

#### Textured Flashlight

<figure><img src="/files/wLDf3t7BRLwucixLiGTy" alt=""><figcaption><p>Textured Flashlight</p></figcaption></figure>

* What Type of Listing are you creating?
  * Select **Add a new Version to my own listing**
* What Type of Version are you adding?
  * Select **Add a Remix Version**
* Select the asset to make a version of:
  * Choose **MOTAR Demo Flashlight**
* Select Where you would like your new Version to Go:
  * Select **Add a Child Version**

**Upload**

* **Asset File Path:**
  * `MOTAR-Tutorial-Files/Listings/3D-Model/Flashlight/2-Textured-Flashlight/Dynepic_Flashlight_2.gltf`

**Info**

* **Listing Name:**
  * MOTAR Demo Flashlight
* **Listing Description:**
  * A 3D Model of a Flashligh&#x74;*.*
* **Thumbnail Image Path:**
  * `MOTAR-Tutorial-Files/Listings/3D-Model/Flashlight/2-Textured-Flashlight/Dynepic_Flashlight_2_ThumbnailImage_1.png`
* **Click** "Create"

**Settings**

* **Polycount:**
  * *1,000 – 10,000*
* **Textures Included:** Yes
* **Animations Included:** No
* Click **Save**

**Permission Wizard:**

* **Click** the "plus" icon in the **Partners Modify** section
  * Add **Cosmic Horizon** and their partners to grant exclusive rights to this listing
* **Check** the box:
  * *“I certify that the information above is correct and ready to share”*
* **Click** "Publish"
  * Select **Keep Current Permissions**

</details>

<details>

<summary>UFO Control Panel Model Listing Guide</summary>

*Now you will create a model listing for the UFO Control Panel. This model has **animations***!

#### UFO Control Panel

<figure><img src="/files/LKNKEpX38CFwDndWPa0C" alt=""><figcaption><p>UFO Control Panel listing</p></figcaption></figure>

* **Click** on the "Create Mode"l icon to open the new listing modal
  * **Modal: What Type of Listing are you creating?**
    * Select **New HUB Listing**

#### Upload

* **Asset File Path:**
  * `MOTAR-Tutorial-Files/Listings/3D-Model/UFO-Control-Panel/UFO_Control_Panel.glb`

#### Info

* **Listing Name:**
  * *UFO Control Panel*
* **Listing Description:**
  * *A digital twin of the control panel from inside the crashed UFO found in the Outer Banks of North Carolina.*
* **Thumbnail Image Path:**
  * `MOTAR-Tutorial-Files/Listings/3D-Model/UFO-Control-Panel/UFO_Control_Panel_1.png`
* **3D Preview File (Optional** but REQUIRED when [MOTAR Holodeck](/motar-core-services/intro-to-core-services/devices/motar-holodeck.md)**):**
  * `MOTAR-Tutorial-Files/Listings/3D-Model/UFO-Control-Panel/UFO_Control_Panel.glb`
* **Click** "Create"

#### Settings

* **Polycount:**\
  \&#xNAN;*10,000 – 100,000*
* **Textures Included:** Yes
* **Animations Included:** Yes
* **Click** "Save"

#### Permission Wizard

* **Click** the "plus" icon in the **Partners Modify** section
* Add **Cosmic Horizon** and their partners to grant exclusive rights to this listing
* **Check** the box:\
  \&#xNAN;*“I certify that the information above is correct and ready to share”*
* **Click** "Publish"
* When prompted, select **Keep Current Permissions**

</details>

> Now that you have several listings on Hub, we will log out of the current user.

* Log out of Kalvin Smith

<figure><img src="/files/jyVMkJnShS6KnKhv4Cj4" alt="" width="563"><figcaption><p>Logout location</p></figcaption></figure>

***

### Create an App Listing

The **assets** you uploaded to MOTAR in the previous step have been leveraged by the New Horizon XR Team to create an XR application teaching a user how to Fly the UFOs that have been found across the world.&#x20;

This application needs to be **uploaded** to MOTAR, so that it can be securely distributed to members of the company that will fly the UFOs back to the laboratory for further research and analysis.

* Log in as **Tiffani Bee** of New Horizon XR

> Since this will be your first time logging in as this user, you will be required to change the password. Here are the logins:
>
> * **Username**:&#x20;
>   * `tiffani-bee`
> * **Temporary Password (used when creating the user profile):**&#x20;
>   * `Welcome12345!Test`
> * **Final Password (used when logging in for the first time, required):**&#x20;
>   * `Zebra$19plane!echo`

<details>

<summary>App Listing Guide</summary>

* From the Studio service, **click** the "App" icon

<figure><img src="/files/Tb4QcesSC6VQzi4o4UY0" alt="" width="563"><figcaption><p>Create App button</p></figcaption></figure>

* Select "New Hub Listing"

<figure><img src="/files/3DQTWe9AOx9nbO04peBG" alt=""><figcaption><p>Listing Type selection</p></figcaption></figure>

* Enter the required fields (listed below)

<figure><img src="/files/P5RMpZONpw5lPPpd8TNz" alt=""><figcaption><p>Required Fields</p></figcaption></figure>

* Once the required fields have been entered, the "Create" button will enable
* **Click** "Create"

Your listing will now be created and the Info tab will automatically open.&#x20;

Enter the following details and download the listed files for this listing:

**App Listing Details**

* Listing Name
  * **Learn to Fly UFO**&#x20;
* Listing Description
  * **An alien ship has crashed in a barn. Can you find all the power cells and fly away?**&#x20;
* Thumbnail
  * **MOTAR Tutorial Files > Listings > App > learn\_to\_fly\_ufo\_icon.png**
* Sample Images
  * **MOTAR Tutorial Files > Listings > App > learn\_to\_fly\_ufo\_preview\_01.png**
  * **MOTAR Tutorial Files > Listings > App > learn\_to\_fly\_ufo\_preview\_02.png**
  * **MOTAR Tutorial Files > Listings > App > learn\_to\_fly\_ufo\_preview\_03.png**
  * **MOTAR Tutorial Files > Listings > App > learn\_to\_fly\_ufo\_preview\_04.png**
  * **MOTAR Tutorial Files > Listings > App > learn\_to\_fly\_ufo\_preview\_05.png**
* Does your App run in a web browser?
  * **No**
* Settings
  * **n/a**
* Distribution
  * Listing File Path (download the pre-compiled application before starting)
  * **MOTAR Tutorial Files > Listings > App > learn\_to\_fly\_ufo\_demo.apk**
  * **Meta Quest 3**
  * **learn\_to\_fly\_ufo.apk**
  * **Package Name:** com.Dynepic.LearntoFlyUFO
* SDKs&#x20;
  * **none**
* Permissions&#x20;
  * **Click on the plus in the "Cosmic Horizon Modify" section to only give members of Cosmic Horizon rights to this listing**
  * **Check the “I certify that the information above is correct and ready to share” box**
* Click **"Submit App for Review"**

</details>

{% hint style="info" %}
Now that the app as been created, we will go to **Admin** and approve the app. For this tutorial, we will stay logged in as Tiffani. In a normal workflow, app creation and approval would not be the same person.
{% endhint %}

### Approve the App

* Use the **TopNav** menu on the far **left** to navigate to the **Admin** service
* From the left menu, navigate to **App Review**
* Locate the app created in the previous step
* **Check** the “I have reviewed the app….” box and **approve** the app
* Use the **TopNav** menu on the far left to navigate to the **Studio service**
* From the studio group service, **find your app** and **click** the "Edit pencil", then **click** on "Publish"
* Keep **Current** Permissions Settings
* **Navigate** to the Hub service and see app in Production
* **Log out**

> ## Congratulations!&#x20;
>
> You've successfully learned how to add listings to your instance, approve apps, and create Users, Studio Groups, and Partners. You've covered all the foundational steps needed to manage your MOTAR environment.
>
> The next section moves into more intermediate-to-advanced territory: setting up VR headsets and installing applications on them using our companion app. If you don't have access to a VR headset or prefer to pause here, feel free to continue exploring your MOTAR instance by logging in as different users and experimenting with what you've built so far.

***

## Optional Steps

<details>

<summary>Connecting an XR Headset to your Instance</summary>

***COMING SOON!***

Connecting your XR Headset to your local MOTAR instance is and advanced setup requiring updates to both your network router and your headset's network configuration.&#x20;

This process may be different for every user can cannot be completly covered in an online guide.&#x20;

For more control and reliability, it is recommended you install MOTAR using the [Advanced Deployment Guide](/welcome/getting-started/production-installation/advanced-deployment-guide.md) for cloud hosting and connect to your instance via a domain. \
This would allow MOTAR 3D and App connections without network modifications.

</details>

<details>

<summary>Install MOTAR 3D to VR Headsets</summary>

**MOTAR 3D** is an immersive XR companion application that allows you to quickly discover, install, and launch immersive content found on the Hub and begin collaborative learning through a virtual environment on any XR device, no matter where your team members are located.&#x20;

MOTAR 3D is compatible with the following devices.

* Meta Quest 2
* Meta Quest 3
* Meta Quest Pro
* Vive Focus 3

It even works seamlessly with **Meta Quest for Business**.&#x20;

Instructions for downloading and installing MOTAR 3D can be found [HERE](/additioinal-features/motar-3d.md)

{% hint style="warning" %}
Side loading applications to Meta Quest devices requires a Meta Developer account and for the device to be in "Devleoper Mode".&#x20;
{% endhint %}

</details>

<details>

<summary>Install the App to the Headset</summary>

Your pre-existing app is now **ready for distribution**. Loading apps onto a **VR** device depends on your current organization setup.&#x20;

Whether your ogranization uses **Meta Quest for Business**, Meta Quest Devloper Hub, or sideloading,  learn how by following the app installtion guide: [MOTAR 3D](/additioinal-features/motar-3d.md#installing-applications-on-a-vr-device)

</details>

<details>

<summary>Launch an Application</summary>

You can **launch** your application in two ways.&#x20;

From within **MOTAR 3D**, by clicking "Launch" on the app listing

OR

**Launch** directly from Hub!

* Log into Hub.&#x20;
* Locate the application and open the Hub listing Page.&#x20;
* Click “Launch with MOTAR 3D” in the top right corner.

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

If MOTAR 3D is **installed** on the Headset, click “Continue on Headset.”

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

**Follow the instructions** on the MOTAR Devices page to sync the headset.

* Launch MOTAR 3D.
* Sync the device.

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

{% hint style="warning" %}
Launcing applications via web or MOTAR 3D on Meta Quest devices requires the application be installed prior to launching.
{% endhint %}

</details>

<details>

<summary>Build an XR Application Using the MOTAR SDK for Unity</summary>

Ready to put your development skills to the test? Dive into our complete Unity XR sample project and see how easy it is to create immersive experiences using the MOTAR SDK for Unity. In this guide, you'll learn how to:

* Set up the MOTAR SDK in a Unity project
* Integrate the MOTAR XR Rig into your scene
* Compile and prepare your application for hosting on your MOTAR instance

Whether you're exploring XR for the first time or looking to extend your MOTAR experience, this project is a great place to start!

👉 [**Get Started with the Learn to Fly UFO Complete Project**](broken://pages/eP6dJt0EMPCMrJFh5eM5)

</details>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.motar.com/welcome/motar-tutorials.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
