Jump to content
Setting up an AI agent? ReverseEngineering.wiki skill (works from the command line, no configuration): https://reverseengineering.wiki/skill/rewiki/SKILL.md · setup for every client, including MCP: https://reverseengineering.wiki/llms.txt · REWiki:Connect

Library:GameMaker

From ReverseEngineering.wiki
Library
On this wiki Facts · Code · Notes · Topics

YoYo Games' 2D game engine (Game Maker, GameMaker: Studio, GameMaker Studio 2, GameMaker). Games ship a runner executable plus a data.win (Windows) or game.ios/game.droid/game.unx file in the IFF-style FORM format, holding all sprites, objects, rooms, strings and GML bytecode (or an empty CODE chunk when compiled with YYC).

Overview

A GameMaker game is a small runner executable plus one data file: data.win on Windows, game.ios on iOS and tvOS, game.droid on Android, game.unx on Linux, game.wad in old builds. Assets and GML code are all inside it; see Format:GameMaker data file for the layout.

Identification

  • The data file starts with FORM; the first chunk is GEN8.
  • GEN8 holds the bytecode (WAD) version, the project name, config name and a GameMaker runtime version.
  • Bytecode versions 13 to 17 are the ones UndertaleModTool fully supports; the version stays at 17 for GameMaker Studio 2, so later releases are told apart by structural checks (2.3, 2022.x, 2023.x, 2024.x ...).
  • A game built with YYC (YoYo Compiler) has a CODE chunk of length 0; the GML became native code in the runner and only the data file's assets are usable.

Tools

  • UndertaleModTool (GPL-3.0) reads and writes the file and decompiles GML with its Underanalyzer component; see the linked repository.

Unverified leads

  • Unverified: the exact runtime release that introduced each structural change is encoded in UndertaleModLib as version checks (IsVersionAtLeast(year, minor)); search the repository for those calls before relying on a version number from a game's own about box.

Code & repositories

  • https://github.com/UnderminersTeam/UndertaleModTool @ f43e12c445c37d50dc6244caa12ccab232983f3f · license: GPL-3.0-only (declared by the contributor; GitHub's detector did not recognize LICENSE.txt)
    UndertaleModTool: C# library and GUI that reads and writes GameMaker data.win (chunk layouts, bytecode 13-17, GMS2 version detection) and decompiles GML.
    Tested on: source read, not run: source read only · checked 2026-10-18