Skip to content
IGP Developer Docs

GameMaker Installation

This page only covers how to install the SDK into your own GameMaker project. To complete the minimal validation flow first, start with GameMaker Quick Start.

Prerequisites

Section titled “Prerequisites”
  • GameMaker 2024.2 LTS or newer
  • Windows 10 or newer
  • IGP desktop client installed locally
  • An appId assigned by IGP operations

Download and extract the release package

Section titled “Download and extract the release package”

Download the version you want to use from Release Notes. The current GameMaker SDK version is 0.0.6, and its package file name is igp-gamemaker-sdk-0.0.6.zip. After extraction, the main paths you will use are:

  • adapters/gamemaker/runtime/igp_gms2_windows_runtime.gml - runtime script to add to your project
  • adapters/gamemaker/bridge/IGP.GamemakerDesktopBridge.Native.dll - native bridge DLL to add as an Included File
  • samples/gamemaker/windows-auth-achievements/ - official sample project and integration notes

Install into your own project

Section titled “Install into your own project”

1. Add the runtime script

Section titled “1. Add the runtime script”

Add adapters/gamemaker/runtime/igp_gms2_windows_runtime.gml to your project as a script resource.

It is recommended to keep the script name as igp_gms2_windows_runtime so later sample code can be copied directly.

2. Add the native bridge DLL

Section titled “2. Add the native bridge DLL”

Add adapters/gamemaker/bridge/IGP.GamemakerDesktopBridge.Native.dll to your project as an Included File.

Putting it under datafiles/ is recommended so GameMaker carries the DLL into the working directory at runtime.

3. Keep optional fields at their defaults

Section titled “3. Keep optional fields at their defaults”

For a normal first integration, only appId needs to be prepared.

These fields are currently debugging or special release overrides and usually should not be changed during the first pass:

  • desktop_auto_attach
  • desktop_pipe_endpoint
  • desktop_launch_command

The default behavior already is:

  • automatically attempt to attach to the local desktop client
  • auto-discover and launch the desktop client when the launch command is left empty

Verify the installation

Section titled “Verify the installation”

After installation, at minimum confirm:

  1. The project contains the igp_gms2_windows_runtime script resource
  2. Included Files contains IGP.GamemakerDesktopBridge.Native.dll
  3. Launching the project with F5 does not immediately fail because the script or DLL is missing

To validate the complete minimal flow, continue with GameMaker Quick Start.