> For the complete documentation index, see [llms.txt](https://stage-precision.gitbook.io/grid/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://stage-precision.gitbook.io/grid/unity-integration/getting-started/download-and-install.md).

# Download and install

Install SPNet for Unity in a new or existing Unity project on Windows or macOS.

#### Before you install

Use **Unity 6.6 (6000.6)** or higher with the **Universal Render Pipeline (URP) 17.6** or higher and **Render Graph** enabled.

The integration supports **Windows x64** and **macOS on Intel and Apple Silicon**.&#x20;

For a new project, choose the **Universal 3D** template in Unity Hub.

#### Download the package

1. Sign in to your Stage Precision account.
2. Open **Downloads** and download the **SPNet for Unity** ZIP archive.
3. Extract the ZIP archive to a permanent location accessible to your Unity project.
4. Open the folder matching your platform and processor. Use **win\_x64** for Windows, or the corresponding macOS folder for **Intel** or **Apple Silicon**.

Use the `.tgz` file inside the selected folder for installation through Unity's Package Manager.

The package filename includes its version, for example `com.stageprecision.spnet-1.0.0.tgz`. Keep this file intact for installation through Unity's Package Manager.

#### Install in Unity

1. Open your Unity project.
2. Open **Window → Package Management → Package Manager**.
3. Click the **+** button and choose **Install package from tarball**.
4. Select the downloaded SPNet `.tgz` file.
5. Wait for Unity to finish importing the package and resolving its dependencies.

<figure><img src="https://1380116828-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fc4nPw8BslCHXa7bL2mf8%2Fuploads%2FS5J8LJPUZ7zeoKm02rmV%2F5vKoCLisP3.gif?alt=media&amp;token=4fc446c7-6df6-452e-ab4f-fad3e2fa7472" alt=""><figcaption></figcaption></figure>

**SPNet for Unity** now appears in the Package Manager's package list.

<figure><img src="https://1380116828-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fc4nPw8BslCHXa7bL2mf8%2Fuploads%2FSCDr66uoH5IM38sR0xQD%2Fimage.png?alt=media&amp;token=2f745597-10ff-477b-b77f-f56a6c657aa3" alt=""><figcaption></figcaption></figure>

You can create SPNet objects from **GameObject → SPNet**, including through the Hierarchy's **+** and right-click menus.

<div align="left"><figure><img src="https://1380116828-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fc4nPw8BslCHXa7bL2mf8%2Fuploads%2FDIG8HmoeI9mvMj5t6r7A%2FPowerToys_8PovQ4JbiK.gif?alt=media&amp;token=3bff0c41-264d-4c1f-a7fb-6fbc8585c06c" alt="" width="415"><figcaption></figcaption></figure></div>

Components for existing objects are available under **Add Component → SPNet** in the Inspector.

<div align="left"><figure><img src="https://1380116828-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fc4nPw8BslCHXa7bL2mf8%2Fuploads%2F2Dk6oGCLGKcQBER9ECrD%2FPowerToys_gvXwEufvEB.gif?alt=media&amp;token=05823ce3-f438-4730-a657-92e2bbc0a5df" alt="" width="352"><figcaption></figcaption></figure></div>

#### Update an existing installation

1. Save your scene and exit Play mode.
2. Download the new package version.
3. Use **Install package from tarball** again and select the new `.tgz` file.
4. After the import finishes, close and reopen Unity.

Restarting Unity loads the updated native SPNet library.
