Take the 2-minute tour ×
Game Development Stack Exchange is a question and answer site for professional and independent game developers. It's 100% free, no registration required.

How do I parse StarCraft 2 replay files (.sc2replay)? Is there an API?

I know of Sc2gears, but it doesn't quite fulfil my needs.

share|improve this question

2 Answers 2

up vote 9 down vote accepted

The Starcraft 2 replays are stored as MPQ a compressed file-format developed and used by Blizzard. On the bottom of the Wiki page you'll also find links to MPQ parsers.

Maybe you'll also want to have a look at the following open-source projects: WARP (a Starcraft 2 replay parser written in Java) or phpsc2replay (a replay parser written in PHP).

Update: As of now, there's also a Python library out there that can read a lot of the replay data: sc2reader. This is most likely the best option that is currently available (as of March 2013).

share|improve this answer
Thanks for pointing me in the right direction bummzack. –  Gpx Apr 4 '11 at 12:37

I played with parsing the SC2 replay files a while back. You can view what I've done and what I've been able to reverse engineer (as well as bunch of links to helpful sites at the bottom):


share|improve this answer
A bunch of links in one place is really nice. –  kirilloid Apr 30 '13 at 10:21

Your Answer


By posting your answer, you agree to the privacy policy and terms of service.

Not the answer you're looking for? Browse other questions tagged or ask your own question.