# UPM Tarball Installation

This guide applies to `core-igp-0.3.3.tgz` on Unity `2022.3`. The shorter artifact file name does not change the internal UPM package name, `cn.indiegp.sdk.unity`.

## Install

1. Open `Window > Package Manager`.
2. Open the `+` menu and choose `Add package from tarball`.
3. Select `core-igp-0.3.3.tgz`.
4. Wait for Unity to resolve `com.unity.nuget.newtonsoft-json` and compile the project.

The tarball contains the complete Core package. Multiplayer, Compliance, and Game Kit remain separate optional public packages.

For a manifest-based installation, keep the tarball at a stable path and add:

```json
"cn.indiegp.sdk.unity": "file:../LocalPackages/core-igp-0.3.3.tgz"
```

Commit both `Packages/manifest.json` and `Packages/packages-lock.json`. If the tarball is outside the project or source repository, other developers and clean CI agents must receive it at the same referenced path.

## Migrate From `.unitypackage`

Do not keep the legacy `Assets/IGP.UnitySDK` directory and this UPM package installed at the same time. Before switching:

1. Move user-owned `IGPConfig` assets, modified samples, and custom scripts out of `Assets/IGP.UnitySDK`.
2. Remove the legacy `Assets/IGP.UnitySDK` directory.
3. Install the UPM tarball at the same SDK version.
4. Confirm scenes and prefabs have no missing script references before upgrading the SDK version.

Create and bind configuration assets explicitly. The package does not scan or modify the consuming project's assets, scenes, prefabs, or project settings.
