Integrate PlayFab in Unity

Learn how to integrate PlayFab backend and Openfort with your game


PlayFab is a backend service provided by Microsoft for game developers, offering tools for live game management, all powered by Azure's cloud infrastructure.

In this integration, we use the Google Play Games plugin for Unity to handle authentication with PlayFab, ensuring a seamless and secure login experience for users on Android devices.

Once authenticaded we use PlayFab's user identity token to create a self-custodial account using Embedded Smart Accounts.

Moreover, by integrating the Openfort SDK into Azure Functions, we establish a seamless connection to PlayFab. Unity clients using the PlayFab Unity SDK can tap into these functions, accessing the full range of Openfort features within the game environment.

Application Workflow#

Integration workflow


Set up Openfort#

  1. Add PlayFab as a provider

    Add your PlayFab title and choose Save:

    PlayFab provider
  2. Add a Contract

    This sample requires a contract to run. We use 0x38090d1636069c0ff1Af6bc1737Fb996B7f63AC0 (NFT contract deployed in 80001 Mumbai). You can use this for the guide:

    Contract addition
  3. Add a Policy

    We aim to cover gas fees for users. Set a new gas policy:

    Policy details

    Now, add a rule so our contract uses this policy:

    Policy Rule

Deploy Azure Backend#

Open azure-backend with VS Code and sign in to Azure:

Azure backend image

Ensure your Function App (here, it's "openfort-playfab") is listed:

Function App image

In the terminal, run:

npm install

In the explorer, right-click on a function and select Deploy to Function App:

Select Function App1

Next, choose your Function App:

Select Function App2

Then, click on Deploy:

Deploy Confirmation

Navigate to your Azure Portal and open your Function App. You should see all the functions listed:

Functions List

Click on any function and select Get Function Url:

Get Function URL

Subsequently, add this URL (along with all others) to PlayFab to enable access to our Azure Functions from within PlayFab.

Set up PlayFab Title#

  1. Register Azure Functions

    Visit the PlayFab developer dashboard, choose your title, and click on Automation:

    Automation Selection

    Our functions are already registered. To do the same, click Register function and provide the function name along with its URL:

    Saving Automation

    Repeat this for all deployed functions.

  2. Install Google Add-on

    Navigate to Add-ons and choose Google:

    Google Add-on Selection

    Then, visit the Google Cloud APIs Credentials dashboard and click on the arrow icon next to your OAuth Web Application Client:

    OAuth Web Application Client

    Copy both the Client ID and Client Secret:

    PLayFab Auth 1

    Return to the PlayFab dashboard, paste these details into the Google OAuth Client ID and Google OAuth Client Secret fields, and click Install Google:

    PLayFab Auth 2
  3. Add PlayFab OAuth Redirect URL

    For this, go to the Google Cloud APIs Credentials dashboard. Here, select your Web application:

    Web Application Selection

    In the Authorized redirect URIs section, add the URL below and click Save:


    Authorized redirect URIs

Set up Azure Backend#

Our Azure backend requires environment variables from both PlayFab and Openfort. Let's configure them.

  1. Add Openfort Environment Variables

    After adding these, your configuration panel should resemble the following. Click Save:

    Azure Dev Dashboard 1
  2. Add PlayFab Environment Variables

    • Visit the PlayFab developer dashboard, select your title, and navigate to Settings wheel --> Title settings:

      Azure Dev Dashboard 2
    • In the API Features section, copy your Title ID:

      Azure API
    • Under Secret Keys, note down your Secret key:

      Azure Secret keys
    • Return to the Azure Portal and choose your Function App.

    • Under Configuration, select New application setting and input:

      • Name: PLAYFAB_TITLE_ID
      • Value: [Your Title ID]
    • Add another application setting:

      • Value: [Your Secret Key]

    Your configuration panel should now look like the following. Confirm your changes by clicking Save:

    Azure Config

Set up Unity Client#

This Unity sample project is already equipped with:

To begin, open unity-client with Unity:

  1. Configure PlayFab SDK

    • Navigate to the Project tab.
    • Search for PlayFabSharedSettings and input your PlayFab Title ID:
    Unity Client Config
  2. Configure Google Play Games SDK

    • Even if you've set up the Google Play Games SDK following the required tutorial, ensure that you've correctly configured all fields by navigating to Window --> Google Play Games --> Setup --> Android setup:

      Google Play Games Config 1
      Android Configuration

    By doing this, when the game runs on Android, it will utilize Google Play Games for user authentication via PlayFab. Otherwise, the default PlayFab authentication will be used.

Test in Editor#

Play Login scene, opt for Register, provide an email and password, then click Register again. This scene should appear:

Game Scene

Select Mint. After a brief period, you should see a representation of your newly minted NFT:

Minted NFT

In the Openfort Players dashboard, a new player entry should be visible. On selecting this player:

Player Entry

You'll notice that a mint transaction has been successfully processed:

Mint Transaction

Additionally, by choosing your Mumbai Account and viewing ERC-721 Token Txns, the transaction is further confirmed:

Account selection
Transaction Confirm 2

Test on Android#

Upon building and running the game on an Android device, the registration/login process is automated via Google Play Games, resulting in a streamlined user experience.

Extra: Guest Registration Functionality#

Guest registration functionality - Workflow diagram

Playing as a guest is a common way for players to authenticate to games, and all BaaS providers offer that functionality. The problem is that if the player has made some progress while playing as a guest, they will lose it for the next gaming session.

For this reason, we have introduced Guest registration functionality in Lost Dungeon, allowing players to authenticate as guests and register with an email and password at their convenience:

Guest registration functionality - Registration

When that happens, a new user is created in the BaaS (PlayFab in this case), and the Openfort player information associated with the guest user is transferred to the new user:

Guest registration functionality - Openfort info

This way, for the next session, the player can log in as the newly registered user and retain all the progress made while being a guest. Furthermore, they will now be able to enable self-custody and transfer all the progress (acquired blockchain assets) to a self-custodial account of their choice.


Upon completing the above steps, your Unity game will be fully integrated with Openfort and PlayFab. Always remember to test every feature before deploying to guarantee a flawless player experience.

Get support#

If you found a bug or want to suggest a new [feature/use case/sample], please file an issue.

If you have questions, comments, or need help with code, we're here to help: