# Unreal Tournament Dedicated Server

## Readme.htm for Version 428

Copyright (C) 2000 Epic Games

### Introduction

Thanks for downloading the Unreal Tournament dedicated server. This installation contains a modified version of Unreal Tournament with just the files needed to run the game in dedicated server mode. These files are made available for use entirely at your own risk. You may not use the Unreal Tournament Dedicated Server for any purpose other than to run an Unreal Tournament server. We encourage you to run as many servers as possible, and to install and run custom maps and mods on your servers.

### Useful Web Links for Server Administrators

#### Epic Sites

- Unreal Technology Page -- Latest news from the UT development team, along with technical documentation and the latest official UT downloads. The current Running UT Servers document (for the full version of Unreal Tournament) is available from the Tech Page.
- Unreal Tournament Home Page -- Visit for the latest updates, patches, and community events!
- Epic Games Home Page -- Information about other Epic games.

#### Other Sites

- The Admin Page -- A great resource for Unreal Tournament server administrators.
- Planet Unreal -- An Unreal Tournament News site.
- Unreal Universe -- An Unreal Tournament News site.
- UnrealTournament.org -- An Unreal Tournament News site.

### Starting a Server

The setup program will have created a shortcut titled "Start UT Server" in your Start Menu. This shortcut will start a simple, unconfigured deathmatch server. Once the server is running, you should use the remote administration feature to configure your UT server. See the Remote Administration section below for more information.

#### Launching the Server from the Command Line

> The syntax for running a server from a command line is as follows:

> > C:\UnrealTournament\System> ucc.exe server mapname.unr?game=GameType [port=portnum] [multihome=ipaddress] [ini=inifilename] [log=logfilename]

> > port - the optional base port number the server uses.
> > ini - the name of the ini file the server uses. This defaults to UnrealTournament.ini
> > log - the name of the logfile the server generates. The default is ucc.log
> > multihome - the IP address the server should bind to, if your server has multiple local IP addresses.
> > GameType - specifies the game type. One of Botpack.DeathMatchPlus, Botpack.Domination, Botpack.CTFGame, Botpack.LastManStanding..

> Some examples:

> > ucc server dm-Turbine?game=Botpack.DeathMatchPlus ini=server1.ini log=server1.log
> > ucc server ctf-coret?game=Botpack.CTFGame ini=server2.ini log=server2.log multihome=204.12.54.28
> > ucc server dom-Sesmar?game=Botpack.Domination ini=server3.ini log=server3.log multihome=204.12.54.29

> It's a good idea to make a small batch file which automatically restarts the server should it crash:

> > :top
> > c:
> > cd \unrealtournament\system
> > ucc server dm-Turbine?game=Botpack.DeathMatchPlus ini=server1.ini log=server1.log
> > copy server1.log server1crash.log
> > goto top

> Should you get a server crash, please mail the log file to utbugs413@epicgames.com.

#### Multiple Servers Per Machine

> Each instance of the UT dedicated server can serve one and only one level at a time.

> However, you can run multiple servers on one machine. Each instance of the server should have its own unique copy of the UnrealTournament.ini file, with its own configuration. This is specified with the ini command line option. If you want to enable remote administration on multiple servers on the same machine, and you're not using multihome to specify a unique IP address to bind to, you'll need to give each webserver a unique ListenPort number.

> You should give each server a unique base UDP port number. UT's default port number is 7777. To specify a port, use the port command-line option as shown above. Be sure to space the port numbers 10 apart as each server requires a number of UDP ports. eg:

> > ucc server ctf-coret?game=Botpack.CTFGame ini=server1.ini log=server1.log port=7770
> > ucc server dom-Sesmar?game=Botpack.Domination ini=server2.ini log=server2.log port=7780

> Some Windows NT servers have more than one IP address defined (under Advanced in the TCP/IP control panel). If this is the case, you can run multiple servers on the same machine without configuring different port numbers. Specify the IP address for the server to listen on using the multihome option. This batch file starts two servers, each binding to a different IP address.

> > start ucc server ctf-coret?game=Botpack.CTFGame ini=server1.ini log=server1.log multihome=204.12.54.28
> > start ucc server dom-Sesmar?game=Botpack.Domination ini=server2.ini log=server2.log multihome=204.12.54.29

### Remote Administration

Once the server is up and running, you can access your Unreal Tournament server with any web browser. Internet Explorer 4 or 5 is recommended, but it should also work fine with Netscape 4. To access your UT server from a web browser running on the server machine, Use the following URL to access the remote administration:

> http://127.0.0.1:8888/ServerAdmin

A shortcut to this link was added to the Start Menu named "WWW Remote Admin my UT Server". You can substitute 127.0.0.1 for the IP address of your server to administer it from a web browser on another computer.

When you bring up the remote admin URL, your web browser will prompt you for a username and password. The default username and password are both "admin". You should change the password username and/or password by exiting the UT server and then editing your UnrealTournament.ini file and changing the lines which say:

> [UTServerAdmin.UTServerAdmin]
> AdminUsername=admin
> AdminPassword=admin

The remote admin is divided into two parts:

- Current - Administer the current game in progress - view the player list, kick/ban players, add bots, change the current map, access the server console and chat to players.
- Defaults - Change the map list, rules and settings for each game type, configure server-level options, and administer the IP ban list.

You'll want to change the following Defaults | Server options the first time you configure your server.

- Server Name - the name of your server
- Advertise Server - check this on to advertise your server to the master server
- ngWorldStats Logging - tcheck this on to have your server participate in ngWorldStats for UT.

### Performance

- Make sure to match the maximum number of players for your server to the bandwidth you have available. The amount of bandwidth required for each user is determined by the MaxClientRate, which is set by default to 20000 bytes/sec. If your connection is bandwidth limited (for example a cable modem), you should reduce this value (you can edit your UnrealTournament.ini file in your UnrealTournament\system directory - MaxClientRate is in the [IpDrv.TcpNetDriver] section). Make sure that the MaxUsers multiplied by the MaxClientRate is less than your available bandwidth (in the case of cable modems or xDSL, your upstream bandwidth).