Skadi parses Dota 2 replay files.
This project is in its early stages, and things are subject to change without much notice. Consequently, Skadi is best used for development purposes at this time. For up-to-date information, join #dota2replay on Quakenet IRC.
I hereby resolve that the Wiki pages of this repository will not suck. In them, you will find as much information as I have time to type. Start here.
Be sure to check out the "Pages" section.
To parse replay data, you'll need a Demo:
from skadi.replay import demo as rd
with io.open('123123123.dem', 'r+b') as infile:
demo = rd.construct(infile)
# And then you'll ask it for a `stream`:
stream = demo.stream(tick=12345) # tick arg optional, defaults to 0
# And iterate over each tick:
for tick, string_tables, world in stream:
# world contains information about all the entities:
for ehandle, state in world.items():
# an ehandle is a replay-wide unique identifier for an entity
# the state is just a plain old hash of keys and values
print ehandle, len(state)
Each key in the state is a two-item tuple:
(property origin, property name)
To uniquely identify a piece of state, you need both of these bits of info. This is because entity classes are part of an elaborate hierarchy--they inherit properties from parent, all the way up to their baseclass. Investigate the state. The property names should make sense. Play with the values you get from the keys and you'll start discovering a wealth of game data.
If you encounter a property name with the prefix 'm_h', or if the name indicates something relational, you might have found an ehandle. You can ask the world for an entity by ehandle with the method find. It will return that entity's state. With this, you can relate entities to one another--the data does that a lot!
Über-hacker @Noxville points out a helpful way of installing everything in Ubuntu:
(might need to be superuser to execute)
easy_install --allow-hosts pypi.python.org protobuf
easy_install bitstring
apt-get install python-snappy
The --allow-hosts option is important, since the default hosted version on Google Code is broken.
If you're on a different distribution or have environmental particularities, you're going for libraries (including dev libs) and bindings for:
- snappy
And python bindings for:
- protobuf
- bitstring
I use the pioneering edith project as a reference implementation for parsing bit streams.
A big shoutout to the folks in #dota2replay on Quakenet. Feel free to stop by if you have any questions! (Be patient, we're around!)
Visible attribution is kindly requested. I want Dota 2 fans to know about this project!
Skadi is offered under the MIT license.
This license applies to all revisions of source code until otherwise stated.