# 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 %}