Installation

Prerequisites

• Unity 6000.0 LTS or newer
• Build target set to iOS or Android — the SDK does not support Standalone, WebGL, or other platforms
• Registry token from your Tactile integration contact (for package access)
• PlayOps dashboard access to your project

1. Configure registry authentication

The PlayOps SDK and its dependencies are hosted on a private package registry. You need to configure authentication on your machine before Unity can download them.

1. Locate your Unity configuration file:

   macOS / Linux

   ~/.upmconfig.toml

   Windows

   %USERPROFILE%\.upmconfig.toml

2. Open (or create) the .upmconfig.toml file and add the following:

   [npmAuth."https://npm.pkg.github.com/@tactilegames"]
   token = "YOUR_TOKEN_HERE"

3. Replace YOUR_TOKEN_HERE with the registry token provided by Tactile.

Tip

Each developer on your team needs this file on their machine. The .upmconfig.toml file lives in your home directory, not inside your Unity project — it should never be committed to version control.

2. Add the scoped registry

Open Packages/manifest.json in your Unity project and add the Tactile Games scoped registry:

{
  "scopedRegistries": [
    {
      "name": "Tactile Games",
      "url": "https://npm.pkg.github.com/@tactilegames",
      "scopes": [
        "com.tactilegames"
      ]
    }
  ],
  "dependencies": {
    ...
  }
}

This tells Unity to resolve any package starting with com.tactilegames from the Tactile registry. All other packages continue to resolve from Unity’s default registry.

3. Install the SDK

Add the SDK to your dependencies in Packages/manifest.json:

{
  "dependencies": {
    "com.tactilegames.playops-sdk": "1.9.0"
  }
}

The latest SDK version is 1.9.0 — see the Releases — Changelog for the full history.

Unity will automatically resolve all transitive dependencies — no need to list them individually.

Note

After saving manifest.json, switch to the Unity Editor and wait for package resolution to complete. You will see a progress bar in the bottom-right corner. Your project will not compile until all packages are downloaded.

Alternatively, install via the Unity Editor:

1. Open Window > Package Manager.
2. Click the + button and choose Add package by name.
3. Enter com.tactilegames.playops-sdk and version 1.9.0.
4. Click Add.

4. Commit BillingMode.json (Android)

The SDK sells in-app purchases through Unity IAP. On Android, Unity IAP reads Assets/Resources/BillingMode.json at runtime to pick the store. Unity IAP creates the file the first time the project opens in the Editor:

{"androidStore":"GooglePlay"}

Commit this file to version control.

Caution

Without this file, Unity IAP falls back to its fake store. The app builds and runs, but no real purchase can be made. The SDK fails the Android build when the file is missing or androidStore is not GooglePlay.

5. Verify the installation

After Unity finishes importing:

1. Open Window > Package Manager.
2. Switch the filter to In Project.
3. You should see PlayOps SDK and its dependencies listed.

If you see authentication errors, double-check that:

• .upmconfig.toml exists in your home directory (not your project)
• The token is correct and has not expired
• The scopedRegistries entry is present in manifest.json

Next steps

Continue to the Quick Start to connect your project to the PlayOps dashboard and initialize the SDK.