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


                                UT-Start 2.0

                         (c) 2000 by Carsten Wellen

                                   README

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














   Table of Contents

1. Short Description

2. System Requirements

3. Installation

4. Deinstallation

5. Programm Functions

6. Problems

7. License

8. No Warranty

9. Contact the Author















1. Short Description

    Because Unreal Tournament (from now on called UT in this document)
    can handle only one User at a time (which is saved in the USER.INI)
    and Command line Switch USER= did not function, I have written this
    little tool. With this program you can handle and switch different
    Users and start UT.
    Each User will get his own set of USER.INI.
    This may be useful to play UT with different persons on one single
    computer (each have it's own player and ngStat), or for one person
    with more than one Player (one for the Single Player, one for LAN
    games and one for internet sessions).
    If you are an expert you can also manage different
    UNREALTOURNAMENT.INIs, which is helpful for server admins, because
    in the unrealtournamen.ini there are some mods, mutators, skins
    and engine settings.




2. System Requirements

    Computer.............:	100% compatible IBM PC
    System RAM...........:	64 MB (for UT of course, better 128)
    Operating System.....:	Microsoft Windows 9x/NT
    Input Devices........:	Keyboard and Mouse
    Additional Software..:	UT must be installed
    				(Tested with Patch 4.20)




3. Installation

    Unzip the Files to a directory of your choice.
    On the first run UT-Start will search for your UT installation.
    Please check this on the CONFIG page, and correct it, if 
    necessary.
    Then UT-Start will create a subdirectory called PROFILES at its
    location. If there is also an USER directory from UT-Start 1.0.x
    which contains some old profiles of you, then they will be
    converted into the PROFILES directory.
    After a look for an active profile at the UT installation it
    will create the first profiles which may be currently active.




4. Deinstallation

    You can easily delete the Program, its Ini file and the Read me.
    There is also a directory at the Program Location called PROFILES.
    This directory contains the different User and Server Profiles,
    which you can Backup for later use or delete manually.
    The last switched User will be the active User in UT from now on.




5. Program Functions

    The program handles different versions of two important .INI files
    from UT. The first is the USER.INI which is called user profile,
    and the second is the unrealtournament.ini which is called
    server profile.
    To manage the different versions UT-Start has a Subdirectory
    called PROFILES at its location.
    
    The program dialog is separated into different pages of control.
    Each one is described here.

    Config:
    On the Config page you can configure the program.
    You must enter the location, where your UT
    installation resists. You can use the Button with the three
    dots to open the Select Directory dialog and surf to your
    UT installation.
    On the first run UT-Start will try to search for UT.
    The Checkbox 'Close on running UT' means, that if you check
    this option, and run UT with this tool, then it will close
    itself immediately after launching UT. This gives you the
    memory free, that is otherwise used by this tool.
    With the 'Expert Mode' option you can switch on the
    server profile management. This will allow you to change the
    server profile on the start page, if you have more than once.
    Also there will be another page called 'Server Profiles' where
    you can manage your different profiles.
    Be careful with deleting profiles! In expert mode there will be
    no more warnings when you press the delete or edit button.
    With Texteditor you can configure your favourite texteditor
    (like notepad, ultraedit,...) which is called together with
    the selected profile, when you press the edit buttons.
    The 'Start Parameter' button opens a new dialog, where you
    can set some troubleshouting settings, if your UT did not
    run or hangs during startup. You can change your display
    device, view the log console during startup, and you can
    disable many different supports which make UT faster, but may
    be the reason for instability on your system.
    Please don't use these settings, if you don't know what you
    are doing!
    
    User Profiles:
    Under User Profiles you can manage your Users, you want to
    be controlled with this program to use them with UT.
    If you enter a new name in the box, you can add a new
    profile with the New button.
    You will be asked if you want to clone the active profile, or
    create from a default one.
    Clone creates a new user from the currently active profile
    which is found in unrealtournament/SYSTEM/user.ini.
    Default is found in unrealtournament/SYSTEM/defuser.ini.
    The Profile get renamed like the name you entered.
    After you have created a new User, you have to start UT to
    configure the new User's individual Skin, Controls and Bot
    configuration (cause the configuration is not part of
    UT-Start yet).
    If you enter a Name that already exists, or you have selected
    an existing user profile by the drop down list, you can delete
    it by pressing the Delete button.
    You can also edit it manually at your own risk with your
    favourite texteditor by pressing Edit.
    User profiles will be saved in the PROFILE subdirectory with
    filenames like up_xxxx.ini, where xxxx is a number from 0001
    to 9999 (so for example up_0001.ini).
    Notify, that the name of user profile (profile name) and the name
    of the playing character inside the profile (player name) are not
    the same. You set the profile name when you create it, and it must
    be unique from other existing user profiles.
    The player name instead is modified inside UT by the Character or
    Player options, and you can have many different user profiles
    with all the same player name. Lets show you an example:
    I have three userprofiles called
    'Carsten'		my normal UT profile
    'Carsten (TO)'	my profile for Tactical Ops
    'Carsten (RA)'	my profile for Rocket Arena
    with all different keyboard setups for reload/use and many
    other specific mod key bindings.
    But in all three userprofiles the player name is 'Carsten', so
    all statistics go to one player account on ngStat, and not to
    three different.
    
    
    Server Profiles:
    This page is only visible in 'expert mode' (see configuration).
    The functions are the same as in user profiles.
    Only the filenames are others.
    Clone means now the unrealtournament/SYSTEM/unrealtournament.ini.
    Default is found in unrealtournament/SYSTEM/default.ini.
    And server profiles are saved as sp_xxxx.ini.
    
    Start:
    User Profile will show the active user, which is the user you
    will be, when you start UT now with the Start button.
    With a drop down you can select another user profile
    (if you have more than once) before you start ut.
    The User will switch immediately after you have  selected a
    profile in the list.
    The old User profile will be saved, and the new User profile
    will be copied to the UT directory.
    Same for the server profile, but this is only active, if you
    have enabled the expert mode (see configuration).
    Start will start UT with the active user.
    Close will close the program.
    You can also press Enter to start, and Escape to exit.

    Info:
    Here you will get some information about the program.
    
    
    Command line parameters:
    --convert	will try to find profiles in a USER directory at
    		UT-Start2's location and convert them to new structure.




6. Problems

    You can fix problems yourself with a little handwork on
    the settings in UTSTART.INI and the up_xxxx.ini/sp_xxxx.ini in
    the PROFILES directory, where name is the old name of your
    renamed user.




7. License

    This Program is totally free. You have nothing to pay for it.
    (A quick email is not unwelcome (see under 9.)
    Give it to your friends, or place it on your web page.
    But please leave the package intact.
    Feel free to use it.




8. No Warranty (Terms of GNU License)

     11. BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY
   FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW.  EXCEPT WHEN
   OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES
   PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED
   OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
   MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.  THE ENTIRE RISK AS
   TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU.  SHOULD THE
   PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING,
   REPAIR OR CORRECTION.

     12. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING
   WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR
   REDISTRIBUTE THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES,
   INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING
   OUT OF THE USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED
   TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY
   YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER
   PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE
   POSSIBILITY OF SUCH DAMAGES.
   
   Unreal Tournament (c)1999 Epic Megagames, Inc.  All Rights Reserved.
   Distributed by GT Software, Inc. under license.  Unreal Tournament and the
   Unreal Tournament logo are registered trademarks of Epic Megagames, Inc.
   All other trademarks and trade names are properties of their respective
   owners.

   All trademarks mentioned in this readme or other where in this software
   package are the property of their respective owners.




9. Contact the Author

    Email:   cwel@cwel.de
             (I speak german and english)


    If you like this program, please send me an email.
    I'm interested in the way, you get this program,
    or the way the program goes in the internet.
    Write me also, if you have any suggestions.
    
    Please report all bugs.
    
    Thank you.





