Skip to content
Comically fast Dota 2 & CSGO replay parser written in Java.
Java
Branch: master
Clone or download

Files

Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
src/main Fix: Only overwrite StringTable value if one is supplied May 16, 2020
.gitignore ignore jitwatch files Aug 14, 2019
LICENSE remove point 4 from the license Mar 15, 2015
README.md update readme Mar 28, 2020
pom.xml add some new combat log properties Dec 18, 2019

README.md

Clarity 2

Clarity is a parser for Dota 2 and CSGO replay files written in Java.

Version 2.5 (last updated March 28, 2020)

Version 2.5 has been quite a lot slower and buggy, because of overly accurate reproduction of client frame handling in the Source engine. Today I refactored a lot of the handling, to get back to how clarity 2.4 does things.

The result is worth it: Speeds are back to 2.4 level, while console replays and live data will work fine.

2.5 has already been battle tested with some closed source parsers, but you might still find problems - so use 2.5-SNAPSHOT with caution, and report bugs!

Version 2.4.1 released

The fall update of Dota 2 contains a bugfix that are needed for replays from that new patch. If you get an exception saying that highLowMultiplier is zero, be sure to use the fixed version!

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 (for 2.4) or 8 (2.5)
  • Maven

Usage

Fetch the current stable version (2.4.1) from Maven Central with

<dependency>
	<groupId>com.skadistats</groupId>
	<artifactId>clarity</artifactId>
	<version>2.4.1</version>
</dependency>

Clarity 2.5 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.5-SNAPSHOT</version>
</dependency>

Example Code

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

License

See LICENSE in the project root.

You can’t perform that action at this time.