Get started with Platform Toolkit for GDK
Use the following steps to set up your Unity project for Microsoft GDK with the Platform Toolkit package.
Note
At the time of release, Platform Toolkit was tested for compatibility with GDK version 250400 (10.0.26100.4020).
1. Install the required packages
Install the following required packages. For information on installing packages with Unity, refer to Package management with the Package Manager window.
- com.unity.platformtoolkit package
- com.unity.platformtoolkit.gdk package
- com.unity.microsoft.gdk.tools
The following Unity Xbox packages are also required if developing for Xbox consoles:
- com.unity.microsoft.gdk.tools.xbox
If you intend to build your application for Xbox consoles, you must install the specific closed platform modules. For information on developing for consoles, refer to Game development for console platforms.
2. Configure active build target associations
- In the Unity Editor window, navigate to Edit > Project Settings > Platform Toolkit.
- Under the GDK section, select the build targets you want to associate with GDK services.
3. Link your Partner Center project with a Unity project
- Make sure you have a Partner Center project created or create a new one following the Create a Partner Center project guide.
- Create a GDK Settings asset and a Microsoft Game Config asset in the Unity Editor using the Microsoft GDK Tools package. For more information, refer to Create GDK settings.
- Copy the
Title ID,SCIDandMSA App IDfrom the Partner Center project to the Microsoft Game Config asset in Unity. These values can be found in the Partner Center project on the Xbox settings page.
4. Add achievements
- Set up achievements in the Partner Center project by following the Configuring title-managed Achievements in Partner Center guide.
Note
Platform Toolkit only supports title managed achievements.
- In the Unity Editor, open the Achievement Editor window by selecting Window > Platform Toolkit > Achievement Editor.
- In the GDK column of the Achievement Editor, add achievement IDs that match the IDs in the Partner Center. IDs can be found in the Partner Center Gameplay Settings page, under the Achievements tab.