Clarity is a parser for Dota 2 replay files written in Java.
Attention: New Journey update
Breakage occurs with the new 7.00 update. I already pushed a new 2.2-SNAPSHOT, as well as a 2.1.1 release which should fix it. Please update and report any remaining issues!
clarity produces the following data you might be interested in from a replay. Choose from:
- combat log: a detailed log of events that happened in the game
- entities: in-game things like heroes, players, and creeps
- modifiers: auras and effects on in-game entities
- temporary entities: fire-and-forget things the game server tells the client about*
- user messages: many different things, including spectator clicks, global chat messages, overhead events (like last-hit gold, and much more), particle systems, etc.*
- game events: lower-level messages like Dota TV control (directed camera commands, for example), etc.*
- voice data: commentary in pro matches*
- sounds: sounds that occur in the game*
- overview: end-of-game summary, including players, game winner, match id, duration, and often picks/bans
* unprocessed: data is provided as original protobuf message object
- Java 7 or newer
Fetch the current stable version (2.1.1) from Maven Central with
<dependency> <groupId>com.skadistats</groupId> <artifactId>clarity</artifactId> <version>2.1.1</version> </dependency>
Clarity 2.2 is work in progress and only available as a snapshot, so you got to add a pointer to the repository to your pom.xml (see the pom.xml of clarity-examples, which already does that)
To add the snapshot repository, add the following:
<repositories> <repository> <id>sonatype.oss.snapshots</id> <name>Sonatype OSS Snapshot Repository</name> <url>http://oss.sonatype.org/content/repositories/snapshots</url> <releases> <enabled>false</enabled> </releases> <snapshots> <enabled>true</enabled> </snapshots> </repository> </repositories>
and then fetch the dependency with:
<dependency> <groupId>com.skadistats</groupId> <artifactId>clarity</artifactId> <version>2.2-SNAPSHOT</version> </dependency>
For example code, please see the the separate project clarity-examples.
See LICENSE in the project root.