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

[ UT2003 ACIT ]



With the Unreal Tournament Advanced Configuration and Information Tool, "UT2003 ACIT", you can easly show information about your UT2003 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
UT2003-Config.-Files or Information about their UT2003. 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 UT2003 content from a ZIP-file
to the UT2003 directories.

~~~ Installation ~~~

No Installation is needed.

Following files are shipped with UT2003 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 UT2003 demos, if they are associated with ACIT.
UT2003ACIT.exe Executable of UT2003 ACIT.


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

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

HINT for users who work with limited rights:
UT2003 ACIT needs read access to the registry root HKEY_LOCAL_MACHINE to be able to read out the Unreal Tournament 2003 directory automatically.
If you do not have access to HKEY_LOCAL_MACHINE >you must speficy the path to your UT2003 installation manually.
You need read and write access to the directory of UT2003 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 UT2003 ACIT directory you will not be able to use UT2003 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 UT2003 directory and its sub directories.


~~~ Known Problems ~~~

  1. In the "Ini-Editor" menu not all values from the section "Engine.GameEngine" in the UT2003.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 UT2003 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 UT2003 ACIT ~~~

Menu "Configuration":
When the program is started the first time, the UT2003 directory must be specified here.
If you have administrator rights on your computer, you can let ACIT search for the UT2003-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 UT2003 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 ut2003 directory here.

Menu "System-Integration":
You can integrate UT2003 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 "UT2003 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 UT2003-related Ini-Files are already available to open them quickly.

Menu "Map Manager":
All maps from the UT2003 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 UT2003 ACIT.

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

Menu "Add-Ons (*.u)":
A lot of UT2003-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 UT2003 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 UT2003 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:
UT2003 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:
UT2003 ACIT has an built-in editor for editing the "ServerPackages" in the Engine.GameInfo section of the UT2003.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 UT2003 contents ~~~

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

UT2003 ACIT offers you to save the data of a UT2003 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 UT2003ACIT.exe ~~~

UT2003 ACIT can be controlled with parameters to the UT2003ACIT executable.

Hint: UT2003 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. UT2003ACIT.exe /install "<element>" [-s]

    All UT2003 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:
    UT2003ACIT.exe /install "C:\Downloads\UT2003\DM-Deck16.zip"
    UT2003ACIT.exe /install "C:\Downloads\UT2003\" -s

  2. UT2003ACIT.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:
    UT2003ACIT.exe /installfolder "C:\Downloads\UT2003" -r -o

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

    Views the UT2003 Demo specified in <filename>

    Example: UT2003ACIT.exe /playdemo "C:\Downloads\UT2003\Fatal1ty_Vs_Me.demo4"

  4. UT2003ACIT.exe /installcache

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


You can create a shortcut to UT2003ACIT.exe to execute the parameters:
  1. Create a shortcut to the UT2003ACIT.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:\UT2003ACIT.exe".
    (X:\ describes the path of UT2003 ACIT on your computer)

  5. Add the parameter after the last "

~~~ Licence ~~~

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

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 UT2003 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 UT2003 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 ~~~

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