GDK Extension Guides

Back To Top

Quick Start Guide

You will initially need to set up your project for the GDK Extension to work properly. This guide covers all the aspects of your project that you will need to configure.

Project Setup

In order to build your project using the extension you need to import it and make some changes to your project:

1. Import the local package ( .yymps ) provided with the public release version.
2. Use the 64-bit Windows runtime. To change this go into Game Options → Windows → General and enable " Use x64 Windows Runtime ".
   
3. Also make sure you enable the "Copy exe to output folder" setting:
   
4. ✴️ COMPATIBILITY These steps are required only for older versions of the GameMaker:

• For GameMaker 2022.3 (or previous) : Also make sure you disable the subst from within the Preferences → General Settings → Compiling menu, otherwise this extension will not work:

• For GameMaker 2022.2 (or previous) : The extension comes with two .bat files: post_package_step.bat and post_run_step.bat (placed inside the extension's folder). These files need to be moved into your project's root folder, which is the same directory as your project's .yyp file:

After finishing this we'll set up the config file required for the Microsoft Store.

Sandbox Get/Set

When using Xbox Live features, you might need to change your PC sandboxes (see official documentation) so you can test those same features. For this purpose, you can run the GDK Command Line (under Start → All Apps → Microsoft GDK → Desktop VS 2018 Gaming Command Prompt) and use one of the following commands:

• XblPCSandbox /get (returns the current sandbox, default is RETAIL)
• XblPCSandbox <sandbox> (changes the sandbox, where <sandbox> refers to you sandbox name)
• XblPCSandbox RETAIL (sets the sandbox back to RETAIL)

Note

Sandbox names are case sensitive.

Config File

To build and run your project using the GDK Extension, it's necessary to set up and include a MicrosoftGame.Config file:

1. This config file can be created using Microsoft's MicrosoftGame Editor tool (for more information refer to its documentation page) or can be copied from the demo project and edited manually.
   

Note

The ExecutableList/Executable/Name property should be set to the value in GameOptions → Windows → Executable Name.

2. Add the MicrosoftGame.Config file to the Included Files of your project.
3. Depending on the image file names specified in the ShellVisuals tag you will need to add those to the Included Files **** as well.
   

Upon finishing this setup and following the Project Setup section above, you should be ready to run and test your project.

Manifest File

This step is not required unless you are using the Event Based Functions from the Xbox Live module (this requires enabling of Event-Based Stats on the Partner Center). If you are using the event based system from Xbox Live module you need provide GameMaker Studio 2 with some extra information about the statistics , events and leaderboards created on you Partner Center's dashboard. For this you need to do the following:

1. Log into your Partner Center account, open your game's configuration page and go into the Xbox Services → Gameplay Settings where you can define your stats.
   

2. From here you will need to select Player stats → Stat rules the drop-down menu at the top.
   

3. On the page that opens, click on the " Download published events manifest " button.
   

4. Add the downloaded file to your project's Included Files (/datafiles) folder.

After setting up this manifest file, you will be able to use event-based stats and leaderboards in your project.

Important

If you make any changes to your events on the Partner Center dashboard, you'll need to republish those changes and download a new manifest file.

---