How to Install SDKs for Unity Using Thirdweb (plus some alternatives)

Written By Francois Robinson

One of the most powerful tools for integrating blockchain functionality into Unity games is Thirdweb’s Unity SDK. This guide will walk you through installing the Thirdweb SDK in Unity, ensuring you can add features like wallet connections, NFT interactions, and smart contracts to your games. We’ll also explore alternative SDKs to give you options based on your project needs. Let’s get started!

Why Use Thirdweb for Unity?

Thirdweb’s Unity SDK is a top choice for web3 game developers. It supports EVM-compatible blockchains, offers seamless wallet integration (e.g., MetaMask, WalletConnect), and provides features like gasless transactions and account abstraction. It’s open-source, easy to update, and includes prefabs like the Connect Wallet button to simplify development. Whether you’re building a blockchain RPG or an endless runner, Thirdweb can streamline your workflow.

Step-by-Step Guide to Install Thirdweb SDK in Unity

Step 1: Set Up Unity and Prerequisites

Before installing the SDK, ensure your Unity environment is ready:

  • Install Unity Hub and Editor: Download the Unity Hub from Unity’s official website and install the latest Unity Editor (2021 LTS or later is recommended for compatibility).

  • Create a New Project: Open Unity Hub, click Create New Project, select a 3D or 2D template, name your project, and click Create Project.

  • Install Dependencies: If you’re using Visual Studio Code, follow Unity’s guide for .NET setup to enable IntelliSense and better coding support.

Step 2: Download the Thirdweb Unity SDK

Thirdweb distributes its Unity SDK as a .unitypackage file, available on their GitHub releases page:

Step 3: Import the SDK into Unity

With the .unitypackage downloaded, import it into your Unity project:

  • In Unity, go to Assets > Import Package > Custom Package.

  • Select the downloaded .unitypackage file and click Open.

  • In the Import Unity Package menu, leave all options selected (unless you already have dependencies like Newtonsoft.Json or EDM4U installed, in which case deselect them to avoid conflicts).

  • Click Import to add the SDK to your project.

Step 4: Configure the SDK

Thirdweb provides a simple setup process using a prefab:

  • After importing, locate the ThirdwebManager prefab in the Project window (usually under Assets/Thirdweb).

  • Drag the ThirdwebManager prefab into your scene to initialize the SDK.

  • If you’re using WalletConnect, customize your WalletConnect Project ID by editing Assets/Thirdweb/Plugins/WalletConnectUnity/Resources/WalletConnectProjectConfig.asset.

Step 5: Test the SDK with a Demo Scene

Thirdweb includes a demo scene to help you explore its features:

  • In the Scenes folder, double-click ThirdwebDemoScene.unity to open it.

  • Explore the scene’s Canvas and review the ThirdwebSDKDemos.cs script to understand how to initialize the SDK, connect wallets, and interact with smart contracts.

  • To test, you’ll need to build for WebGL since the Unity preview isn’t supported out of the box.

Step 6: Build and Run for WebGL

To test your game in a browser (necessary for web3 functionality):

  • Go to File > Build Settings.

  • Select WebGL as the platform and click Switch Platform.

  • In Player Settings > Resolution and Presentation, set the WebGL Template to Thirdweb.

  • Disable Auto Graphics API if needed, add your scene to Scenes in Build, and click Build and Run.

  • Create a build folder, and Unity will launch your game in a browser, allowing you to connect a wallet and test blockchain interactions.

Alternatives to Thirdweb for Unity SDKs

While Thirdweb is excellent for web3 integration, other SDKs might better suit your needs depending on your game’s focus. Here are two alternatives:

Moralis

Moralis offers a robust platform for web3 development with Unity support, focusing on blockchain data, wallet authentication, and NFT APIs. It’s a good alternative if you need deeper analytics or prefer a more modular approach:

  • Installation: Download the Moralis Unity SDK from their official website, import the package into Unity, and follow their setup guide to initialize the SDK with an API key.

  • Pros: Strong backend support, real-time blockchain data, and cross-chain compatibility.

  • Cons: Steeper learning curve for beginners compared to Thirdweb’s prefabs.

Firebase

Firebase is a great choice for web2 games or if you need robust backend services like analytics, cloud functions, or real-time databases, with some web3 potential through custom integrations:

  • Installation: Download the Firebase Unity SDK from the Firebase console, unzip it, and import the desired packages (e.g., FirebaseAnalytics.unitypackage) via Assets > Import Package > Custom Package. Follow Firebase’s setup guide to link your project.

  • Pros: Excellent for analytics, push notifications, and cross-platform support (Unity 2021 LTS or later recommended).

  • Cons: Limited native web3 support; you’d need to build custom blockchain integrations.

Tips for a Smooth SDK Integration

  • Version Control: Use Git to manage your project and avoid conflicts when importing SDKs.

  • Test Early: Build and test frequently to catch compatibility issues, especially with web3 features.

  • Community Support: Join Thirdweb’s Discord for help with integration challenges.

  • Documentation: Refer to the Thirdweb Unity SDK Documentation for detailed API references and guides.

Need Help Installing The SDK?

Shoot us a message here or contact our founder Hanz on X! We’d be happy to help with the integration!

Francois Robinson
Next

The Costs of Building a Video Game