I'm a doctor, not a mechanic

Legacy:Restoring Modified Files

From Unreal Wiki, The Unreal Engine Documentation Site
Jump to: navigation, search

"Do Not Alter Default Packages" is one of the things people who are new to Unreal editing sometimes learn the hard way when they are no longer able to connect to game servers or, even worse, are kicked by cheat protection. Often the only easy way to get the game working online again is to reinstall it, but if you don't want to do that there usually is another way, which may be more complicated but usually saves a lot of time.

This page will describe some ways for restoring modified files.

Knowing The Problems

There are several traps when creating new Unreal content.

For example it's tempting to add new textures to existing texture packages when building a map, but look at it from a practical way: How are other players supposed to get the new texture if it's inside your version of the package but not theirs? Anyway, if you really modified such a data package you can't just remove the texture and save again. The package will stay modified! You can only restore it from your game CD(s) or DVD in this case.

Another problem in UT200x could be the UPL files, which contain information about player models. For example UPaint likes to override existing characters to make sure you specify a different name as soon as possible. The game server won't mind if you modify them, but cheat protections like UTSecure, Anti TCC and SafeGame will detect modifications and call you a cheater! (You don't want that, right?)

Other potential problems include buggy mod installers, which accidently copy mod files over core game files or buggy mod uninstallers, which remove more than they were supposed to (Ok, developers deserve a slap for something like that, but that's nothing we want to discuss here. ;)), as well as outdated patches such as the UnrealEd patches for UT2003, which should only be applied to the unpatched game and are obsoleted by any newer patch.

And finally, some people seem to be inclined to install stuff like "No CD Cracks" and the like – don't do that, not only are you probably violating the EULA, but you may also break important game files.

Detecting Damage

Sometimes modified files don't become appearant immediately.

Often you will notice modified packages when you connect to internet game servers. If a package required for the current game has been modified and is not dynamically loaded client-sidely, you will be disconnected with the message "Version Mismatch" and the package name. (If you get "Incompatible Game Files" instead, then it might be only a poorly coded mod that doesn't properly unload itself from memory when switching servers.)

If the server is running a cheat protection, it may also find other modifications such as UPL file changes. If you get disconnected from a server and get a mesage box, read it carefully. Often it tells you exactly what you need to look for.

Finding The Modified File

Finding out which file is actually modified can be quite easy if you got a message with information about the problem.

Version Mismatch

A "Version Mismatch" message usually contains a package name. This is the file name without file extension, so you will have to look in your package directories first.

If you aren't sure where you have to look for the files, just open your game's main INI file (UnrealTournament.ini, UT2003.ini, UT2004.ini, etc. in {Base Directory}\System) and look for the [Core.System] section. You will find several lines that begin with "Path=" followed by a string that represents a directory name and a file wildcard.

For example:


This means the game looks for files with the extension .U in {Base Directory}\System (Paths=*.u), with the extension .UT2 in {Base Directory}\Maps and with the extension .UTX in {Base Directory}\Textures. So if you got a "Version Mismatch" for "DM-Modifier" you'd probably find the file DM-Modifier.ut2 in the Maps directory and know that it's not the same version as the server wants.

Modified UPL Files

Some cheat protections may give you a message like "Modified Character Entry Detected". In this case you either have a modified UPL file or an additional UPL file that overrides entries in the original one.

Usually The game looks for them in {Base Directory}\System, but it seems UPL files can be placed somewhere else as well. You should look in your whole game directory and check every single UPL file you find, if they contain an entry for the supposedly modified character. UT2003 contains 147 and UT2004 179 uniquely named character entries and no other UPL file should use these.

Restoring The Original File

Here comes the tricky part: You need to somehow find the original version of your file.

First Attempt: The Patch

Modified or damaged .U, .EXE or .DLL files can usually be repaired by (re)applying the latest patch. For mod files you should simply reinstall the mod. This won't help against modified game data packages or UPL files, though.

Second Attempt: Copying From The Source Disk(s)

Know The Source Disks

Usually the game comes on three CDs. (international version)
On CD1 you will find the UPL files, the animation packages (*.ukx), the maps (*.ut2) and some textures (*.utx) and sounds. (*.uax) CD2 contains the remaining textures, static meshes (*.usx), the OGG music and localized sound packages for French. CD3 contains the localized sound packages for German, Italian and Spanish as well as a few tools.
Usually the game comes on six CDs or one DVD, not counting the bonus DVD of the Special Edition. On the DVD there are multiple directories that correspond to the disks of the CD version.
CD1 contains the UPL files, animations, maps and a few sounds. CD2 contains the remaining non-localized sounds, and some textures. CD3 contains only textures. CD4 contains the remaining textures, the static meshes and most of the OGG music. CD5 contains the remaining music and most of the localized sound packages. CD6 contains the remaining localized sound packages as well as some tools.

Extracting The Files

UPL files can be copied as they are, but package files need to be decompressed before you can use them.

  1. Delete the modified package file.
  2. Copy the compressed package file to the directory the file belongs in.
  3. Decompress the file.
    Package files are UZ- or UZ2-compressed. Just run them through the UCC Decompress commandlet once they are in the correct directory and you are done. Here's a possible way for doing this:
    1. Open a console window. Under Windows you would do this by selecting Start -> Run... and enter "command" under Windows 98/ME in the dialog box, while under Windows 2000/XP you'd enter "cmd" there.
      You should now get the console window with a prompt that looks something like "C:\Windows>" and a cursor blinking after that.
    2. Change the drive to the one where your game is installed. For this example we have UT2004 installed in D:\UT2004, so type:

The prompt should now change to "D:\>".

    1. Change to your game's System directory, in our example this is UT2004\System, so type:
cd \UT2004\System

The propt should have turned into "D:\UT2004\System>" now.

    1. Now you're ready to decompress the file or files you want to restore. For each file you need to type "UCC Decompress filename" now. For example if you want to restore PlayerSkins.utx in the Textures directory you'd type:
UCC Decompress ..\Textures\PlayerSkins.utx.uz2

UCC will tell you that it decompresses that file to ..\Textures\PlayerSkins.utx for you. Repeat this step for every .UZ or UZ2 file you copied from the CD or DVD.

That's all. Try connecting to servers to see if the files were properly restored and whether you need to restore other files as well.

Related Topics