-
Notifications
You must be signed in to change notification settings - Fork 0
Replay Format Home
Please keep in mind that it is not actively maintained any more and that the best source of information is always going to be the source code itself and the people in our community who would be happy to help you through it. If you would like to volunteer to update this section of the site I'd love to have you do it. Put out an email on the mailing list.
Progress on the replay format has been a community effort which sc2reader has only just recently joined. In particular, the open source code and excellent documentation at the phpsc2replay project have been invaluable in sc2readers development. Additional thanks to all the people that contributed directly or indirectly to the sources that the phpsc2replay project itself has used in development. There are many of you.
Starcraft II replays are stored in MPQ files. MPQ is an archive format developed by Blizzard Entertainment for use in their line of games and has been fully documented in several other places. You can get an overview on wikipedia and an in depth look at this structure and algorithms at devlog.net. The are a great number of tools and libraries which implement this specification and can successfully parse and extract files from MPQ archives.
sc2reader uses the mpyq library for this purpose.
In addition to holding files with additional information, the sc2replay archive itself holds information regarding the replay. The structure of this information can be found on the .sc2replay wiki page.
It is important to note that ALL FILES including the archive itself are parsed as a hexadecimal byte stream
If you don't know what that means, please see the byte.stream page for an overview and links to more through reference materials.
The Starcraft II replay archive contains the following files, some of which sc2reader parses and some of which it does not.
Please follow the links for parsed files to the wiki page which documents the unique format of each file to the best of my knowledge.
Parsed Files
Not Parsed
- replay.load.info
- replay.sync.events
- replay.smartcam.events