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)
• Service credentials from your Tactile integration contact:

Value	Description
cloudUrl	Base URL of your game’s PlayOps backend (e.g. https://my-game.tactilews.com)
gameSecret	UUID that uniquely identifies your game
analyticsAppId	Your analytics namespace (e.g. my-game-dev)

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.4.2"
  }
}

The latest SDK version is 1.4.2 — 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.4.2.
4. Click Add.

4. 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 initialize the SDK and make your first API call.