UnrealTournament Linux Installation Notes

The general game release notes can be found in /Help/ReadMe.htm on 
the CD.  Please refer to them before you start to play, because there
is a lot of useful information!

I. Installation

Please read through all of this information before you begin your
installation.  It will help you solve problems before they start!

1. First, make sure that you have a drive with enough free space.  Unreal
Tournament requires around 500 megabytes to install.  The install
program will show you the free space you have on the filesystem you
chose to install to.

2. DO NOT INSTALL THE GAME AS ROOT.  If you do, all of the installed files
will be owned by root and only the root user will be able to play the
game.  The installed game will have the same permissions as the user you
run the installer with.

3. Mount your CD-ROM drive before running the install program.  This
is usually done by typing 'mount /mnt/cdrom' as root.  If you have
changed your cdrom mount point, mount it as usual.

4. Start X windows.  You'll need to be in X to install and play
Unreal Tournament.

5. Run the install program loader script './setup.sh'  This program
will make sure your current version of glibc and your platform
architecture are compatible with Unreal Tournament.

6. Follow the onscreen instructions to install the game content.

Unreal Tournament currently uses a central configuration file located
in the System directory (UnrealTournament.ini).  Keyboard and user
configuration information is stored in User.ini.  A future release
will support per-user configuration files.

If you do not have a sound card, don't have /dev/dsp, or don't have kernel
sound support directly or through modules, start Unreal Tournament with
the -nosound option.

If you have difficulty running Unreal Tournament, send a bug report to
utlinuxbugs@epicgames.com.  Try to include a copy of your 
UnrealTournament.log file.

II. Video Issues

This distribution of Linux UT only supports 3dfx cards and the Glide rendering library.  I have plans to develop a Mesa renderer as well.

III. Sound Issues

If sound is too loud, run a mixer program and turn down your main volume.
I've noticed that Linux usually starts with the MAIN volume way too
high.

The Linux version of Unreal Tournament does not play music.

IV. Keyboard Issues

Some players have reported being unable to use their keyboard's numpad
in Unreal Tournament.  If this happens, try adding the line
XkbDisable to your XF86Config like so:

Section "Keyboard"
  Protocol "Standard"
  XkbRules "xfree86"
  XkbModel "pc104"
  XkbLayout "us"
 XkbDisable
EndSection

V. Mouse Issues

Linux UT has full mouse wheel support.  You'll need to be running XFree86
3.3.2 or better.  Open your XF86Config file and add
	ZAxisMapping 4 5
to the Pointer section.  This will bind MouseWheelUp and MouseWheelDown
to X server button events 4 and 5.
The Linux UT client currently does not support a 6th (thumb) button, but
I'll add it when I get a chance.

VI. Starting a Dedicated Server.

The best way to configure a server is to start a basic server and then 
configure it using the remote administration tool.  Change to the 
utdemo/System directory and edit the UnrealTournament.ini.  Do a search for 
the [UWeb.WebServer] section and set bEnabled=True.  This will enable remote 
server administration.  Start your server using the following command: 

> ucc server DM-Turbine

This will start a deathmatch server on the Turbine map.  Its important to use 
the correct case when specifying the startup map as the demo map check is case 
sensitive right now (this will be fixed soon).

Now that your server has started, open up Netscape and connect to your server:

http://127.0.0.1/ServerAdmin/

Username: admin
Password: admin

You can change the username and password under the [UTServerAdmin.UTServerAdmin] section in the UnrealTournament.ini.

Configure your server using this interface.  You might need to change the 
ListenPort for the server web interface inside the UnrealTournament.ini

Alternatively, you can configure your server using the "Start New Internet 
Game" option inside the client.  Hit "Dedicated" to start the server once 
you've chosen your options.

Refer to UT documentation on unreal.epicgames.com for further information.

VII. Build Notes

This was built under RedHat 6.0 (Hedwig) on a 2.2.9 kernel/glibc 2.1.1 with 
gcc 2.95.1.  Hacked using Code Crusader 2.1.2 
(http://www.cco.caltech.edu/~jafl/jcc/) and doctored using 
Code Medic 1.0.2 (http://www.its.caltech.edu/~glenn/medic/).

VIII. ngStats Configuration

First things first.  Snag a Java distribution from www.blackdown.org.  Its 
easy to install and its a good thing to have.  You can't run ngStats without 
one.  Get the latest JDK 1.2 "Preview Release."  The current one is PR2.

Here is an FTP URL for the lazy:

ftp://iodynamics.com/pub/mirror/linux-jdk/JDK-1.2/i386/pre-v2/glibc2.1/

You might need to get bzip2 to uncompress it.  Just search metacrawler and show some adaptability.

Now.  Change directory to NetGamesUSA.com/ngStats/

Open up "spawnBrowser.exe" and change the lines to call netscape instead of
echo by commenting and uncommenting as needed.

Then open up "ngStatsUT" with your favorite editor.  Change the variables 
inside there to fit your needs.  Specifically, point NGHOME to 
/myUTpath/NetGamesUSA.com/ngStats and JAVA to wherever you installed the JDK 
(point to the java binary).

Don't mess with the stuff at the bottom.  Just save the file and you are 
ready to rock.

When you select "View Local Stats" or "View World Stats" from inside of 
Unreal Tournament, Netscape will launch to the appropriate URL (and 
compile your local stats if that's what you are looking at).  Hit 
alt-tab to view them.

IX. Bug reports.

Direct bug reports to utbugs@epicgames.com

X. Other.

Source for the installer, by Loki Entertainment is available at
unreal.epicgames.com.

Brandon Reinhart
Epic Games, Inc.
