=============================== WOT Replay Parser README Last updated 8-15-2012 =============================== TABLE OF CONTENTS I. INTRODUCTION II. INSTALLATION III. FEATURES IV. HOW TO USE V. COPYRIGHT INFORMATION =============================== --------------- I. INTRODUCTION --------------- The WOT replay Parser is a tool to parse the replay file names for world of tanks. It will display the frequency of maps played, the frequency of tanks played, the frequency of tanks per map, and the frequency of maps per tank. ---------------- II. INSTALLATION ---------------- Unzip the application to a folder of your choice. You will need WINRAR (http://download.cnet.com/WinRAR-32-bit/3000-2250_4-10007677.html) or another extracting tool to unzip the WOT Replay Parser. Since this tool is written in Perl, you will need to install Perl (http://www.activestate.com/activeperl/downloads). This tool was tested with Perl v5.14 and v5.12, but it should work with earlier installations. Before running the tool, you must set the ReplayPath in the WotReplayParserConfig.xml file. This needs to be set to the path of the "replays" folder in your World of Tanks installation directory. Since this tool parses the replay files, you must check the "Enable battle recording" box on the Game tab of the Settings menu in WOT. ------------- III. FEATURES ------------- The WOT replay Parser has several customizable settings. These settings can be adjusted in the WotReplayParserConfig.xml file: ReportToFile - Set to true to send the results to a text file. ReportToScreen - Set to true to send the results to the command prompt. LaunchReportFile - If ReportToFile is set to true, you can also set this to true to automatically open the text file using Notepad. OverWriteReportFile - If set to false, a uniqely named text file will be created each time you run the tool. If set to true, the tool will reuse a single text file. ReportBaseName - This is the base name of the text file that the results are sent to. DaysToReport - This can be set to limit how many days back that the tool will include replay files. - You can even set this to fractions of days: IE: 1.5, 0.2, etc... GraphIcon - This is the character used to create the graphs. GraphLength - This is the maximum length of the graph. The higher the number, the more accurate the graph becomes. Set to zero to remove the graph. MapConversions Many of the WOT maps have different names diplayed in-game vs how they are saved in the replay file name. For example, the "abbey" map name in-game is saved as "monastery" in the replay file name. To make the tool display the in-game names in the report, this conversion table was created. In addition, this table is used as a look up table to parse the replay file names. Therefore, all the maps should be incldued in the table. If new maps are created, you can simply add an extra entry into the table. With the release of version 7.5, the replay file name formats were changed, new maps were added, and some maps were removed. I created a new MapConversion table for 7.5 and it should have all the maps in it. I left the old conversion table in place so that this tool is compatible with previous versions of WOT replay files. TankConversions Like the map names, the tank names in-game differ from how they are saved in the replay file name. Since I don't have the time or money to unlock and play every single tank in the game, there was no way I see how the tanks were saved. Therefore, I left this section empty, but available if you want to add any entries for the tanks that you play. -------------- IV. HOW TO USE -------------- After you have installed Perl and set the ReplayPath, can you either run the WotReplayParser.pl file from a command prompt or simply double click on the file. With the default settings, you will see command prompt window displaying the parsing status of all the replay files and then Notepad will be launched with the results. If there are any Failures in the parsing statuses, a message will be displayed with the filename that could not be parsed. If this happens, you can add that map name to the MapConversions table in the WotReplayParserConfig.xml file. ------------------------ V. COPYRIGHT INFORMATION ------------------------ Copyright (C) 2012 by Darryll Rohr. email:DarryllRohr@gmail.com. WOT replay Parser is free to use and distribute so long as all the original files (including this readme file) are included in the installation. WOT replay Parser my not be sold or traded for profit. If you make variations of this software, please give me credit as the original author. By using this software, you are agreeing to these terms.