This program aims to decode replay files and convert them into more accessible formats such as an image or json files. Which may be uses in other programs. The alternative project wotreplay-viewer implements a small HTML5 viewer for the JSON data.

When using the json output option, the replay is decoded into a list of packets, in the same way it is described in the replay file. The following information can be extracted from from the replay.

• Position
• Health
• Tanks being tracked
• Tanks getting shot or killed
• Hull Orientation
• Messages

• OpenSSL
• Boost (Complete)
• LibPNG
• LibXML2
• libjson-cpp (included in the source, from http://jsoncpp.sourceforge.net/)

• GCC (>= 4.7)
• CLANG

git clone https://github.com/evido/wotreplay-parser.git
cmake .
make

You may need to specify the include directory for LibXML2 using the CMAKE variable INCLUDE_DIRECTORIES. This can be done as following.

cmake -DINCLUDE_DIRECTORIES="/usr/include/libxml2" .

To use this software you need some data extracted from World of Tanks, this data contains some elements to draw the mini map, the actual minimaps and the arena definitions. I have prepared an archive which is available here. This should be available in the root folder (see next paragraph).

The program can be used to convert wotreplay files to images or json files.

wotreplay-parser --parse --root <working directory> --type <output type> --input <input file> --output <output file>

• output type can be png or json
• output is optional, the program will then write to stdout
• input and output are relative to root
• root should contain a folder maps with the images to maps and the arena definitions

The program can also be used to create all the minimaps for usage in wotreplay-viewer.

wotreplay-parser --create-minimaps --root <working directory> --output <output directory>

• root the working directory containing the necessary data
• output the output directory relative to the root directory

This packet is related to the spotting of tanks, it will occurr together with packet type 0x05 when the tank appears for the user (each time).

• type: the type of the packet
• clock: the timestamp of the packet

See packet type 0x03

This packet seems to be a health update which is sent relatively frequently, it only contains the following properties.

• type: the type of the packet
• clock: the timestamp of the packet
• player_id: the subject of the health update
• sub_type: the sub-type of the packet
• health: the health of the referenced player

This packet seems to be sent when a player's tracks are repaired, it also indicates which track is still destroyed.

• type: the type of the packet
• clock: the timestamp of the packet
• player_id: the subject of the track status
• sub_type: the sub-type of the packet
• destroyed_track_id: the id of the track that is still destroyed, possible values here are 0x00 (tank is not tracked), 0x1D (left track) and 0x1E (right track)

This packet indicates a player doing damage to another player and will most likely be accompanied by another packet indicating the type of damage such as Sub Type 0x05

• type: the type of the packet
• clock: the timestamp of the packet
• player_id: the subject of the track status
• sub_type: the sub-type of the packet
• source: player causing the damage
• health: new health of the player

This packet indicates that a player was shot by another player. When this is not accompanied by a damage packet, the player bounced the shell.

• type: the type of the packet
• clock: the timestamp of the packet
• player_id: the subject of the track status
• sub_type: the sub-type of the packet
• source: source of the shell

Most likely the indicator of a module being damaged.

• type: the type of the packet
• clock: the timestamp of the packet
• player_id: nonsense?
• sub_type: the sub-type of the packet
• source: player dealing damage to the moduel
• target: player receiving the damage

Indicator that a shot was fired by a player.

• type: the type of the packet
• clock: the timestamp of the packet
• player_id: the subject of the track status
• sub_type: the sub-type of the packet

Unclear.

• type: the type of the packet
• clock: the timestamp of the packet
• player_id: the subject of the track status
• sub_type: the sub-type of the packet
• target: player receiving the damage

This is the most frequent type of packet, it tells the player about the positions of any other player.

• type: the type of the packet
• clock: the timestamp of the packet
• player_id: the subject of the track status
• position: the sub-type of the packet
• hull_orientation: the sub-type of the packet

This packet contains a message sent to the battlelog during the game. The owner information is encoded inside the message.

<font color='#DA0400'>SmurfingBird[RDDTX] (VK 36.01 H)&nbsp;:&nbsp;</font><font color='#FFFFFF'>so far so good</font>

• type: the type of the packet
• clock: the timestamp of the packet
• message: a html encoded message

This packet indicates that a player's tank was tracked.

• type: the type of the packet
• clock: the timestamp of the packet
• player_id: the subject of the track status
• sub_type: the sub-type of the packet
• alt_track_state: indicates if the tank is tracked using values 0xF0 (not tracked) or 0xF6 (tracked)
• destroyed_track_id: the id of the track that was destroyed destroyed, possible values are 0x1D (left track is destroyed) and 0x1E (right track is destroyed).

All code is licensed under the permissive BSD license.