========================================================================================================
Warcraft III Cache Converter 1.0.0.1 - Created by PitzerMike - March 8th 2005
========================================================================================================


DISCLAIMER

This program is distributed as is. You use it at your own risk.
The creator is not liable for any damage, data loss, loss of profits or
any other kind of loss or damage while using this software.
It has been tested thoroughly and scanned for viruses.


DESCRIPTION

The Cache Converter extracts gamecache data from Warcraft III gamecache files and
Warcraft III savegame files and converts it to readable and editable SLK format.
It can then be edited in Excel and converted back to a W3V file with the Cache Converter.


INSTALLATION

Simply put the files included in this archive in a folder and it's ready to use.
You can also register file extensions to the tool, so a double click on such a file
automatically converts it with the Cache Converter. See usage section for information on that.
This tool requires the Dot.NET framework 2.0, so you better download and install it.
http://www.microsoft.com/downloads/details.aspx?FamilyID=0856eacb-4362-4b0d-8edd-aab15c5e04f5


USAGE

Convert gamecache to SLK: CacheConv <campaigns.w3v> [output.slk]
Convert gamecache from savegame to SLK: CacheConv <savegame.w3z> [output.slk]
Convert SLK to gamecache: CacheConv <input.slk> [output.w3v]
Register file extensions to the tool: CacheConv register [w3v | w3z]
Unregister file extensions: CacheConv unregister [w3v | w3z]

There are two special naming conventions for you to make the output more readable.

1. If the label of an integer value starts with # it will be interpreted as an id.
   That means in the SLK file it will be displayed as its string representation.
   Useful for debugging unit/item/doodad/destructable/ability/buff/upgrade ids.

2. If the name of a category starts with < or > all the values within that category
   will be ordered ascending (<) or descending (>) in the SLK file.
   Useful for logging actions so that they'll be listed in the correct order.
   A leading # character will be ignored for the comparison.


KNOWN ISSUES

Although game cache data can be extracted from savegames, it's currently not possible
to reverse it and convert SLK files to savegames. This is because the Warcraft III savegame
file format is currently far from being cracked. But that wouldn't be very useful anyway.

Don't mess with the unknown values too much and don't use invalid values when editing
a gamecache in Excel. You will get a corrupted gamecache file if you convert it back to w3v.
Don't blame the tool for it in that case.


UNINSTALLATION

Simply delete the files that were included in this archive.


CREDITS

This was based on BlackDick's unpacker, thanks to him for the source code snippet.
Thanks to Soar, IceFrog and Trystero for information about packing files again.


CONTACT

Make bug reports in the editing tools forum at http://www.wc3campaigns.net
You may also write me an e-mail to PitzerMike@gmx.at

Have fun!


  /\/\/\/\/\
 /          \
/ PitzerMike \
\____________/