******************************************************************************* * WarCraft III Replay file format description * * * * document version: 1.18 * * document date : 2007-06-26 * * document authors: blue, nagger * * * * For more informtion about w3g file format, please visit: * * http://w3g.deepnode.de * * * * Check out the developer forum on: * * http://shadowflare.samods.org * * or contact us via mail * * mailto:w3g_format@deepnode.de * * * ******************************************************************************* =============================================================================== Table of Content =============================================================================== 1.0 Introduction 2.0 [Header] 2.1 [SubHeader] for header version 0 2.2 [SubHeader] for header version 1 2.3 Version information 2.4 WarCraft III The Frozen Throne beta replay information 3.0 [Data block header] 4.0 [Decompressed data] 4.1 [PlayerRecord] 4.2 [GameName] 4.3 [EncodedString] 4.4 [GameSettings] 4.5 [Map&CreatorName] 4.6 [PlayerCount] 4.7 [GameType] 4.8 [LanguageID] 4.9 [PlayerList] 4.10 [GameStartRecord] 4.11 [SlotRecord] 4.12 [RandomSeed] 5.0 [ReplayData] 6.0 General notes 6.1 Notes on official Blizzard Replays 7.0 Credits 8.0 Document revision history =============================================================================== DISCLAIMER (please read it ...) =============================================================================== All information in this document was solely obtained by looking at the replay file and guessing the meaning of each single field. All knowledge about the games mechanics is based on experience obtained by playing the game. Neither reverse engineering was used nor any copyrighted files modified. It is explicitly prohibited to use the information provided in this document for any illegal activities including hacking, cheating and pirating. Thank you Blizzard for your great games and a quite straight-forward WarCraft III replay file format ;-) The use of the information provided in this document is free of charge as long as you follow the rules above. Furthermore you may copy it freely as long as the file is unchanged (please mail us about any error or addition - we like to keep things centralized). We would really appreciate it if you credit us in your project or drop us a line via mail - because we like to know if the work put into this document was anything worth after all ;-) =============================================================================== 1.0 Introduction =============================================================================== An important word ahead. The information in this document is addressed to developers who want to create programs, tools and websites that help to enrich the gaming experience for the *whole* WarCraft III community. We absolutely do not tolerate hacks and cheats. Therefore you MUST NOT use the information provided in this document for any of these purposes. This file is meant to contain a description of the replay format itself. Additional notes and explanations on single fields and/or algorithms will (eventually) be moved to a seperate file ("w3g_notes.txt") some day. The whole file is still under construction. The meaning of some fields is still unknown and "known" fields might be wrong. Please contact us if you figure out any unknown values or find a replay that simply does not conform with the description of a "known" field. Convention: ----------- Sections directly related to data stored in the replay file are written in square brackets []. =============================================================================== 2.0 [Header] =============================================================================== The replay file consist of a header followed by a variable number of compressed data blocks. The header has the following format: offset | size/type | Description -------+-----------+----------------------------------------------------------- 0x0000 | 28 chars | zero terminated string "Warcraft III recorded game\0x1A\0" 0x001c | 1 dword | fileoffset of first compressed data block (header size) | | 0x40 for WarCraft III with patch <= v1.06 | | 0x44 for WarCraft III patch >= 1.07 and TFT replays 0x0020 | 1 dword | overall size of compressed file 0x0024 | 1 dword | replay header version: | | 0x00 for WarCraft III with patch <= 1.06 | | 0x01 for WarCraft III patch >= 1.07 and TFT replays 0x0028 | 1 dword | overall size of decompressed data (excluding header) 0x002c | 1 dword | number of compressed data blocks in file 0x0030 | n bytes | SubHeader (see section 2.1 and 2.2) The size of the header excluding the subheader is 0x30 bytes so far. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 2.1 [SubHeader] for header version 0 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - This header was used for all replays saved with WarCraft III patch version v1.06 and below. offset | size/type | Description -------+-----------+----------------------------------------------------------- 0x0000 | 1 word | unknown (always zero so far) 0x0002 | 1 word | version number (corresponds to patch 1.xx) 0x0004 | 1 word | build number (see section 2.3) 0x0006 | 1 word | flags | | 0x0000 for single player games | | 0x8000 for multiplayer games (LAN or Battle.net) 0x0008 | 1 dword | replay length in msec 0x000C | 1 dword | CRC32 checksum for the header | | (the checksum is calculated for the complete header | | including this field which is set to zero) Overall header size for version 0 is 0x40 bytes. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 2.2 [SubHeader] for header version 1 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - This header is used for all replays saved with WarCraft III patch version v1.07 and above. offset | size/type | Description -------+-----------+----------------------------------------------------------- 0x0000 | 1 dword | version identifier string reading: | | 'WAR3' for WarCraft III Classic | | 'W3XP' for WarCraft III Expansion Set 'The Frozen Throne' | | (note that this string is saved in little endian format | | in the replay file) 0x0004 | 1 dword | version number (corresponds to patch 1.xx so far) 0x0008 | 1 word | build number (see section 2.3) 0x000A | 1 word | flags | | 0x0000 for single player games | | 0x8000 for multiplayer games (LAN or Battle.net) 0x000C | 1 dword | replay length in msec 0x0010 | 1 dword | CRC32 checksum for the header | | (the checksum is calculated for the complete header | | including this field which is set to zero) Overall header size for version 1 is 0x44 bytes. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 2.3 Version information - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - game version | version in replay | version of war3.exe | release date --------------+-------------------+---------------------+---------------- 1.00 | 1.00.4448 | 1.0. 0.4448 | 2002-07-03 1.01 | 1.01.4482 | 1.0. 1.4482 | 2002-07-05 1.01b | 1.01.4482 | 1.0. 1.4483 | 2002-07-10 1.01c | 1.01.4482 | ? | 2002-07-28 1.02 | 1.02.4531 | 1.0. 1.4531 | 2002-08-15 1.02a | 1.02.4531 | 1.0. 1.4563 | 2002-09-06 1.03 | 1.03.4572 | 1.0. 3.4653 | 2002-10-09 1.04 | 1.04.4654 | 1.0. 3.4709 | 2002-11-04 1.04b | 1.04.4654 | 1.0. 3.4709 | 2002-11-07 1.04c | 1.04.4654 | 1.0. 4.4905 | 2003-01-30 1.05 | 1.05.4654 | 1.0. 5.4944 | 2003-01-30 1.06 | 1.06.4656 | 1.0. 6.5551 | 2003-06-03 1.07 | 1.07.6031 | 1.0. 7.5535 | 2003-07-01 1.10 | 1.10.6034 | 1.0.10.5610 | 2003-06-30 1.11 | 1.11.6035 | 1.0.11.5616 | 2003-07-15 1.12 | 1.12.6036 | 1.0.12.5636 | 2003-07-31 1.13 | 1.13.6037 | 1.0.13.5816 | 2003-12-16 1.13b | 1.13.6037 | 1.0.13.5818 | 2003-12-19 1.14 | 1.14.6039 | 1.0.14.5840 | 2004-01-07 1.14b | 1.14.6040 | 1.0.14.5846 | 2004-01-10 1.15 | 1.15.6043 | 1.0.15.5917 | 2004-04-14 1.16 | 1.16.6046 | 1.0.16.5926 | 2004-05-10 1.17 | 1.17.6050 | 1.0.17.5988 | 2004-09-20 1.18 | 1.18.6051 | 1.0.18.6030 | 2005-03-01 1.19 | 1.19.6052 | 1.0.19.6041 | 2005-09-19 1.19b | 1.19.6052 | 1.0.19.6046 | 2005-09-21 1.20 | 1.20.6052 | 1.0.20.6048 | 2005-10-03 1.20b | 1.20.6052 | 1.0.20.6056 | 2005-12-12 1.20c | 1.20.6052 | 1.20.2.6065 | 2006-01-09 1.20d | 1.20.6052 | 1.20.3.6070 | 2006-04-12 1.20e | 1.20.6052 | 1.20.4.6074 | 2006-06-22 1.21 | 1.21.6052 | 1.21.0.6263 | 2007-01-23 1.21b | 1.21.6052 | 1.21.1.6300 | 2008-02-06 Notes on specific patches: o The mpq file for patch 1.02a is named 1.02c. o Patch 1.04b was only available as standalone patch (not on bnet) and solely adds a new copy protection to war3.exe. o The minor version number of the 'war3.exe' is wrong for patches 1.02, 1.02a, 1.04, 1.04b. o Blizzard released no standalone versions of the patches: 1.01c, 1.04c, 1.10. o Replays of patch 1.14 and 1.14b are incompatible General notes: o There are no differences in replays between minor versions (except for patch 1.14 and 1.14b). o Check the file properties of the existing war3.exe to get the current installed version of Warcraft III (see column 3). o There are no differences in version and build numbers between RoC and TFT. o There are no differences between various language versions. o You can identify the replay version of the installed game by extracting the 'product version number' from the version resource of the 'war3.exe'. o You can identify the version of the 'war3.exe' by extracting the 'file version number' from the version resource of the file. o On early patches build number of replays and 'war3.exe' are equal. Later on they differ. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 2.4 WarCraft III The Frozen Throne beta replay information - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 2.4.1 Beta for Frozen Throne retail (version 1.07) -------------------------------------------------- Beta replays are similar to RoC / final TFT replays. Here comes a list of version numbers, header version and build numbers: version | subheader version | build# | release date --------+-------------------+--------+-------------- 301 | version 0 | 6010 | 2003-03-04 302 | version 0 | 6011 | 2003-03-11 303 | version 0 | 6012 | 2003-03-14 304 | version 0 | 6013 | 2003-03-19 304a | version 0 | 6013 | 2003-03-24 305 | version 1(*) | 6015 | 2003-03-28 305a | version 1(*) | 6016 | 2003-03-30 306 | version 1 | 6018 | 2003-04-08 307 | version 1 | 6019 | 2003-04-11 308 | version 1 | 6021 | 2003-04-16 309 | version 1 | 6022 | 2003-04-17 310 | version 1 | 6023 | 2003-04-24 311 | version 1 | 6027 | 2003-04-30 312 | version 1 | 6030 | 2003-05-13 313 | version 1 | 6031 | 2003-05-19 314 | version 1 | 6034 | 2003-05-30 314a | version 1 | 6034 | 2003-06-02 315 | version 1 | 6034 | 2003-06-10 (*) Patch 305 and 305a still use the old V0 GameVersion scheme (2 words). Notes: o 313 replays might be convertable to FT retail 1.07 replays. o 315 replays might be convertable to FT retail 1.10/1.11 replays. 2.4.1 Beta versions of various patches -------------------------------------- These patches were only distributed through the 'Westfall' gateway. game | version | version | date | version | in replay | of war3.exe | of release | beta for ---------+--------------+-----------------+--------------+---------------- 1.15 | 1. 15.6041 | 1.0.15.5900 | 2004-04-16 | patch 1.15 1.401 | 1.401.6042 | 401.0. 0.5911 | 2004-04-22 | patch 1.15 1.402 | | | 2004-04-24 | patch 1.15 1.403 | | | 2004-06-23 | Ladder XP 1.404 | | | 2004-08-14 | patch 1.17 1.405 | | | 2004-08-19 | patch 1.17 1.406 | | | 2004-08-31 | patch 1.17 =============================================================================== 3.0 [Data block header] =============================================================================== Each compressed data block consists of a header followed by compressed data. The first data block starts at the address denoted in the replay file header. All following addresses are relative to the start of the data block header. The decompressed data blocks append to a single continueous data stream (disregarding the block headers). The content of this stream (see section 4) is completely independent of the original block boundaries. offset | size/type | Description -------+-----------+----------------------------------------------------------- 0x0000 | 1 word | size n of compressed data block (excluding header) 0x0002 | 1 word | size of decompressed data block (currently 8k) 0x0004 | 1 dword | unknown (probably checksum) 0x0008 | n bytes | compressed data (decompress using zlib) To decompress one block with zlib: 1. call 'inflate_init' 2. call 'inflate' with Z_SYNC_FLUSH for the block The last block is padded with 0 bytes up to the 8K border. These bytes can be disregarded. //TODO: add decompression details and move explanation to seperate file =============================================================================== 4.0 [Decompressed data] =============================================================================== Decompressed data is a collection of data items that appear back to back in the stream. The offsets for these items vary depending on the size of every single item. This section describes the records that always appear at the beginning of a replay data stream. They hold information about settings and players right before the start of the game. Data about the game in progress is described in section 5. The order of the start up items is as follows: # | Size | Name ---+----------+-------------------------- 1 | 4 byte | Unknown (0x00000110 - another record id?) 2 | variable | PlayerRecord (see 4.1) 3 | variable | GameName (null terminated string) (see 4.2) 4 | 1 byte | Nullbyte 5 | variable | Encoded String (null terminated) (see 4.3) | | - GameSettings (see 4.4) | | - Map&CreatorName (see 4.5) 6 | 4 byte | PlayerCount (see 4.6) 7 | 4 byte | GameType (see 4.7) 8 | 4 byte | LanguageID (see 4.8) 9 | variable | PlayerList (see 4.9) 10 | variable | GameStartRecord (see 4.11) The following sections describe these items in detail. After the static items (as described above) there follow variable information organized in blocks that are described in section 5. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 4.1 [PlayerRecord] - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - offset | size/type | Description -------+-----------+----------------------------------------------------------- 0x0000 | 1 byte | RecordID: | | 0x00 for game host | | 0x16 for additional players (see 4.9) 0x0001 | 1 byte | PlayerID 0x0002 | n bytes | PlayerName (null terminated string) n+2 | 1 byte | size of additional data: | | 0x01 = custom | | 0x08 = ladder Depending on the game type one of these records follows: o For custom games: offset | size/type | Description -------+-----------+--------------------------------------------------------- 0x0000 | 1 byte | null byte (1 byte) o For ladder games: offset | size/type | Description -------+-----------+--------------------------------------------------------- 0x0000 | 4 bytes | runtime of players Warcraft.exe in milliseconds 0x0004 | 4 bytes | player race flags: | | 0x01=human | | 0x02=orc | | 0x04=nightelf | | 0x08=undead | | (0x10=daemon) | | 0x20=random | | 0x40=race selectable/fixed (see notes in section 4.11) - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 4.2 [GameName] - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - This is a plain null terminated string reading the name of the game. Only in custom battle.net games you can name your game, otherwise the name is fixed: o For ladder games it reads "BNet". o For custom LAN games it holds a localized string including the game creators player name. Examples: a game created by the player 'Blue' results in: "Blue's game" for the english version of Warcraft III "Spiel von Blue" for the german version o For custom single player games it holds a localized fixed string. "local game" for the english version "Lokales Spiel" for the german version o Following is a list for all localized strings (encoded in plain ASCII) used by WarCraft III patch version 1.06 and earlier (see war3.mpq\UI\FrameDef\GlobalStrings.fdf: GAMENAME, LOCAL_GAME): English : "%s's Game" : "local game" Czech (1029): "Hra %s" : "Místní hra" German (1031): "Spiel von %s" : "Lokales Spiel" Spanish (1034): "Partida de %s" : "Partida local" French (1036): "Partie de %s" : "Partie locale" Italian (1040): "Partita di %s" : "Partita locale" Polish (1045): "Gra (%s)" : "Gra lokalna" %s denotes the game creators player name. o The following list shows all localized strings (encoded in plain ASCII) used by WarCraft III patch version 1.07 and later (see war3.mpq\UI\FrameDef\GlobalStrings.fdf: GAMENAME, LOCAL_GAME): German (1031): "Lokales Spiel (%s)" : "Lokales Spiel" %s denotes the game creators player name. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 4.3 [Encoded String] - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - There are the GameSetting and three null-terminated strings here back-to-back, all encoded into a single null terminated string. (But we don't know the reason for this encoding!) Every even byte-value was incremented by 1. So all encoded bytes are odd. A control-byte stores the transformations for the next 7 bytes. Since all NullBytes were transformed to 1, they will never occure inside the encoded string. But a NullByte marks the end of the encoded string. The encoded string starts with a control byte. The control byte holds a bitfield with one bit for each byte of the next 7 bytes block. Bit 1 (not Bit 0) corresponds to the following byte right after the control-byte, bit 2 to the next, and so on. Only Bit 1-7 contribute to encoded string. Bit 0 is unused and always set. Decoding these bytes works as follows: If the corresponding bit is a '1' then the character is moved over directly. If the corresponding bit is a '0' then subtract 1 from the character. After a control-byte and the belonging 7 bytes follows a new control-byte until you find a NULL character in the stream. Example decompression code (in 'C'): char* EncodedString; char* DecodedString; char mask; int pos=0; int dpos=0; while (EncodedString[pos] != 0) { if (pos%8 == 0) mask=EncodedString[pos]; else { if ((mask & (0x1 << (pos%8))) == 0) DecodedString[dpos++] = EncodedString[pos] - 1; else DecodedString[dpos++] = EncodedString[pos]; } pos++; } Alternatively one could interprete the encoding scheme as follow: Bit 0 of every character was moved to the control byte and set to 1 afterwards. TODO: Maybe this gives a simpler decoding algorithm. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 4.4 [GameSettings] - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - Make sure you have decoded the GameSettings (see 4.3). The game settings (extended options on create game screen) are packed using various flags distributed over 13 bytes. For details about the single options read the file "support/Readme/(PC)UIMainMenus.html" in your WarCraft III installation directory. Denoted below are only nonzero flags. offset | bitnr | Description -------+-------+--------------------------------------------------------------- 0x0000 | 0,1 | Game Speed: 0 = slow, 1 = normal, 2 = fast, 3 = unused -------+-------+--------------------------------------------------------------- 0x0001 | 0 | Visibility: 'hide terrain' | 1 | Visibility: 'map explored' | 2 | Visibility: 'always visible' (no fog of war) | 3 | Visibility: 'default' | 4,5 | Observer : 0 = off or 'Referees' (see 0x0003 Bit6) | | 1 = unused | | 2 = 'Obs on Defeat' | | 3 = on or 'Referees' | 6 | Teams Together (team members are placed at neighbored places) -------+-------+--------------------------------------------------------------- 0x0002 | 1,2 | Fixed teams: 0 = off, 1 = unused, 2 = unused, 3 = on -------+-------+--------------------------------------------------------------- 0x0003 | 0 | Full Shared Unit Control | 1 | Random Hero | 2 | Random Races | 6 | Observer: Referees (other observer bits are 0 or 3) -------+-------+--------------------------------------------------------------- 0x0004 | | 0 0x0005 | | unknown (0 in ladder games, but not in custom) 0x0006 | | 0 0x0007 | | unknown (0 in ladder games, but not in custom) 0x0008 | | 0 -------+-------+--------------------------------------------------------------- 0x0009 | 4Byte | Map Checksum //TODO: find algorithm - 0C | | -------+-------+--------------------------------------------------------------- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 4.5 [Map&CreatorName] - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - Make sure you have decoded the three Strings (see 4.3). First is the map name, second is the game creators name (can be "Battle.Net" for ladder) and a third is an always empty string. Here ends the encoded string. There should not be any unprocessed decoded bytes left. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 4.6 [PlayerCount] - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 4 bytes - num players or num slots in Bnet games is the exact ## of players in Custom games, is the ## of slots on the join game screen in Single Player custom games is 12 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 4.7 [GameType] - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - offset | size/type | Description -------+-----------+----------------------------------------------------------- 0x0000 | 1 byte | Game Type: | | (0x00 = unknown, just in a few pre 1.03 custom games) | | 0x01 = Ladder -> 1on1 or FFA Custom -> Scenario (not 100% sure about this) | | 0x09 = Custom game | | 0x1D = Single player game | | 0x20 = Ladder Team game (AT or RT, 2on2/3on3/4on4) 0x0001 | 1 byte | PrivateFlag for custom games: | | 0x00 - if it is a public LAN/Battle.net game | | 0x08 - if it is a private Battle.net game 0x0002 | 1 word | unknown (always 0x0000 so far) TODO: values in patch >=1.07: 01 00 00 00 : ladder 1on1 / custom scenario 20 00 00 00 : ladder team 09 00 00 00 : custom game 09 A8 12 00 : custom game 09 A0 12 00 : custom game 09 A8 42 00 : custom game 09 A8 14 00 : custom game 09 A0 14 00 : custom game 01 40 13 00 : custom game 09 A0 42 00 : custom game 09 A8 44 00 : custon game - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 4.8 [LanguageID] - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 4 byte - (independent of realm, map, gametype !) Might be another checksum or encoded language. I found the following numbers in my replays: C4 F0 12 00 - patch 1.10 ger 90 F1 12 00 - patch 1.06 ger 90 F1 12 00 - patch 1.05 ger A0 F6 6D 00 - patch 1.04 ger 24 F8 12 00 - patch 1.04 eng(?) A0 F6 6D 00 - patch 1.03 ger C0 F6 6D 00 - patch 1.02 ger //TODO: Find out what this field is really about. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 4.9 [PlayerList] - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - The player list is an array of PlayerRecords for all additional players (excluding the game host and any computer players). If there is only one human player in the game it is not present at all! Per additional player there is the following structure in the file: offset | size/type | Description -------+-----------+----------------------------------------------------------- 0x0000 | 4/11 byte | PlayerRecord (see 4.1) 0x000? | 4 byte | unknown | | (always 0x00000000 for patch version >= 1.07 | | always 0x00000001 for patch version <= 1.06) This record is repeated as long as the first byte equals the additional player record ID (0x16). - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 4.10 [GameStartRecord] - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - offset | size/type | Description -------+-----------+----------------------------------------------------------- 0x0000 | 1 byte | RecordID - always 0x19 0x0001 | 1 word | number of data bytes following 0x0003 | 1 byte | nr of SlotRecords following (== nr of slots on startscreen) 0x0004 | n bytes | nr * SlotRecord (see 4.11) n+4 | 1 dword | RandomSeed (see 4.12) n+8 | 1 byte | SelectMode | | 0x00 - team & race selectable (for standard custom games) | | 0x01 - team not selectable | | (map setting: fixed alliances in WorldEditor) | | 0x03 - team & race not selectable | | (map setting: fixed player properties in WorldEditor) | | 0x04 - race fixed to random | | (extended map options: random races selected) | | 0xcc - Automated Match Making (ladder) n+9 | 1 byte | StartSpotCount (nr. of start positions in map) - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 4.11 [SlotRecord] - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - offset | size/type | Description -------+-----------+----------------------------------------------------------- 0x0000 | 1 byte | player id (0x00 for computer players) 0x0001 | 1 byte | map download percent: 0x64 in custom, 0xff in ladder 0x0002 | 1 byte | slotstatus: | | 0x00 empty slot | | 0x01 closed slot | | 0x02 used slot 0x0003 | 1 byte | computer player flag: | | 0x00 for human player | | 0x01 for computer player 0x0004 | 1 byte | team number:0 - 11 | | (team 12 == observer or referee) 0x0005 | 1 byte | color (0-11): | | value+1 matches player colors in world editor: | | (red, blue, cyan, purple, yellow, orange, green, | | pink, gray, light blue, dark green, brown) | | color 12 == observer or referee 0x0006 | 1 byte | player race flags (as selected on map screen): | | 0x01=human | | 0x02=orc | | 0x04=nightelf | | 0x08=undead | | 0x20=random | | 0x40=race selectable/fixed (see notes below) 0x0007 | 1 byte | computer AI strength: (only present in v1.03 or higher) | | 0x00 for easy | | 0x01 for normal | | 0x02 for insane | | for non-AI players this seems to be always 0x01 0x0008 | 1 byte | player handicap in percent (as displayed on startscreen) | | valid values: 0x32, 0x3C, 0x46, 0x50, 0x5A, 0x64 | | (field only present in v1.07 or higher) Notes: o This record is only 7 bytes in pre 1.03 replays. The last two fields are missing there. o For pre v1.07 replays this record is only 8 bytes. The last field is missing there. o For open and closed slots team and color fields are undetermined. o For WarCraft III patch version <= 1.06: If bit 6 of player race flags is additionally set (0x40 added) then the race is fixed by the map (see also section 4.10). o For WarCraft III patch version >= 1.07: If bit 6 of player race flags is additionally set (0x40 added) then the race is selectable by the player - otherwise it is a ladder game or the race is fixed by the map (see also section 4.10). - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 4.12 [RandomSeed] - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - This field is the best bet on the random seed the Warcraft III engine is initialized with. The replay data that follows requires already a set up seed (since starting positions and race are fixed at this time). For custom games (no matter if battle.net or LAN) this dword appears to be the runtime of the Warcraft.exe of the game host in milliseconds. For ladder games the value variies very much - probably the battle.net server hands out a 'real' seed (not runtime based) to the clients. =============================================================================== 5.0 [ReplayData] =============================================================================== This section describes the Replay data following directly after the static data described in section 4. It represents information about the game in progress. Replay data is segmented into seperate blocks of either fixed or variable size. The order of these blocks is not fixed and not all known blocktypes have to be present in a replay. Blocks always start with one byte representing the block ID. Using this ID one can identify specific blocks while skipping unwanted (using the block size). Below all known blocks are listed by their block ID followed by a description of the data following the ID. Denoted in square brackets is the overall size of each block (including the one byte block ID). - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 0x17 - LeaveGame [ 14 byte ] - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 1 dword - reason 0x01 - connection closed by remote game 0x0C - connection closed by local game 0x0E - unknown (rare) (almost like 0x01) 1 byte - PlayerID 1 dword - result - see table below 1 dword - unknown (number of replays saved this warcraft session?) Key for Table: player = player according to PlayerID saver = replay saver ( = player of very last leave-action) INC = the unknown parameter in the last leave-action was incremented by 1 (compared to the other LeaveGame actions before) [?] = entries marked with this symbol are true for common replays but we encountered at least one nonconform replay. [O] = if the replay saver was an observer it regularly happens that players get a result of 0x01 Reason | Result | Description ===========+========+======================================================= 0x01 | 0x01 | player left (disconnected or saver is observer) [O] (remote) | 0x07 | player left | 0x08 | player lost (was completly erased) | 0x09 | player won | 0x0A | draw (long lasting tournament game) | 0x0B | player left (was observer) [?] -----------+--------+------------------------------------------------------- 0x0E | 0x01 | player left [?] (remote) | 0x07 | player left [?] | 0x0B | player left (was observer) [?] ===========+========+======================================================= 0x0C | 0x01 | saver disc. / observer left [O] (not last)| 0x07 | saver lost, no info about the player [?] | 0x08 | saver lost (erased), no info about the player | 0x09 | saver won, no info about the player | 0x0A | draw (long lasting tournament game) | 0x0B | saver lost (obs or obs on defeat) [?] -----------+--------+------------------------------------------------------- last 0x0C | 0x01 | saver disconnected (rep.saver)| 0x07 | with INC => saver won | | w/o INC => saver lost | 0x08 | saver lost (completly erased) | 0x09 | saver won | 0x0B | with INC => saver won most times, but not always [?] | | w/o INC => saver left (was obs or obs on defeat) [?] Personal note: o Until now we have not found a robust winner detection algorithm that works for every replay :( We checked about 6000 replays. Normal ladder games works well, but especially FFA games saved by an observer are very &§*#$. So here is still work to do... Notes: o Do NOT use the marked lines ([?],[N]) for winner detection. If you use these you will probably increase the detection rate but also get false detections. The unmarked lines proofed to be fail-safe (at least until now). o If at least one player gets a draw result the whole game is draw. o The result*s* of the replay saver - he can get more than one because all local leave actions (reason=0x0C) belong to this result - do not contradict (except in draw games). There is never a win and a loss result at the same time (if you use the none marked lines). o All result-values in a leave-action are player specific results. E.g. if one player of a team quits he gets a 'lost' result value - even if his team mate later wins the game. o If you get a win result for a player his team is definitely the winner and all other teams lost. o If the result for every player of a team is "loss" the whole team lost. o Even WarCraft cannot see into the future ;). If the saver of a team replay leaves the game first, you will always detect a 'saver-lost' result. It is impossible to detect who is the winner in this replay. Unfortunately this happens quite often. Imagine a 2vs2 game: One team was nearly beaten, both players say 'gg' and leave. If the replay saver (one of these losers) quits only 1 second before his team mate, you cannot detect the winner in this replay. Our strategy in this situation is to assume that the whole replay saver team lost. This might not be correct in every situation (but from the replay we will never know). An alternative strategy could be: The team with the most remaining players wins. This can be wrong too e.g. if in a 2on2 one team nearly won when one of the players of this team disconnects but the second player finishes the work. In 2on2 games both strategies lead to same result. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 0x1A - unknown (first startblock) [ 5 byte ] - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 1 dword - unknown (always 0x01 so far) Notes: o This block seems to be always the first block at start of game. It is never repeated. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 0x1B - unknown (second startblock) [ 5 byte ] - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 1 dword - unknown (always 0x01 so far) Notes: o This block seems to be always the second block at start of game. It is never repeated. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 0x1C - unknown (third startblock) [ 5 byte ] - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 1 dword - unknown (always 0x01 so far) Notes: o This block seems to be always the third block at start of game. It is never repeated. o Rarely there is a chat block (0x20) or a LeaveGame block (0x17) between 2nd startblock (0x1B) and this 3rd startblock (0x1C) - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 0x1E - TimeSlot block [ n+3 byte ] - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - for details see block 0x1F Notes: o For patch version <= 1.02 this block was used instead of block 0x1F. o This block also rarely appears in version >= 1.07. In this case the usual RandomSeed block (0x22) does *not* follow though. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 0x1F - TimeSlot block [ n+3 byte ] - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 1 word - n = number of bytes that follow 1 word - time increment (milliseconds) about 250 ms in battle.net about 100 ms in LAN and single player n-2 byte - CommandData block(s) (not present if n=2) For every player which has executed an action during this time slot there is at least one 'Command data block'. CommandData block: 1 byte - PlayerID 1 word - Action block length n byte - Action block(s) (see file 'w3g_actions.txt' for details) Notes: o The 'time increments' are only correct for replays played at fastest speed. o Accumulate all 'time increments' to get the time of current action(s). o This block is always followed by a 'Random Seed' block (0x22) o For patch version <= 1.02 this block has the ID 0x1E. o A detailed description of the action block format and all valid actions can be found in the seperate document 'w3g_actions.txt'. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 0x20 - Player chat message (patch version >= 1.07) [ n+4 byte ] - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 1 byte - PlayerID (message sender) 1 word - n = number of bytes that follow 1 byte - flags 0x10 for delayed startup screen messages? (see note) 0x20 for normal messages 1 dword - chat mode (not present if flag = 0x10): 0x00 for messages to all players 0x01 for messages to allies 0x02 for messages to observers or referees 0x03+N for messages to specific player N (with N = slotnumber) n bytes - zero terminated string containing the text message Notes: o This block was introduced with patch 1.07. o Only messages send and received by the player who saved the replay are present. o Messages to observers are not saved. o The slot number corresponds to the record number as per section 4.11 starting with zero (first record = slot 0). o To get the time of the chat command, accumulate all 'time increments' from the 'TimeSlot' blocks (see above, block 0x1E and 0x1F). Notes on chat messages with flag = 0x10: o Only appears on startup between action block 0x1B and 0x1C. o The 'chat mode' dword is not present. The message text starts right after the flag field. The length value reflects this correctly. o These chat messages do not appear when the replay is watched with WarCraft. o The messages only appear in custom game replays. Maybe these are chat messages written in the game startup screen, which were send right before the game was started and could not be shown there in time because of lag. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 0x22 - unknown (Checksum or random number/seed for next frame) [ 6 byte ] - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 1 byte - number of bytes following (always 0x04 so far) 1 dword - unknown (very random) Notes: o For patch version <= 1.02 this block has the ID 0x20. o This message eventually syncs the random seed used for any calculation within the previous or next frame between all clients. It might be a complete gamescene checksum too though. o This block follows always after a 'TimeSlot' block. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 0x23 - unknown [ 11 byte ] - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - Maybe: 1 dword - unknown 1 byte - unknown (always 4?) 1 dword - unknown (random?) 1 byte - unknown (always 0?) Notes: o Very rare. o Appears in front of a 'LeaveGame' action. Examples: 23 4C 0D 00 00 04 0B B0 B1 FC 00 -> "#L........." 3404 4 4239503371 0 23 64 07 00 00 04 AC 34 28 7E 00 -> "#d.....4(~." 1892 4 2116564140 0 23 FB 0D 00 00 04 DD B8 B1 87 00 -> "#.........." 3579 4 2276571357 0 23 D5 15 00 00 04 19 ED 43 72 00 -> "#.......Cr." 5589 4 1917054233 0 23 1B 03 00 00 04 D8 2E 81 4F 00 -> "#........O." 795 4 1333866200 0 23 F2 04 00 00 04 91 7F C6 01 00 -> "#........." 1266 4 29786001 0 all following back-to-back in a single replay: 23 3A 03 00 00 04 B5 1F DC 80 00 -> "#:........." 826 4 2161909685 0 23 3B 03 00 00 04 DE A7 93 77 00 -> "#;.......w." 827 4 2006165470 0 23 3C 03 00 00 04 A9 A6 78 3B 00 -> "#<......x;." 828 4 997762729 0 23 3D 03 00 00 04 25 87 97 9C 00 -> "#=....%...." 829 4 2627176229 0 TODO: more analysis - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 0x2F - Forced game end countdown (map is revealed) [ 9 byte ] - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 1 dword - mode: 0x00 countdown is running 0x01 countdown is over (end is forced *now*) 1 dword - countdown time in sec Notes: o This block was introduced with patch 1.07. o Only found in battle.net tournament games which last too long. o Normally countdown starts with 4:58 and the block is repeated every 30s (4:58, 4:28, 3:58, ..., 0:58, 0:28, 0:00, now). o On first occurence of this block the "fog of war" is turned off (the complete map is revealed to all player). =============================================================================== 6.0 General notes =============================================================================== o It seems that the following things are *not* to be found in the replay: + the Battle.net realm + the time/date of the game + the level/exp/record of the players in a ladder game o You may add your own data at the end of the replay file - Warcraft III ignores them (except for official blizzard replays, see section 6.1). This might be useful e.g. for an replay database tool when storing a description of the game right with the replay data. o The saver of the replay is the last player leaving the game. This 'LeaveGame'-Action (see 5.0) is also the very last action of the replay. This means the player id of the replay saver is the 9th last byte of the uncompressed replay (so you don't have to parse the action-blocks to get the name of the replay saver). This method does not work for official Blizzard replays. o Warcraft starts showing a replay with the game hosts point of view. o The game type is not explicitly recorded in the replay: - there is no difference between AT (arranged team) and RT (random team) ladder games replay wise - one can detect team games by the team number in slot records - one can detect FFA games by all players having different team numbers and there are more than 2 in the game o One can start Warcraft with the parameter '-loadfile' to play back a replay immediately: War3.exe -loadfile "replayfilename" Before patch 1.14 there was a side effect: the single-player user-name was automatically changed to 'WorldEdit'. o There was no patch 1.07, 1.08 and 1.09 for WarCraft III classic. Patch 1.10 was released after patch 1.06 reflecting the release of WarCraft III expansion set 'The Frozen Throne'. o WarCraft III Frozen Throne was shipped with patch version 1.07 but was immediately patched to version 1.10. There was no patch 1.08 or 1.09. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 6.1 Notes on official Blizzard Replays - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - These replays are automatically obtained by Blizzard during or after high level ladder games and tournament final games. They are available for download through the official Battle.net web page and show some differences to normal replays saved by users. Differences: o The build number (see 2.2) is always zero. o The filesize is 132 byte larger than denoted in header (see below). o The map record (see 4.4) always reads '01 01 01 F9 01 01 FF FF FF FF'. o The values of the unknown PlayerList entry (see 4.9) of all players in the replay is equal to the LanguageID (see 4.8). o The number of SlotRecords (Byte 0x0003 of [GameStartRecord] in section 4.10) is always zero - there are no slot records (see 4.11) present. o The StartSpotCount (see [GameStartRecord] in section 4.10) is always 0xCC. o There is a signature block at the end of the replay: 1 dword : 4E 47 49 53 = 'NGIS' <=> 'SIGN' 128 Byte : signature Notes: o Since the lack of all slot records, one has to generate these data: iterate slotNumber from 1 to number of PlayerRecords (see 4.1) player id = slotNumber slotstatus = 0x02 (used) computerflag = 0x00 (human player) team number = (slotNumber -1) mod 2 (team membership alternates in PlayerRecord) color = unknown (player gets random colors) race = as in PlayerRecord computerAI = 0x01 (non computer player) handicap = 0x64 (100%) o Tournament replays are given a unique name using the following scheme: 'YYYYMMDDhhmmxxxxx-TAG-TYPEp.w3g' where: YYYY - year of the beginning of the game in greenwitch mean time (GMT) MM - month ... DD - day ... hh - hour ... mm - minutes ... xxxxx - numeric ID TAG - 'W3XP' for FrozenThrone, 'WAR3' for Classic TYPE - standard or race/map limitations,... without limitations (day of week): FRI - friday SAT - saturday SUN - sunday race limitation tournament: HUM - Human ORC - Orc NLF - Nightelf UND - Undead RND - Random map limitation tournament: CLD - Coldheart FLD - Floodplains GNW - Gnollwood LST - Lost Temple RCK - Turtle Rock WET - Wetlands p - number of players per team File name examples: 20030816204000041-W3XP-SAT1.w3g Frozen Throne 1on1 tournament on Saturday august 16th (round started at 20:40 GMT) 20030817222400050-W3XP-SUN2.w3g Frozen Throne 2on2 tournament on Sunday august 17th 20030820205400081-W3XP-LST1.w3g TFT 1on1 "Lost Temple"-only tournament on august 20th o Since one cannot change the name of the replay file, there has to be a checksum in the signature (or maybe within the replay data itself). o This feature was officially announced by Blizzard a couple of days after the release of patch 1.12. It might have been present in previous versions of the game though. TODO: - signature analysis =============================================================================== 7.0 Credits =============================================================================== We like to thank the following people for their help on decoding the W3G format (in alphabetical order): o BlackDick for - info on header checksum calculation - info on updates with patch 1.10 - version/build information on TFT beta replays - various other hints and minor updates o DooMeer for - info on '-loadfile' parameter o Ens for - info on chat modes (observer, specific player) o Mark Pflug for - finding action blocks 0x1E and 0x23 o Kliegs for - his notes.txt on which this document is based - hosting a CVS for replay format related documents o ShadowFlare for - WinMPQ - hosting the developer forum o Soar - some infos on changes with TFT o Ziutek for - Total Commander MPQ plugin =============================================================================== 8.0 Document revision history =============================================================================== o general notes + information added - information changed version 1.18 - 2007-06-26 ------------------------- 2007-06-26: - updated weblinks in the header of this file 2007-06-26: + added build numbers for patch 1.21b version 1.17 - 2007-01-28 ------------------------- 2007-01-27: + added build numbers for patches 1.20d, 1.20e, 1.21 version 1.16 - 2006-03-25 ------------------------- 2006-03-25: + added build numbers for patches 1.19, 1.19b, 1.20, 1.20b, 1.20c 2006-03-25: - updated forum url in file header version 1.15 - 2005-04-30 ------------------------- 2005-04-30: - fixed build number for patch 1.15 (final) 2005-04-29: - some minor addition on GameSettings 2005-04-26: + added build number for patch 1.18 2005-04-26: + added section 2.4.2 on beta patches 2005-04-26: - corrected contact information in file header 2005-04-26: - translated german note on encoding scheme in section 4.3 version 1.14 - 2004-10-02 (internal) ------------------------- 2004-10-02: + added build numbers for patches 1.15, 1.16 and 1.17 2004-10-02: - some minor cleanups version 1.13 - 2004-08-?? (internal) ------------------------- 2004-08-06: - restructured sections 4.3, 4.4 and 4.5 (the encoded string starts earlier) 2004-04-19: + added build numbers for patches 1.15(beta) 2004-02-15: - fixed build numbers for patches 1.14 and 1.14b version 1.12 - 2004-01-18 ------------------------- 2004-01-17: + added build numbers for patches 1.14 and 1.14b version 1.11 - 2004-01-02 ------------------------- 2003-12-20: + added build numbers for patches 1.13 and 1.13b 2003-12-15: - fixed developer forum URL in header version 1.10 - 2003-12-14 ------------------------- 2003-12-14: - fixed even more grammar/spelling mistakes 2003-12-05: - fixed various grammar/spelling mistakes version 1.09 - 2003-12-02 ------------------------- 2003-12-02: o killed a lot of trailing spaces 2003-12-02: + added BETA patch release dates (section 2.4) 2003-11-25: + added patch release dates (section 2.3) 2003-11-23: - updated notes on version determination 2003-11-11: - fixed some typos/grammar mistakes 2003-11-11: - extended description of general block structure 2003-11-06: + added many notes on winner detection (LeaveGame section) 2003-11-03: + added version section (section 2.3) 2003-10-11: - renamed "game creator" to "game host" in some places 2003-10-11: - various minor layout improvements 2003-10-05: + added note and examples on block 0x23 2003-09-25: - changed one LeaveGame result 2003-09-24: + added flag 0x10 description of chat blocks 2003-09-24: + added note on third startblock version 1.08 - 2003-09-20 ------------------------- + added info on official Blizzard replays + added action blocks 0x1E and 0x23 + added patch 1.12 build number + added note on loadfile-parameter + vastly improved leave game command (0x17) description - fixed error in header ID string - changed description of version number fields for subheaders version 0 - renamed action block 0x1F to 'TimeSlot' and improved description - many minor updates and fixes version 1.07 - 2003-07-31 ------------------------- + added missing chat modes (thx Ens) + added size information to all blocks in section 5 + improved introduction part of sections 4 and 5 - fixed 'referee' bug in map settings section o various layout improvements version 1.06 - 2003-07-22 ------------------------- + added replay data block 0x2F + added some additional notes to disclaimer + added some more build numbers (thanks to blackdick) + added version/build information on TFT beta replays (thx BlackDick) - renamed mostly all 'patch 1.10' to 'patch 1.07', because first TFT release was 1.07 and the replays had the same structure as in 1.10 version 1.05 - 2003-07-01 ------------------------- - fixed error in description of new chat message block (0x20) + added information on fixed races in patch 1.10 + added some minor notes related to patch 1.10 version 1.04 - 2003-06-30 ------------------------- + added note on game type in section 6. + added some minor notes + added patch 1.10 format changes: o new header (section 2) o handicap field (section 4.11) o referee type observers (sections 4.3 and 4.11) o chat message block (section 5) + added some patch 1.10 example records version 1.03 - 2003-06-16 ------------------------- + added build numbers for all released patches + added some minor notes in various sections + added some patch 1.06 example records - fixed missing dword (section [LeaveGame]) + added some language strings (section [GameName]) + added notes about replay saver version 1.02 - 2003-06-14 ------------------------- o removed all "//*" marks for better readability - fixed some typos - fixed patch version for blocks 0x1E and 0x20 in section 5 (patch <= 1.02 instead of <1.05) - minor cleanups of various sections version 1.01 - 2003-06-12 ------------------------- o differences and additions to kliegs notes.txt are marked with //* o minor layout improvements in section 5 - renamed 'Player Actions block' to 'Player commands block' and updated whole paragraph version 1.00 - 2003-06-06 ------------------------- o first public release o differences and additions to kliegs notes.txt are marked with //* + added info on header checksum calculation (thx BlackDick) + added info on first unknown field in header (thx BlackDick) version 0.90 - 2003-06-04 ------------------------- o beta release o differences and additions to kliegs notes.txt are marked with //* This document was created using VIM 6.2 (www.vim.org). =============================================================================== End of File ===============================================================================