UTCacheExtractor.exe v2.1.0

The UT Cache Extractor is a small utility program which will extract downloaded items from your Unreal Tournament, UT2003, or UT2004 cache. When you play on servers and do not have certain maps or supporting files, UT/UT2003/UT2004 will automatically download them for you. The cache is a fixed size, and is cleared after 30 days by default. This utility will allow you move items from the temporary cache into the appropriate UT/UT2003/UT2004 folder so you will never have to download it again!

No installation is necessary. Simply copy the contents of this zip file to the system folder in your UT/UT2003/UT2004 directory. The application will auto configure itself for you. If you attempt to run the UT Cache Extractor from another directory, it will not be able to find the cache, and will prompt you for information. If you have multiple versions of UT, such as both UT and UT2003, you can simply place a copy in both system folders.

Hopefully, this program will be pretty self explanatory. There are three action buttons, Refresh, Extract and Validate. Refresh will make sure the list is up-to-date. You can extract items by highlighting and clicking the Extract button. Multiple selections can be made by holding down the ctrl key as you click, or by using the shift key to select a range. If cache entries are made more than a few minutes apart, a dashed line will be shown. This should help identify which items were downloaded together, and are associated with a given Map.

UTCacheExtractor has the ability to check the GMS server to see if a more recent version is available, and to take you to to the site to download it. The application will NOT auto install the update; it will just take you to the site where you can download it manually. To use this feature, click the "Check for Updates" link or choose the "Check for Updates" option from the help menu. If you wish the application to automatically check for updates each time it is run, check the "Automatically check for updates" checkbox. This is a totally optional feature.

As of version 2.1, the UT Cache Extractor now includes better mutator support for UT2004. When extracting .u files, the application can now automatically shell out the UT2004 and create the necesary .int and .ucl files. The first time this occurs the application will prompt you. You can enable/disable this feature by using the Option menu. This capablity is currently only supported for UT2004 at the moment

As of version 2.0.1, there is now an addition status area at the bottom of the window that will show you the path where the selected item in the grid will be extracted. This text will only appear if you have an item selected in the list (or for the last selected item if you have multiple items selected).

As of version 2.0, the program now supports new gametypes and mods, such as CarBall and Red Orchestra. There is now a dropdown list above the game icon that allows you to choose between installed folders under your game directory. To use the normal cache directory (x:\<gamedir>\cache), leave the dropdown at it default value. Items will be extracted to the folder directly under the game folder. For example, to extract a UT2004 Onslaugh map, leave the dropdown set to "UT2004 (Default)", highlight the map entry on the cache tab, and click "Extract"; the map will be extracted to x:\UT2004\maps. If you have CarBall installed and you wanted to extract a CarBall map, choose "CBall" in the dropdown list, highlight the map entry on the cache tab, and click "Extract"; the map will be extracted to x:\UT2004\CBall\maps. Mods work the same way, except some mods, such as Red Orchestra, seem to maintain their own cache folder (i.e. x:\ut2004\RedOrchestra\cache. If this is the case, then the program will use show that cache when you select the mod via the dropdown. If a dedicated cache does not exist (like for CarBall), then the default game cache will be used. You find out what folders are being used by looking at the status bar at the bottom of the program window.

As of version 1.6, the UT Cache Extractor includes a shell for the UCC command to compress UT, UT2003 or UT2004 files. Generally you compress files if you are using a redirect on your server. (for more information regarding using redirect, check out http://www.unrealadmin.org/modules.php? ... id=21&#41; Several tabs have been added to the program user interface (UI). Clicking on any tab will show you a list of those types of items. The Cache tab will show you items in your cache, the maps tab will show you installed maps, etc. To compress a file, you click on the category tab (maps, textures, etc). Highlighting one or more items and click the Maps menu, then compress. You can also right click on the map list to bring up a popup menu. Textures, sounds, etc work the same way. Although you can select multiple items at the same time, each item that is selected will launch a new copy of UCC, so I would recommend only select a couple at a time. :)

As of version 1.5, the UTCacheExtractor now has an "extract to" option. If you right click on one or more items in the cache list and right click, there is a new "Extract To..." menu item. Select it and you can extract file from the cache to a directly that you specify. Note that if you use this option, items ARE NOT deleted from the cache. You can manually remove these items using the delete button if you wish.

This utility should also function with the UT2003 or UT2004 Demos, although it may not find it correctly if run outside the UT2003 or UT2004 demo system folder. You can select the correct folder manually.

Technically, this program is Freeware, however small donation of a buck or two would be appreciated. It keeps me motivated to keep creating useful software! =)

If you have any issues or questions regarding thie application, please goto http://forums.cyberrock.net/viewforum.php?f=5.

Please register by sending a postcard or e-mail to the following address, and indicate if you would like to be notified of any updates:

Granite Mountain Software
3515 S. Myrtle St
Spokane, WA 99223
gms@cyberrock.net
http://gms.cyberrock.net

Legal Stuff

By installing and running this sofware, you agree to the terms of this agreement. This program is supplied as is, with no warranty or guarantee, implied or otherwise.

----------------------------------------------

What happend in UT2003 Build 2166...

In UT, the cache files are ID'd by a GUID in the cache INI, and the file name is the GUID with an "uxx" ext attached. When I originally coded the UTCacheExtractor, UT2003 worked the same way. With UT2003 build 2166, it now appears that cache files have a dash and a number after the GUID. In my own cache about 60% of the files had the extra characters, a "-1" after running build 2166 for a few days. The number after the dash seems to have to do with versioning, so you can have different versions of the same file in your cache.

[examples]

cache.ini entry:
E1344EE543A070450CD0E6869CB49AEE=CTF-MOK-Hall-V2.ut2

File name under build 2166:
E1344EE543A070450CD0E6869CB49AEE-1.uxx

File name under origial UT2003 and previous patches:
E1344EE543A070450CD0E6869CB49AEE.uxx