UnrealTournament Linux Installation Notes Version: 400A Latest News: - See the changelog for the latest changes. - I'm making good progress on the Mesa renderer. - I'm working on setting up a Bugzilla database for tracking bugs in the Linux version. - Soon I will open source the Linux code and accept code contributions from the community. - The UT port doesn't work with the Enlightenment window manager at all. I'll be looking into this problem soon. - Apparently, you can run a UT server under FreeBSD. I don't know about playing the client, though. [A version changelog is available at the bottom of this readme.] 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! O. Pre-Installation Make sure you have libxml and libglade installed on your system prior to installing UT. These libraries can be found in the lib directory of the installer archive. You need to have Joilet ISO9660 extensions compiled into your kernel in order to install from the CD-ROM. Most distributions come with kernels that support this, but if you can't see "long file names" on the mounted CD-ROM, you'll need to rebuild your kernel. 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. Make sure the directory you want to install to is writable by the user you want to install as. 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. 7. After you have installed, you will want to turn of DGA mouse input if you are running XFree86 3.3.3. You can do this by editing UnrealTournament.ini (or Default.ini if this is your first run) and setting DGAMouseEnabled to false. 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. CHANGELOG: 400A Installer: - Removed check for setup_menuitems_checkbox. - Removed redundant (and incorrect) Default.ini from archives. - Added checks for missing libraries. Core.so: - Added Erik's new bit copier. - Removed guarding for release builds. Render.so: - Added Mike D's new FLightManager::Merge function. XDrv.so: - Added DGA input support (DGAMouseEnabled).