Unity SDK
The Immutable SDK for Unity helps you integrate your game with Immutable Passport.
- Windows (64-bit) - Supports Mono builds. For IL2CPP, refer to this.
- macOS (minimum version 12.5)
- Android (minimum version 5.1)
- iOS (minimum version 15.2)
- WebGL
- Unity 2021.3 or newer for Windows, macOS, Android, iOS and WebGL.
- Unity 2019.4 or newer for macOS, Android, and iOS. Windows isn't supported on Unity versions from 2019.4 up through 2021.2.
We have added compilation flags to our Unity SDK to ensure that specific Unity editors can only build certain platform targets. Please note that the table below indicates which editor you can use to build a platform target, but it does not determine whether you can run the SDK in that editor.
For example, our SDK allows you to build iOS games using a macOS Unity Editor, but you cannot use the Windows Unity Editor.
- Target Platform: The platform you're building for
- Unity Editor Platform: The OS you're running the Unity Editor on
Target Platform | Windows | macOS | Android | iOS | WebGL |
---|---|---|---|---|---|
Windows Unity Editor | ✅ | ❌ | ✅ | ✅ | ✅ |
macOS Unity Editor | ❌ | ✅ | ✅ | ✅ | ✅ |
Installation
Install from a Git URL (Recommended)
Via UPM window
- Since
.dll
files are stored on Git Large File Storage, you must download and install git-lfs from here - Open the Package Manager
- Click the add + button and select "Add package from git URL..."
- Enter
https://github.com/immutable/unity-immutable-sdk.git?path=/src/Packages/Passport
and click 'Add'
Via manifest.json
- Since
.dll
files are stored on Git Large File Storage, you must download and install git-lfs from here - Open your project's
Packages/manifest.json
file - Add
"com.immutable.passport": "https://github.com/immutable/unity-immutable-sdk.git?path=/src/Packages/Passport"
in thedependencies
block
Install a specific version
To install a specific version of the SDK from a git URL, append '#' followed by the version tag. For example, https://github.com/immutable/unity-immutable-sdk.git?path=/src/Packages/Passport#v1.0.0
will add the Unity SDK version 1.0.0.
Install from a zip file
- Go to our Unity SDK GitHub Releases
- Click on the version you would like to install
- Download the
Immutable-Passport.zip
and extract the zip file - Open the Package Manager
- Click the add + button and select "Add package from disk..."
- Navigate to the Passport package root folder (
src/Packages/Passport
) - Double-click the
package.json
file
Install by cloning the repository
- Since
.dll
files are stored on Git Large File Storage, you must download and install git-lfs from here before cloning the repository - Clone the unity-immutable-sdk repository or download the zip/tarball from one of the versions here
- Open the Package Manager
- Click the add + button and select "Add package from disk..."
- Navigate to the Passport package root folder (
src/Packages/Passport
) - Double-click the
package.json
file
Dependencies
The Unity SDK requires UniTask package (version 2.3.3) as specified in package.json
.
How to install UniTask
Follow the instructions here.
If you encounter any conflicts, please check out Unity's guide here.
Packages
The Unity SDK consists of multiple packages:
Name | Description |
---|---|
Passport | The core package required to use the Unity SDK. It provides authentication, wallet creation functions, and enables interaction with the Immutable zkEVM. |
Orderbook | Provides a generated API client with functions to create, cancel, and execute orders. |
Examples
- Sample App - see the sample application for examples of how to use the Immutable Unity SDK.
- Sample Game - see the sample game tutorial on how to use the Immutable Unity SDK.
Further documentation
- See the Developer homepage for general information on building on Immutable.
- Build on Immutable zkEVM:
- Build on Immutable X: