Introduction

This document describes the functions of the sensobots servers. bin/sbserver is the gameserver, bin/sblistserver is a register server for gameservers that should be available from the internet. The IP address of the official sensobots listserver is resolved from the DNS name ragadaa.dyndns.org. You have to change src/Constants.h LSS_IP or use the command line option --internetip (see below) if you want to use another listserver. To execute the servers, you have to include "SystemV IPC" into your running kernel, because both servers use shared memory.

Installation

First download and extract the latest version of sensobots from the Downloads section. To compile both servers go to src/ and type 'make sblistserver sbserver'. The sbnet library should be available as described in the installation manual. The binaries will be placed in bin/. Remember to open the respective TCP ports in your firewall if needed (default ports: 56566 (listserver), 56567 and 56568 (gameserver)).

Listserver Options

The following commandline options are possible:

--help	Prints out all available listserver commandline arguments.
--version	Prints out the version of the listserver.
--conffile=<FILE>	This options sets <FILE> as configfile. There is a sample configfile included in the sensobots folder: doc/sblistserver.conf.
--logfile=<FILE>	Sets the logfile to <FILE>. Set <FILE> to /dev/stdout if you want to log to console (i.e. --logfile=/dev/stdout).
--loglevel=<LEVEL>	Sets the loglevel to <LEVEL>. <LEVEL> must be one of info, error, warn, verbose or debug.
--adminpass=<PASS>	sets the admin password to <PASS>. Because of the lame default password, you should definitely change it via commandline or configfile! Also note that this will be transmitted in cleartext, so don't choose any important system passwords!

Gameserver Options

You can use the following command line options for the sensobots gameserver:

--help	Prints out all available server options.
--version	Prints out the version of the server.
--conffile=<FILE>	Sets <FILE> as configfile. doc/sbserver.conf is a sample config file.
--logfile=<FILE>	Sets the logfile to <FILE>. Set <FILE> to /dev/stdout if you want to log to console (i.e. --logfile=/dev/stdout).
--loglevel=<LEVEL>	Sets the loglevel to <LEVEL>. <LEVEL> must be one of info, error, warn, verbose or debug.
--servername=<NAME>	Set the servername to <NAME>
--serverport=<PORT>	The server will listen on TCP port <PORT> for control data (i.e. new players, requests for serverdata, etc.). The default port is 56567
--adminpass=<PASS>	Sets the admin password to <PASS>. The same about lame default passwords and cleartext submission as mentioned earlier applies to this and the next password.
--serverpass=<PASS>	Sets the server password to <PASS>. See above...
--maxplayers=<NUMPL>	Set the maximum number of players to <NUMPL>. Current maximum is 4 players, but you can change the entry GS_MAXPLAYERS in src/Constants.h. There is no guarantee for a fast network play though...
--internet=<1|0>	Set to 1 if the server should be available for online play (i.e. register to a listserver). The default ist 0.
--internetip=<IP>	This option is intended for testing purposes. You can set a custom listserver IP address using this option which will be used by the server to register itself.