# MR Automatic Installation

## Automatic Installation Steps

{% hint style="success" %}
The Automatic Installation method is ideal for users starting new projects who want a straightforward setup. It provides a fully integrated Convai MR project from the beginning, ensuring a smoother development experience.
{% endhint %}

### Step 1

In the top menu, click on **Convai**. Then, select **Custom Package Installer**.

<figure><img src="/files/780eBRQ3VQbmAHXoNi8p" alt=""><figcaption></figcaption></figure>

### Step 2

In the Convai Panel that appears, click on **Package Management** and then select **Install MR Package**.

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

### Step 3

A new window will appear prompting you to select your installation type. For this documentation, we will proceed with **Automatic Installation**.

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

### Step 4

In the next window, carefully read the setup instructions, warnings, and details of the changes that will be applied.

### Step 5

When ready to proceed, click **Yes, proceed**.

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

### Step 6

The installation process will begin, taking approximately 5 minutes. The duration may vary depending on your computer's performance.

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

### Step 7

If a prompt titled **OVRPlugin Detected** from MetaSDK appears, click **Restart Editor** to continue.

<figure><img src="/files/6kM5JtfCXiiEyCmPN3xs" alt=""><figcaption></figcaption></figure>

### Step 8

Once the installation is complete, it’s time to open the demo scene.

* Navigate to **Assets > Convai > ConvaiXR > ConvaiMR > Scenes** and open **Convai Demo - MR**.

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

### Step 9

If you don’t have the **TextMeshPro** package installed, you’ll need it to display text properly in the demo scene. To install it:

* Go to **Window > TextMeshPro > Import TMP Essential Resources**.

<figure><img src="/files/ICp7ZpVve9vgEMHrlmqJ" alt="" width="563"><figcaption></figcaption></figure>

* In the **Unity Package Import** window that appears, click **Import**.

<figure><img src="/files/3EUwOBwp23g7fjC8DLw7" alt="" width="375"><figcaption></figcaption></figure>

### **Step 10**

Everything is now set up! :tada::sunglasses:

You can build your project by going to **File > Build Settings**.

## Replacing the Spawned Character

### Step 1

In the demo scene, select **\[BuildingBlock] Find Spawn Positions** in the hierarchy.

### Step 2

In the **Spawn Object** field, drag and drop the character you imported into the project.

* If you’re unsure how to import your character, please refer to the relevant documentation [here](/api-docs/plugins-and-integrations/unity-plugin/unity-importing-ready-player-me-rpm-characters.md).

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

{% hint style="info" %}
This demo scene uses **MetaSDK** by default. However, you are free to use other methods or SDKs to spawn your character, as there are no restrictions.
{% endhint %}


---

# 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.convai.com/api-docs/plugins-and-integrations/unity-plugin/building-for-supported-platforms/convai-xr/building-for-mr/mr-automatic-installation.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.