The Webadmin

The webadmin is the single most valuable tool in server hosting. Contrary to the default UT2004 setup, the Troopers webadmin is enabled by default. It is strongly recommended to leave it this way. To disable the webadmin through the .ini file, open UT2004\Troopers\System\Troopers.ini (the .ini path may differ on Linux and Mac installations) in a text editor and find the line that reads bEnabled=True under the header of [UWeb.WebServer] and change “True” to “False”. Save the file. The web server is then disabled. In the normal situation that the webadmin is not disabled, it can be approached by simply browsing to http://serveriphere.

If you want to run your web admin on a different port than :80 (for example if you have multiple UT2004 servers with web administration interfaces running at the same time), you should specify the port under the same header like this: ListenPort=81. Be sure to change 81 to the preferred port.

When logging into the webadmin for the first time, use the following login info:

     Login: Admin
     Password: Admin

Remember to change the password from within the webadmin once logged in. If previous servers, ran on the retail version of UT2004, have been managed from the webadmin, the login and passwords used then should work for Troopers servers.

Troopers-Specific Server Settings

The Troopers-specific server settings for all game types may be configured from within the webadmin, the in-game Start Server menus, and in the .ini file. All settings are listed in the Troopers.ini file. To modify them, find the header of the game type for which settings need to be altered and change the related values. Note that the friendly fire and mirror damage scales are measured by the following conversion: 1.00 .ini = 100% in-game. 0.50 .ini = 50% in-game, and 0.1 .ini = 10% in-game.

The headers for the Troopers game types are as follows:

     Troopers Team Deathmatch > [TGame.TTeamGame]
     Troopers Capture the Flag > [TGame.TCTFGame]
     Troopers Objective Match > [TGame.TObjectiveGame]

Launching a Server

The simplest and most pain-free method of launching a server is by enabling the webadmin, then using one of the server launch scripts to start the server. Windows users should start the server with the TroopersServerWindows.bat batch file in the UT2004\System directory. Linux users should launch the TroopersServerLinux.sh. For OS X, TroopersServerMac.sh should be used. When running the servers from the commandline, any arguments that would normally be passed on the commandline to start a server may be passed to the batch scripts. While it is preferred to launch by just executing the file and then configuring the rest from the webadmin, game parameters may be passed directly if users are so inclined.

When running a Troopers server through the batch file, the file will ensure the server stays up, even should it suffer a crash. Should a crash occur, the server log file (named TServer.log) will be copied to TServerCrash.log, after which the server is automatically restarted. To break this loop and terminate the server, press Ctrl-C and then Y when asked if the batch process should really be terminated. Should a user not wish to utilize the batch file, additional parameters MUST be passed to ucc.exe for the server to work. Neglecting to do this will cause the server to work improperly. The proper way to launch a server through the ucc.exe file is:

     ucc server [MAPNAME]?game=[GAMETYPE] –mod=Troopers –log=tserver.log

Linux users may use the following commandline to launch through the ucc-bin:

     ucc-bin [MAPNAME]?game=[GAMETYPE] server -mod=Troopers log=tserver.log -nohomedir

Mac users may use the following commandline to launch through the ucc-bin-osx:

     ucc-bin-osx [MAPNAME]?game=[GAMETYPE] server -mod=Troopers log=tserver.log -nohomedir

In both cases, replace [MAPNAME] with the name of the map the server should start on, and [GAMETYPE] with the switch for what gametype is desired.

Below are the ?game switches used for the various Troopers gametypes:

     Troopers Team Deathmatch > ?game=tgame.tteamgame
     Troopers Capture the Flag > ?game=tgame.tctfgame
     Troopers Objective Match > ?game=tgame.tobjectivegame

Questions? Problems?

Should something goes awry with a server and it is a Troopers-specific problem, feel free to ask eXoR about it at #ut2004troopers on irc.gamesurge.net if he is around. He can also be e-mailed at eXoR@PlanetUnreal.com.