Skip to content

YoYoGames/GDKExtension

Repository files navigation

GameMaker Studio 2 - GDK Extension

An Extension for GameMaker Studio 2 (GMS2) that gives GMS2 Windows Target support for the GDK allowing them to be released on the Microsoft Store and use XBox Live functionality (for those developers that have access through id@xbox, see this link for more information on id@xbox).

For more information on how to use the GDK Extension check our tech blog and for extra details on configuring the Partner Center check out our zendesk article.

Warning

Only Windows x64 Target is supported by the GDK. Also make sure the - ✅Copy exe to output folder - is selected from the Game Options -> Windows tab.


Contents of this repository

This repository contains the source code for the DLL that implements the GDK functionality that is exposed to GameMaker games, it is written in C++. It also contains an example GMS2 project that contains the extension definition and illustrates how to use the extension.


Building this Extension

  1. Install Visual Studio 2022
  2. Install GDK Jun23
  3. Install CMAKE
  4. Clone this repository or download the package

Note

The repository has submodules that you should initialise. If you opt to use the release package the modules are already included.

  1. Open the Visual Studio 2022

  2. Open the Solution in <project_root>/extensions/GDKExtension/gdkextension_windows/GDKExtension.sln

  3. Go to - Project Properties → C/C++ → General → Additional Include Directories - and change the path there to:

    • C:\ProgramData\GameMakerStudio2\Cache\runtimes\<current-runtime>\yyc\include\
  4. Select solution platform - Gaming.Desktop.x64

  5. Select solution configuration - Release or Debug

  6. Build

Tip

After building the output .dll will be copied into the extension folder.


Documentation

The online documentation is regularly updated to ensure it contains the most current information. For those who prefer a different format, we also offer a PDF version. This HTML is directly converted from the GitHub Wiki content, ensuring consistency, although it may follow slightly behind in updates.

We encourage users to refer primarily to the GitHub Wiki for the latest information and updates. The PDF version, included with the extension and within the demo project's data files, serves as a secondary, static reference.