# Get the Unity SDK

The first step to use coherence in Unity is to install the coherence SDK.

#### Requirements

Latest [Unity LTS releases](https://unity.com/releases/editor/qa/lts-releases) are officially supported. As of now, we support:

* **Unity 6 LTS** (min. 6000.0.23f1)
* **Unity 2022 LTS** (min. 2022.2.5f1)
* **Unity 2021 LTS** (min. 2021.3.45f1)

## From the Unity Asset Store <a href="#from-the-unity-asset-store" id="from-the-unity-asset-store"></a>

You can conveniently download the SDK from the [Unity Asset Store](https://assetstore.unity.com/packages/tools/network/coherence-multiplayer-networking-301977):

​[​![image-text](https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FQLuEkuU7DLr3jX7gVtzJ%2Fuploads%2FPeO0wWqdy8W4P1XGzUfB%2FcoherenceAssetStore.png?alt=media\&token=745c6a6d-aaf7-4195-bfe0-90752afd785c)​](https://assetstore.unity.com/packages/tools/network/coherence-multiplayer-networking-301977)​

## Alternative: From our package repository <a href="#alternative-from-our-package-repository" id="alternative-from-our-package-repository"></a>

As an alternative to the Asset Store download, you can manually install coherence from our package repository. The rest of this page describes the steps to do so.

### Video tutorial <a href="#video-tutorial" id="video-tutorial"></a>

{% embed url="<https://www.youtube.com/watch?v=DXCdYSLpH6U>" %}

### Step by step process

#### 1. Add the Scoped Registry

First, go to **Edit** > **Project Settings**. Under [Package Manager](https://docs.unity3d.com/Manual/class-PackageManager.html), add a new Scoped Registry with the following information:

* Name: `coherence`
* URL: `https://registry.npmjs.org`
* Scope(s): `io.coherence.sdk`

![Package Manager Advanced Settings](https://content.gitbook.com/content/CMCtKgV0bk1lwR4tWK3W/blobs/q2ZOzsMnpIeKcyDXmA6V/01%20Set%20up%20Unity%20Package%20Manager.png)

#### 2. Install coherence

Now open **Window** > **Package Manager**. Select **My Registries** in the **Packages** dropdown.

![](https://content.gitbook.com/content/CMCtKgV0bk1lwR4tWK3W/blobs/Cn3moV6B5LVmxTaLId86/image.png)

Highlight the *coherence* package, and click **Install**.

![](https://content.gitbook.com/content/CMCtKgV0bk1lwR4tWK3W/blobs/5SNSH2Q26KhL4tKmMMxu/03%20Install%20coherence.png)

## Alternative: manually edit the manifest

As an alternative to the step-by-step process above, you can directly edit your package manifest.

{% hint style="info" %}
Refer to Unity's instructions on [modifying your project manifest](https://docs.unity3d.com/Manual/upm-scoped.html#managing).
{% endhint %}

* Edit :open\_file\_folder:`/Packages/manifest.json`
  1. Add an entry for the coherence SDK under the `dependencies` object
  2. Add one for the scoped registry in the `scopedRegistries` array

You can see an example below:

```json
{
  "dependencies": {
    "com.unity.collab-proxy": "1.3.9",
    "com.unity.ide.rider": "2.0.7",
    "com.unity.ide.visualstudio": "2.0.7",
    "com.unity.ide.vscode": "1.2.3",
    "com.unity.ugui": "1.0.0",
    /* Other packages... */

    /*** ADD THIS START ***/
    "io.coherence.sdk": "1.0.0",
    /*** ADD THIS END ***/
        
    "com.unity.modules.ai": "1.0.0",
    "com.unity.modules.androidjni": "1.0.0",
    "com.unity.modules.animation": "1.0.0",
    "com.unity.modules.audio": "1.0.0",
    "com.unity.modules.imgui": "1.0.0",
    /* Other modules... */
    
  }, /* < add this comma if not already present */
  
  /*** ADD THIS SECTION START ***/
  "scopedRegistries": [
    {
      "name": "coherence",
      "url": "https://registry.npmjs.org",
      "scopes": [
        "io.coherence.sdk"
      ]
    }
  ]
  /*** ADD THIS SECTION END ***/
  
}
```

You will then see the package in the **Package Manager** under **My Registries**.

***

{% hint style="success" %}
When you successfully install the coherence SDK, after code compilation, you should see the Welcome window.
{% 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.coherence.io/getting-started/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.