# Building for MR

## Integrating Convai with MR: Quick and Flexible Setup Options

{% embed url="<https://youtu.be/rfd_OPiKLh8>" %}
Immersive AI Characters That Perceive & Engage in Mixed Reality Scenarios | Convai Unity Tutorial
{% endembed %}

Setting up Convai for Mixed Reality (MR) is easier than you might think. With just a few clicks, you can get Convai integrated directly into your MR projects.

To give users flexibility and customization options, we offer **two installation methods**:

* **Automatic Installation**
* **Manual Installation**

### **Automatic Installation**

The Automatic Installation method is ideal if you’re starting a new project and want to avoid dealing with MR packages or additional setup requirements. This method provides a fully Convai-integrated MR project right from the start, including the **Convai MR Demo Scene** for quick testing and exploration. This approach is particularly suitable for beginners.

{% hint style="warning" %}
**Note:** This installation method will modify Unity Project settings. These changes are necessary to ensure compatibility with Convai.
{% endhint %}

### **Manual Installation**

The Manual Installation method is designed for existing MR projects. With this method, you have full control over the setup, as **no project settings are modified, no demo scenes are added, and no customizations are applied**. Only Convai’s XR Unity Package will be integrated, giving you the freedom to use any MR SDKs without restrictions.

## Choose Your Installation Method

Select one of the two installation methods and click on the corresponding setup section below to follow the instructions.

{% content-ref url="building-for-mr/mr-automatic-installation" %}
[mr-automatic-installation](https://docs.convai.com/api-docs/plugins-and-integrations/unity-plugin/building-for-supported-platforms/convai-xr/building-for-mr/mr-automatic-installation)
{% endcontent-ref %}

{% content-ref url="building-for-mr/mr-manual-installation" %}
[mr-manual-installation](https://docs.convai.com/api-docs/plugins-and-integrations/unity-plugin/building-for-supported-platforms/convai-xr/building-for-mr/mr-manual-installation)
{% endcontent-ref %}

## Convai Controller Scheme

<figure><img src="https://413558230-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEtUJA212Zc1S9ACc8T4l%2Fuploads%2FM7daczuIIcoPipJQFfvo%2FConvaiDefaultXRControllerScheme.png?alt=media&#x26;token=079fa771-44b4-478a-95f5-be3fbb1ba568" alt=""><figcaption></figcaption></figure>


---

# 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.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.