Windows Authorization and Achievements Sample

This first GameMaker sample for Windows 10 and later demonstrates game authorization, connection state, achievement unlock, and progress reporting.

Quick start (30 seconds)

1. Download the release package you want to use from Release Notes. The current file name is igp-gamemaker-sdk-0.0.6.zip. Extract it anywhere
2. Open samples/gamemaker/windows-auth-achievements/project/
3. Use GameMaker (2024.2 LTS or newer) to open IGP.WindowsAuthAchievements.yyp
4. Press F5 to run it
5. The status panel should show the current connection and authorization state. If the local IGP desktop client is already running, the connection should move to connected

Tip

You do not need to copy the DLL or GML manually. IGP.GamemakerDesktopBridge.Native.dll is already placed under project/datafiles/, and the runtime GML has already been added as script resources inside the sample project.

Caution

The sample project is preloaded with demo values: appId = 10, and the achievement keys are sample.windows.auth.unlock and sample.windows.auth.progress.

If you only want to confirm that the sample starts and runs, the default values are fine. If you want to see successful authorization and achievements for your own game, replace them with the appId assigned by IGP and achievements that already exist in the backend.

Included files

File	Purpose
project/IGP.WindowsAuthAchievements.yyp	Ready-to-open GameMaker project shell
project/datafiles/IGP.GamemakerDesktopBridge.Native.dll	Native bridge DLL
project/scripts/igp_gms2_windows_runtime/	Runtime GML synced from the official adapter
project/objects/obj_igp_windows_auth_achievements/	Sample object showing Create / Step / Draw wiring
igp_windows_auth_achievements_sample.gml	Sample controller functions
igp_windows_auth_achievements_view.gml	UI rendering helpers
INTEGRATION.md	Steps for integrating into your own project
SMOKE-CHECKLIST.md	Smoke-check checklist

What the sample demonstrates

• current game authorization state: pending / authorized_online / authorized_offline / failed / skipped
• current connection state: disconnected / connecting / connected / detached
• press F1 to trigger an achievement unlock
• press F2 to report 50% progress
• the latest result (success / operation) and latest error (code: message)

Next

This page mainly explains what ships in the sample package. If this is your first integration, this is the recommended reading order:

• GameMaker Installation
• GameMaker Quick Start
• GameMaker Debugging

The extracted directory also includes two integration-oriented documents:

• INTEGRATION.md - how to wire the bridge into your own GameMaker project
• SMOKE-CHECKLIST.md - smoke checks after integration