Difference between revisions of "Server Manual"

From Tomb Raider Mod Launcher Wiki
Jump to navigation Jump to search
 
(13 intermediate revisions by the same user not shown)
Line 1: Line 1:
 
== Setting up the server ==
 
== Setting up the server ==
  
To setup the server you will need to first download it.
+
To set up the server you will need to first download it.
  
 
You can download the latest version of the server from our [http://tombraidermodlauncher.co.uk/downloads/ downloads page].
 
You can download the latest version of the server from our [http://tombraidermodlauncher.co.uk/downloads/ downloads page].
  
You will need to extract the archive, I recommend that you use [http://www.7-zip.org/download.html 7-zip].
+
You will need to extract the archive, I recommend that you use [http://www.7-zip.org/download.html 7-Zip].
  
 
Once you have extracted the archive you will find it contains the server executable, example resources and the example server.xml configuration file.
 
Once you have extracted the archive you will find it contains the server executable, example resources and the example server.xml configuration file.
Line 13: Line 13:
 
To configure the server you will need to open server.xml in Notepad or [http://notepad-plus-plus.org/ Notepad++].
 
To configure the server you will need to open server.xml in Notepad or [http://notepad-plus-plus.org/ Notepad++].
  
Once you got the configuration file open you should then see the contents of it like below.
+
If the file doesn't exist you will need to create it, be sure to name it "server.xml" without the quotes.
 +
 
 +
Once you've got the configuration file open, you should then see the contents of it like below:
  
 
<syntaxhighlight lang="xml">
 
<syntaxhighlight lang="xml">
Line 24: Line 26:
  
 
<!--
 
<!--
Sets the total number of people that can be in the server at 1 time
+
Sets the gamemode the server is running.
 +
This is generally used for the server listing.
 +
It is required that you specify a value for this.
 +
-->
 +
<gamemode>Free Roam</gamemode>
 +
 
 +
<!--
 +
Sets if the server will be added to the public server listing.
 +
 
 +
Default: DISABLED
 +
 
 +
To enable this set to ENABLED.
 +
-->
 +
<serverbrowser>ENABLED</serverbrowser>
 +
 
 +
<!--
 +
Sets the total number of people that can be in the server at one time.
 
Default: 32
 
Default: 32
 
Max: 128
 
Max: 128
Line 36: Line 54:
 
-->
 
-->
 
<port>22000</port>
 
<port>22000</port>
 +
 +
<!--
 +
Sets the TCP port for the server to listen on.
 +
Default: 22000
 +
Range: 0-65535
 +
-->
 +
<httpport>22000</httpport>
  
 
<!--
 
<!--
Line 116: Line 141:
  
 
<!--
 
<!--
RESERVED
+
Specifices the path to the folder server will store the logs.
 
 
The idea of this flag is to set if remote laras are considered friends or foes.
 
Possibly made redundant with team support.
 
-->
 
<laraenemy />
 
  
<!--
+
If blank then logging is disabled.
RESERVED
 
  
The idea of this is to change the level flags.
+
Default: no log files
Can include young lara, lightning etc.
 
 
-->
 
-->
<levelflags />
+
<logpath>logs</logpath>
  
 
<!--
 
<!--
 
Use this to add resources to the server.
 
Use this to add resources to the server.
  
Resources can control anything the server supports through the use of squirrel.
+
Resources can control anything the server supports through the use of Squirrel.
 
-->
 
-->
 
<resources>
 
<resources>
Line 146: Line 164:
  
 
If the option is enabled or disabled you would use <strong>ENABLED</strong> or <strong>DISABLED</strong> to toggle the value.
 
If the option is enabled or disabled you would use <strong>ENABLED</strong> or <strong>DISABLED</strong> to toggle the value.
 +
 +
You can specify a command line argument to the server for the configuration file to use, this can be useful for hosting multiple servers and sharing the resources.
  
 
== Server port ==
 
== Server port ==
  
The port that you need to allow for the server is in the port field.
+
The UDP port that you need to allow for the server is in the port field.
  
 
<syntaxhighlight lang="xml">
 
<syntaxhighlight lang="xml">
Line 158: Line 178:
 
-->
 
-->
 
<port>22000</port>
 
<port>22000</port>
 +
</syntaxhighlight>
 +
 +
The TCP port that you need to allow for the server is in the httpport field. This port is required to download any files the server provides to the client and for any HTTP capabilities.
 +
 +
<syntaxhighlight lang="xml">
 +
<!--
 +
Sets the TCP port for the server to listen on.
 +
Default: 22000
 +
Range: 0-65535
 +
-->
 +
<httpport>22000</httpport>
 
</syntaxhighlight>
 
</syntaxhighlight>
  
Line 164: Line 195:
 
== Resources ==
 
== Resources ==
  
The server runs resources which control various aspects of the game and what logic should be processed. To create a resource you should look into [[Resources]].
+
The server runs resources which control various aspects of the game and what logic should be processed.
 +
 
 +
To create a resource you should look into [[Resources]].
 +
 
 +
To add a resource to the list of resources that are started you simply add an entry for it in the configuration.
  
To add a resource to the list of resources that are started you simply add an entry for it in the configuration. See the resources section below for an example.
+
See the resources section below for an example:
  
 
<syntaxhighlight lang="xml">
 
<syntaxhighlight lang="xml">
Line 172: Line 207:
 
Use this to add resources to the server.
 
Use this to add resources to the server.
  
Resources can control anything the server supports through the use of squirrel.
+
Resources can control anything the server supports through the use of Squirrel.
 
-->
 
-->
 
<resources>
 
<resources>

Latest revision as of 18:39, 16 August 2014

Setting up the server

To set up the server you will need to first download it.

You can download the latest version of the server from our downloads page.

You will need to extract the archive, I recommend that you use 7-Zip.

Once you have extracted the archive you will find it contains the server executable, example resources and the example server.xml configuration file.

Configuring the server

To configure the server you will need to open server.xml in Notepad or Notepad++.

If the file doesn't exist you will need to create it, be sure to name it "server.xml" without the quotes.

Once you've got the configuration file open, you should then see the contents of it like below:

<server>
	<!--
		Sets the name of the server, this would be used for the list of servers.
		It is required that you specify a value for this.
	-->
	<servername>Playable Tutorial Level</servername>

	<!--
		Sets the gamemode the server is running.
		This is generally used for the server listing.
		It is required that you specify a value for this.
	-->
	<gamemode>Free Roam</gamemode>

	<!--
		Sets if the server will be added to the public server listing.

		Default: DISABLED

		To enable this set to ENABLED.
	-->
	<serverbrowser>ENABLED</serverbrowser>

	<!--
		Sets the total number of people that can be in the server at one time.
		Default: 32
		Max: 128
	-->
	<maxplayers>128</maxplayers>

	<!--
		Sets the UDP port for the server to listen on.
		Default: 22000
		Range: 0-65535
	-->
	<port>22000</port>

	<!--
		Sets the TCP port for the server to listen on.
		Default: 22000
		Range: 0-65535
	-->
	<httpport>22000</httpport>

	<!--
		Sets the password for the server.

		If blank then no password is required to connect.

		Default: no password
	-->
	<password></password>

	<!--
		Sets the game engine the server works with.
		Possible values:

		II_RELEASE
		III_RELEASE
		IV_RELEASE_PATCHED
		IV_EDITOR
		IV_DEMO_TIMES
		IV_RELEASE
		IV_DEMO
		V_RELEASE_PATCHED
		V_RELEASE
	-->
	<engine>IV_EDITOR</engine>

	<!--
		Sets the map that the server works with.
		The value is the index of the map.
		For example with TRLE:
			0 - title screen
			1 - playable tutorial level
			2 - tomb of seth
			...
	-->
	<map>1</map>

	<!--
		Sets the OCB to read of the LARA_START_POS to spawn at.
		Default: 0

		See this for more information:
			http://www.trsearch.org/Tutorial.php?action=gettut&id=32

		If you don't understand this then just use zero.
	-->
	<larastartpos>0</larastartpos>

	<!--
		Controls some tweaks to the game.
		Default: 0

		Flag 1 = Disable camera trigger type
		Flag 2 = Disable flyby trigger type
		Flag 4 = Disable AI objects (guide, voncroy, baddy1 etc.)
		Flag 8 = Disable finish trigger type

		To get the number below add up the numbers above to enable what you want :)
	-->
	<flags>13</flags>

	<!--
		Set if FlyCheat from the script is enabled.

		Default: DISABLED
		
		To enable this set to ENABLED.
	-->
	<flycheat>DISABLED</flycheat>

	<!--
		Set if modified executables are allowed.

		Default: DISABLED

		To enable this set to ENABLED.
	-->
	<allowmoddedexecutables>DISABLED</allowmoddedexecutables>

	<!--
		Specifices the path to the folder server will store the logs.

		If blank then logging is disabled.

		Default: no log files
	-->
	<logpath>logs</logpath>

	<!--
		Use this to add resources to the server.

		Resources can control anything the server supports through the use of Squirrel.
	-->
	<resources>
		<resource src="joinquit" />
		<resource src="chat" />
	</resources>
</server>

All the options have comments on them specifying what they do to the server.

If the option is enabled or disabled you would use ENABLED or DISABLED to toggle the value.

You can specify a command line argument to the server for the configuration file to use, this can be useful for hosting multiple servers and sharing the resources.

Server port

The UDP port that you need to allow for the server is in the port field.

	<!--
		Sets the UDP port for the server to listen on.
		Default: 22000
		Range: 0-65535
	-->
	<port>22000</port>

The TCP port that you need to allow for the server is in the httpport field. This port is required to download any files the server provides to the client and for any HTTP capabilities.

	<!--
		Sets the TCP port for the server to listen on.
		Default: 22000
		Range: 0-65535
	-->
	<httpport>22000</httpport>

You will need to look into how to allow the port as this various by modem. It is generally refered to as port forwarding.

Resources

The server runs resources which control various aspects of the game and what logic should be processed.

To create a resource you should look into Resources.

To add a resource to the list of resources that are started you simply add an entry for it in the configuration.

See the resources section below for an example:

	<!--
		Use this to add resources to the server.

		Resources can control anything the server supports through the use of Squirrel.
	-->
	<resources>
		<resource src="joinquit" />
		<resource src="chat" />
		<resource src="deathmatch" />
		<resource src="deathmessages" />
		<resource src="deathpickups" />
	</resources>

Starting the server

When you have setup your server to however you wish to have it setup you can then double click on "server.exe" and then the server will start.

Server Started

Once your server is started you will need to get your IP address and note down the port.

The format you need to give people your server address is as follows, "IP:PORT" without the quotes and you will need to replace IP with your IP address and the port with the port as defined in the configuration of the server.

Here is an example:

85.150.200.200:22000

Note: This is not a real IP address it is just an example. If you need the default server it is "jack9267.duckdns.org:22000" without the quotes.