GameMaker Overview

The IGP GameMaker SDK integrates IGP game authorization, real-name verification and anti-addiction, and achievements into GameMaker games. The first release focuses on desktop client capabilities on Windows. Room features are not available yet.

This page only covers GameMaker-specific details. For feature-level integration steps, start with the relevant page under “Use the SDK by feature”.

Feature list

• Runtime lifecycle: initialize, update each frame, read a state snapshot, poll queued events, and shut down.
• Game authorization: verify at launch that the current player legitimately owns the game on IGP, returning states such as authorized_online and authorized_offline (protocol side: RequestGameAuthorization).
• Connection state: observe whether the local connection to the IGP desktop client is ready.
• Desktop client capabilities: check which features are available before calling them.
• Real-name verification and anti-addiction: read current state, refresh state, and receive anti_addiction_state_changed events.
• Achievement unlock: unlock an achievement by key.
• Achievement progress: report progress by key and increment.
• Event queue: receive connection, authorization, anti-addiction, achievement, error, and detached events through one polling path.

Not supported yet

• Multiplayer rooms (create / join / ready / realtime / state / RPC)
• macOS / Linux / console / mobile targets
• Other GameMaker targets beyond the current Windows runtime path

Prerequisites

• GameMaker 2024.2 LTS or newer
• Windows 10 or newer
• IGP desktop client installed locally
• An appId assigned by IGP operations

Delivery format

The GameMaker adapter ships as a zip package. After extraction it includes:

• IGP.GamemakerDesktopBridge.Native.dll - native bridge library for Windows
• GML runtime scripts - wrappers that expose the bridge C API to GameMaker
• windows-auth-achievements sample project - directly openable in GameMaker
• INTEGRATION.md and SMOKE-CHECKLIST.md - integration and smoke-check instructions

Current versions and download links are listed in Release Notes.

Start integrating

1. Read GameMaker Installation
2. Complete the minimal validation flow: GameMaker Quick Start
3. Confirm the base flow: Startup and connection
4. Continue with the target feature:
   • Game authorization
   • Real-name verification and anti-addiction
   • Achievements
5. Complete full checks: Testing
6. To troubleshoot state and errors: GameMaker Debugging
7. To inspect exported functions and lower-level boundaries: GameMaker Native Bridge
8. To review the sample project and package layout: Windows Authorization and Achievements Sample

Trademark and copyright notice

This page and the IGP GameMaker SDK are not sponsored by or affiliated with YoYo Games, GameMaker, or Opera, and do not imply endorsement by those parties.

GameMaker, GameMaker logos, and related brand assets are owned by YoYo Games / Opera and their affiliates. Use of GameMaker names, logos, and brand assets should follow the GameMaker brand guidelines.