# 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="https://413558230-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEtUJA212Zc1S9ACc8T4l%2Fuploads%2F4BazfdKyrlQmFxtH1ymu%2FCustomPackageInstaller.png?alt=media&#x26;token=1d167603-0b8d-416f-8004-acbb88cc8e11" 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="https://413558230-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEtUJA212Zc1S9ACc8T4l%2Fuploads%2FIoB4KRG3P8A21WxxfjRo%2FInstallMRPackage.png?alt=media&#x26;token=6dc9e1bb-b630-4acf-aa87-52adf1df6dff" 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="https://413558230-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEtUJA212Zc1S9ACc8T4l%2Fuploads%2FD6blY6iTuz155VE4x5EU%2FMRAutomaticInstallation_1.png?alt=media&#x26;token=f51aaa04-1495-4ddb-a8fa-bb21f1478b28" 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="https://413558230-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEtUJA212Zc1S9ACc8T4l%2Fuploads%2FeDGAEqdA0pgZ143xULDf%2FMRAutomaticInstallation_2.png?alt=media&#x26;token=e11536be-3f1f-4250-a695-a8ef91e5a91e" 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="https://413558230-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEtUJA212Zc1S9ACc8T4l%2Fuploads%2FrFcVFeaNG7c4xjyPCXNt%2FMRAutomaticInstallation_3.png?alt=media&#x26;token=bbce7039-6979-442d-8341-b83d1ec2f74a" alt=""><figcaption></figcaption></figure>

### Step 7

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

<figure><img src="https://413558230-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEtUJA212Zc1S9ACc8T4l%2Fuploads%2FutBeS6QW2Milht9h0B38%2FMRAutomaticInstallation_4.png?alt=media&#x26;token=8e8441d0-b9e1-402a-91c6-3a998fc2823f" 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="https://413558230-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEtUJA212Zc1S9ACc8T4l%2Fuploads%2F2jQrnwFErlCbY6uAafgX%2FMRAfterAutomaticInstallation.png?alt=media&#x26;token=0c6702f4-6431-4acb-861a-170188db82f0" 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="https://413558230-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEtUJA212Zc1S9ACc8T4l%2Fuploads%2F26EJHcLY9VZ45LjyC5cb%2FTextMeshProInstallation_1.png?alt=media&#x26;token=5e1eae06-1022-41a5-ad9b-d765f9da0ffe" alt="" width="563"><figcaption></figcaption></figure>

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

<figure><img src="https://413558230-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEtUJA212Zc1S9ACc8T4l%2Fuploads%2FNjSzbmM3OB0cGaHhTHcu%2FTextMeshProInstallation_2.png?alt=media&#x26;token=45acb1f9-afb4-418f-bd81-fda07e38a175" alt="" width="375"><figcaption></figcaption></figure>

### **Step 10**

Everything is now set up! :tada::sunglasses:&#x20;

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](https://docs.convai.com/api-docs/plugins-and-integrations/unity-plugin/unity-importing-ready-player-me-rpm-characters).

<figure><img src="https://413558230-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEtUJA212Zc1S9ACc8T4l%2Fuploads%2F7Uqpj600SX5t5PuChX5n%2FSpawnCharacterChange.png?alt=media&#x26;token=975ae0e1-0e8f-4432-83fd-d05584bb2e72" 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 %}