*** Unreal Tournament 2004 Advanced Configuration and Information Tool ***

[ UT2004 ACIT ]



With the Unreal Tournament Advanced Configuration and Information Tool, "UT2004 ACIT", you can easly show information about your UT2004 and also change a lot of settings, like Maps, Videosettings and so on.

Table of Contents




~~~ Mini FAQ & Info ~~~

For what kind of people is this tool?
This tool is for all people who don't like searching in the Windows Explorer for single
UT2004-Config.-Files or Information about their UT2004. ACIT does all this in one tool,
in one file. You also can create User.ini-Profiles and administrate them in a comfortable way.
ACIT also supports a shell-extension for ZIP-Archives, that copies UT2004 content from a ZIP-file
to the UT2004 directories.

~~~ Installation ~~~

No Installation is needed.

Following files are shipped with UT2004 ACIT:

EN-Readme.htm This file
Readme.htm Readme file in german.
Changes.txt Latest changes in german.
EN-Changes.txt Latest changes
settings.xml ACIT settings
Lang.int English languagefile
Lang.det German languagefile
ACIT_DEMO.ico Picture that is used for file icon for UT2004 demos, if they are associated with ACIT.
UT2004ACIT.exe Executable of UT2004 ACIT.


Extract all files from the archive you have download into a directory of your choice.
Run UT2004ACIT.exe to start UT2004 ACIT.

System requirements
 HINT:
An active internet connection is required for the update function.

HINT for users who work with limited rights:
UT2004 ACIT needs read access to the registry root HKEY_LOCAL_MACHINE to be able to read out the Unreal Tournament 2004 directory automatically.
If you do not have access to HKEY_LOCAL_MACHINE >you must speficy the path to your UT2004 installation manually.
You need read and write access to the directory of UT2004 ACIT to be able to save your settings and use dependant functions.
If you do not have read and write access to the settings.xml in the UT2004 ACIT directory you will not be able to use UT2004 ACIT.
You need read and write access to the cache.xml file for the Map Manager Caching function to work.
Some functions also need read and/or write access to the UT2004 directory and its sub directories.


~~~ Known Problems ~~~

  1. In the "Ini-Editor" menu not all values from the section "Engine.GameEngine" in the UT2004.ini file are shown.
    Solution: Use the built in ServerPackage Editor. You can reach it by selecting "File" -> "ServerPackage Editor".

  2. The overwrite-prompt dialog that is shown while installing UT2004 content is not completely localized (Title and Buttons are still in German).
    Translation:
    • Ja --> Yes
    • Ja zu allen --> Yes to all
    • Nein --> No
    • Abbrechen --> Cancel

~~~ Using UT2004 ACIT ~~~

Menu "Configuration":
When the program is started the first time, the UT2004 directory must be specified here.
If you have administrator rights on your computer, you can let ACIT search for the UT2004-Path in the Windows Registry.
You can choose a language by selecting it at the bottom of the window and clicking on "Apply".
You can also switch your acticve User.ini-Profile (more about profiles: see below).
The advanced configuration menu is also accessible from here.


Menu "Statistics":
There are shown a few statistics from your UT2004 in this menu,
which you can refresh by clicking on "Refresh" if you (for example) have changed the directory.
You will also find a button for opening the ut2004 directory here.

Menu "System-Integration":
You can integrate UT2004 ACIT in your system.
You can enable the shell-extensions for zip-archives and / or file-foders here and also associate demo files with ACIT to open them with the Explorer.

Menu "UT2004 Settings":
Select this menu, if you want to change your playername, your playermodel or basic video settings.
To save the changes, click on "Save".
Furthermore, the currently used CD-Key is shown in this menu.

Menu "Ini-Editor":
You can edit any Ini-File in this menu. The Ini-File is shown in a tree view.
A lot of UT2004-related Ini-Files are already available to open them quickly.

Menu "Map Manager":
All maps from the UT2004 Maps-directory are shown in this menu.
Map Information is also displayed (Name, Filesize, Gametype, and so on).
Options to play the map, to copy it into another folder or install a map from another directory into the map directory.
Furthermore the maps can be installed from archives and also be imported into archives.
The first time a map is selected it probably takes one or two seconds till the map information ("title", "author" and "description") is loaded from the file.
After that the information can be accessed much faster.
Alternatively you can enable the cache for the map entries.

Menu "Demos":
Here you can view demos, extract and add them from/to archives.
You are also able to associate .demo4-Files with UT2004 ACIT.

Menu "Cache Manager":
Here you can administrate the so called "Cache" of UT2004.
Items in the Cache can be cleared or installed and the Cache can also be cleared completely.

Menu "Add-Ons (*.u)":
A lot of UT2004-Mods are shipped as .u-Files.
In this Menu you can copy them (including the mods related Files) into your System-Folder and also delete such files from that folder.

Menu "Screenshots":
Usually you can make Screenshots in UT2004 by hitting the F9 Key.
These Screenshots are saved in the Screenshot-Folder with the name Shot?????.bmp (? represents the Index of the Picture).
With ACIT you can show a little Preview of the Screenshots.
The Screenshots also can be moved or copied into another directory.
They can be with "JPEG"compressed, too. (Imagefile-Bounds: 1024x768; Size BMP: 2.25MB, Size JPEG: 0.15 MB)

Menu "Profile":
The profiles can be shown and activated with the ComboBox in this menu.
With the Buttons in profile box, you can change the profile, rename it, or edit the profile.
By hitting the button "Create new profile" a new profile is created - based on the current User.ini in the System-Folder.
By hitting "Create new profile from..." you can speficy your own User.ini which the new profile will base on.
You also can create a backup of your current User.ini and you are also able to resotre Backups.
When ACIT is started the first time, a backup of the active user.ini will be created (if there are not any other backups).

Menu "About":
About UT2004 ACIT. You find information about ACIT, links to the project page of ACIT (German) and also the link to the update function.
Watch out for the newest versions of ACIT!

The Archive Inspector:
UT2004 ACIT has a built-in Archive Inspector for viewing and editing ZIP-archives.
You can reach the Archive Inspector in the menu &qout;File" -> "Archive Inspector".
Note: Some functions of the Archive Inspector are disabled when no archive is open.

The ServerPackage Editor:
UT2004 ACIT has an built-in editor for editing the "ServerPackages" in the Engine.GameInfo section of the UT2004.ini file.
ServerPackages are Add-Ons (Mutators, Voice-Packs, etc.) that are used in the game.
You can disable one or more entries temporarly by unchecking the checkbox that is located left to the entry. Re-enable it by checking the checkbox.


~~~ Installing UT2004 contents ~~~

UT2004 ACIT gives you the opportunity to install UT2004 contents from a zip archive.
This means that all files in the archive will be analyzed and moved to the correct UT2004 folder automatically.
No tiring manual extraction of the files and speculating about the correct folder any more - with UT2004 ACIT that is a thing of the past!
You can select the archive to be installed in the menu "File" -> "Install UT2004 contents..." -> "...from archive".

New in Version 1.4!
You can also enable a shell extension for file folders. With this shell extension you can install contents from whole file folders.
Not just archives, even normal files are moved to the right UT2004 directory. You can also select if you want to recurse sub directories, or not. Alternatively you can install one more files by using the corresponding item in the main menu.


~~~ The cache function of the Map Manager ~~~

UT2004 ACIT offers you to save the data of a UT2004 Map in the file cache.xml, so that map information is reachable much faster.
If the cache is not enabled the map must be accessed every time to extract the information. Enabling the cache can cause that the cached information are out-dated.
In this case select "File" -> "Cache" -> "Update Cache" in the main menu.
New maps are also cached when their information is accessed the first time.
Generally, its recommended to enable the cache. You should not enable the cache, if your map data is changed very frequently.

~~~ Parameters for UT2004ACIT.exe ~~~

UT2004 ACIT can be controlled with parameters to the UT2004ACIT executable.

Hint: UT2004 ACIT will be closed automatically after the action has been performed.

Following parameters are possible:

Hint: Parameter that are closed in [] are optional parameters.
When using them you have to remove the []

Hint: File- or foldernames that include spaces must be put in double quotes.


  1. UT2004ACIT.exe /install "<elemnt>" [-s]

    All UT2004 contents of <element> will be installed.
    <element> can be a zip archive, a single file of any type or a file folder.
    If subfolders are recursed or not is determined by the settings made in the "System Integration" tab.
    To use custom parameters for folders, use the "/installfolder" parameter described below.
    Specify the optional parameter -s to make a silent installation (no messages).

    Examples:
    UT2004ACIT.exe /install "C:\Downloads\UT2004\DM-Deck16.zip"
    UT2004ACIT.exe /install "C:\Downloads\UT2004\" -s

  2. UT2004ACIT.exe /installfolder "<path>" [-r] [-o]

    This option installs all archives from the folder specified in <path>
    Specify the optional parameter -r to include subdirectories of <path> for the file-search.
    Specify -o to overwrite files without confirmation (if not specified, a file that already exists, will not be overwritten)
    This option always has the silent-mode (-s) turned on.

    Example:
    UT2004ACIT.exe /installfolder "C:\Downloads\UT2004" -r -o

  3. UT2004ACIT.exe /playdemo "<filename>"

    Views the UT2004 Demo specified in <filename>

    Example: UT2004ACIT.exe /playdemo "C:\Downloads\UT2004\Fatal1ty_Vs_Me.demo4"

  4. UT2004ACIT.exe /installcache

    Installs the whole Cache of UT2004. The source files in the Cache will be deleted, after they have been installed.


You can create a shortcut to UT2004ACIT.exe to execute the parameters:
  1. Create a shortcut to the UT2004ACIT.exe file.

  2. Call the properties of the shortcut by selecting "properties" in the context menu of the file.

  3. Go to the "shortcut" tab and select the "target" field.

  4. You should see the following text in the edit field: "X:\UT2004ACIT.exe".
    (X:\ describes the path of UT2004 ACIT on your computer)

  5. Add the parameter after the last "

~~~ Licence ~~~

by David Fekete, May 13 2003, updated July 6 2003, July 17 2004

1. Licence
=========
THIS SOFTWARE WILL MADE BE AVAILABLE FOR YOU "AS IT IS", WITHOUT GUARANTEE IN ANY WAY.
YOU ARE ALLOWED TO SHARE THIS SOFTWARE.

THIS SOFTWARE MAY NOT USED FOR COMMERCIAL PURPOSES.


2. Responsability
==========
IN NO CASE THE AUTHOR CAN BE MADE RESPONSIBLE FOR ANY DAMAGE, NO MATTER
OF WHAT KIND.


3. COPYRIGHT
============
This software is both protected by copyrights laws and international copyright laws, and
through other laws and agreements about intellectual property.


4. Distribution
=============
The software can and shall be shared in the here offered form.
All rights remain at the author.
You may not sell or rent UT2004 ACIT, you may not redistribute it in a
not expliciteley allowed form to Thirds.
You may not change its files, reverse-engineer it or
disassamble the excuteables or other parts of UT2004 ACIT.


5. Salvatoric Clause
====================
If regulations of the present Treaty should not be feasible totally or
partly not legally effective and/or lose later its legal force and/or feasibility,
thereby the validity of the remaining regulations of the contract is not to be affected.
The same applies, as far as it should turn out that the contract contains a regulation gap.
In place of the ineffective and/or impracticable regulations or for filling out an appropriate
regulation is to apply for the gap, which, so far legally possible, comes next to intended regulation.


6. Copyrights
=============
All in ACIT or in one its textfile used hard- and softwarenames are trademarks or registred trademarks of their respective owners.

In case of translation errors, the valid licence is the german licence referred in the Readme.htm file!


~~~ Thanks to... ~~~

I would like to thank to....

Antonio Cordero Balcázar (http://www.acordero.org) for his TUTPackage Library.
Turbo Power for their Abbrevia Components (http://www.turbopower.com).
Khaled Shagrouni for his TXPMenu component (http://www.shagrouni.com/english/software/xpmenu.html).


~~~ Credits ~~~

UT2004 ACIT © 2003 - 2004 by David "mirage228" Fekete
mirage228@gmx.net
http://www.mirage228.net