Clarity 2

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!

Replay Data

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

Requirements

Java 7 or newer
Maven

Usage

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>

Example Code

For example code, please see the the separate project clarity-examples.

License

See LICENSE in the project root.