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

Format:AGS game data file

From ReverseEngineering.wiki
Format
Magic Adventure Creator Game File v2
Endianness little
On this wiki Facts · Code · Notes · Topics

The compiled main game file of an Adventure Game Studio game (game28.dta, or ac2game.dta in 2.x games): it begins with the 30-byte text "Adventure Creator Game File v2" and an int32 data format version, followed (from 2.30) by the name of the AGS version that compiled it.

Identification

The file is an asset inside an AGS library (Format:AGS asset library), named game28.dta for 3.x games and ac2game.dta for 2.x games. OpenMainGameFileBase (Common/game/main_game_file.cpp lines 161-197 at 01cc4c3) reads the signature, an int32 data version, and, when the version is at least the 2.30 value (12), a string read by StrUtil::ReadString (int32 length, then that many characters) naming the tool the game was compiled with. Versions below 18 (2.50) are rejected as too old, versions above the engine's current one are rejected as not supported.

Data version numbers

The values are listed in Fact:AGS game data file/enum/GameDataVersion (Common/ac/game_version.h). Up to 3.5.0 they are small sequential integers (18 for 2.5.0, 50 for 3.5.0.8); from 3.6.0 the value is the AGS version written as NNNNNNN, for example 3060315 for 3.6.3.15. Two values are not stored in files but derived from the compiled-with string: 3050100 (3.5.1) and 3060207 (3.6.2.7).

Capabilities list

From data version 48 (3.4.1) on, an int32 count and that many strings follow, naming extended engine capabilities the game requires; they exist so alternate game formats can identify themselves.

Code & repositories

  • https://github.com/adventuregamestudio/ags @ 01cc4c3dafea4a5fc5804d887ca21975f738ce4e · license: Artistic-2.0 (declared by the contributor; GitHub's detector did not recognize License.txt)
    AGS engine and editor source: Common/ac/game_version.h, Common/game/main_game_file.cpp, Common/data/multifilelib.cpp, Common/game/room_version.h and room_file.cpp.
    Tested on: source read, not run · checked 2026-10-19; last activity 2026-10-19; Note: the latest release ships binaries; the wiki links only the source, never the binaries

Open questions

Unverified: the layout of the rest of the file (GameSetupStructBase and later) was not read for this page.