
Turok2 Dedicated Server
-----------------------

A Turok2 server consists of two executables: an Rtime server and a game 
manager.  The Rtime server handles Internet/LAN communication between game 
clients.  The game manager specifies the type of game being played and the 
rules of the game.  It also reports information about the game to GameSpy 
master servers and is used to arbitrate the connection between a player's 
Turok2 client and the Rtime server when a player joins a game.  Multiple games 
may be running on a single Rtime server.  For each game running on an Rtime 
server, there must be a corresponding game manager running.  Typically, you 
will run the game manager(s) on the same computer as the Rtime server.  
However, it is possible to run an Rtime server and a game manger on different 
computers (see the gm.cfg file for more information).

A package containing all the servers and necessary data files is available from 
http://www.turok.com.

There is (or will be soon) a version of the Rtime server and game manager for 
the following operating systems: 

Server Version	                Server Executable    Game Manager Executable
------------------------------- -------------------- --------------------------
Win32 (Win95, 98, NT)           rt_srv_win32.exe     gm_win32.exe
Sun (Solaris 5.5 or greater)    rt_srv_sun           gm_sun
SGI (Irix 6.2 or greater)       rt_srv_sgi           gm_sgi
Linux (RedHat 5 or greater)     rt_srv_linux         gm_linux

There are a few other files that must be present to run a server:

RT_System.txt    - contains configuration information for the Rtime server.
Rtserverdll.dll  - required by the Win32 version of the Rtime server.
gm.cfg           - contains game setup and other info.

To install the servers simply unzip the T2Servers.zip file into a new 
directory, for example, T2Servers.  The zip file contain's all the necessary 
files to run a Turok2 server on all the different platforms:

+ T2Servers +		
            | T2Servers.txt		
            | RT_Appkey.txt		
            | RT_System.txt		
            | Rtserverdll.dll		
            | rt_srv_win32.exe		
            | rt_srv_sgi	(coming soon!)	
            | rt_srv_sun	(coming soon!)	
            | rt_srv_linux       
            | gm_win32.exe		
            | gm_sgi             (coming soon!)
            | gm_sun             (coming soon!)
            | gm_linux           
            | gm.cfg		
            + data	+	
                        | Arena Levels.lsm
                        | CTF Levels.lsm
                        | Rok Match Levels.lsm
                        | . . .  possibly other .lsm files  . . .

 
To start a Turok2 server:

First, start an Rtime server:
o Locate the T2Servers directory (where the T2Servers.zip file was extracted).
o From the T2Servers directory, run the appropriate server executable file for 
  the platform.

And then, start a game manager:
o From the T2Servers directory, run the appropriate game manager executable for 
  the platform.

Notes about the Rtime server:
o Typically, the Rtime server will start running on port 12800.  If for any   reason this port is not suitable (for example, it is blocked by a firewall), 
  it can be changed by editing the RT_System.txt file.  Change the "port_base=" 
  line to reflect the desired port.  Also be sure to change the ServerPort key 
  in the game manager configuration file to reflect the new  server port.

Notes about the game manager:
o If a game other than the default specified in the gm.cfg file is desired, 
  edit the gm.cfg file to reflect the new game type.  See the gm.cfg file for 
  more details on customizing a game.  (Note that you must restart the game 
  manager for the changes to be effective.)

o The game manager can be forced to use a different configuration file than the 
  default gm.cfg file by passing a "-config filename" on the command line.  For 
  example, if the configuration file to be used is called arena.cfg, then run 
  it with "gm_win32.exe -config arena.cfg".

o The game manager must have access to the level set to be played.  Therefore, 
  any level set that is specified in a game manager configuration file must be 
  present in the data subdirectory of the of the working directory.  For 
  example, if you specify "LevelSet=Rok Match Levels" in the configuration 
  file, the level set file named "Rok Match Levels.lsm" must exist in the in 
  the data subdirectory directory. 

o When running multiple game managers on the same machine, each game manager 
  must be run with a unique configuration file and a unique port (specified in 
  the configuration file).  Up to 10 game managers may be run on a single Rtime 
  server.

o If a game manager is to be run on a LAN, it is better to specify the -lan 
  command line parameter.  This will enable a higher bandwidth version of the 
  game.  This option should NEVER be used for a game that will be played over a 
  modem (it will saturate the modem's bandwidth and the game will be 
  unplayable).

o If the game manager exits prematurely, you may refer to the log file for 
  diagnostic information.  The log file name will be the same as the 
  configuration file name with a .log extension instead of a .cfg extension.  
  For example, if the configuration file used was arena.cfg, then the log file 
  will be called arena.log.

General notes:
o On Unix platforms, file names are case sensitive, so be careful to match the 
  case when specifying a new configuration file for the game manager.
