Format:AGS game data file
| 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.