Provided by: pioneers-console_0.12.5-1ubuntu1_i386 bug

NAME

       pioneers-server-console - command-line game server for Pioneers

SYNOPSIS

       pioneers-server-console [ -a port ] [ -c AI count ] [ -g game title ]
            [ -k seconds ] [ -m metaserver ] [ -n hostname ]
            [ -P player count ] [ -p port ] [ -R [0|1|2] ] [ -r ] [ -s ]
            [ -t minutes ] [ -T [0|1] ] [ -v points ] [ -x ]

DESCRIPTION

       This manual page documents briefly the pioneers-server-console command.

       Pioneers  is  an implementation of the popular, award-winning "Settlers
       of Catan" board game for the GNOME  desktop  environment.   It  uses  a
       client/server  model  for  networked  play  of  between  two  and eight
       players.  This program provides a  console-only  server  that  pioneers
       clients can connect to.

OPTIONS

       -a port     Listen for administrative commands on port port.

       -c num      Start up num computer players.

       -g game title
                   Load  the ruleset specified by game title. The title can be
                   found in the *.game files. You need quotes for titles  with
                   spaces.

       -k secs     Automatically stop the server if no one has connected after
                   secs seconds.

       -m metaserver
                   Register this server with the metaserver at  the  specified
                   address.

       -n hostname Use  this  hostname  instead  of  the  hostname reported by
                   hostname(1).

       -P num      Start a game for  num  total  players  (including  computer
                   players).

       -p port     Use port port for player connections.

       -R [0|1|2]  "Sevens  rule":  Specify  gameplay  behavior  when a player
                   rolls a seven.  A value  of  0  (the  default)  means  that
                   rolling  a  seven  always  moves  the robber.  A value of 1
                   requires the player to re-roll if a seven is rolled on  the
                   first  two turns.  A value of 2 means the player always re-
                   rolls.

       -r          Register with a meta server.  The meta server to use can be
                   overriden   with   the   -m  option.  Default  meta  sever:
                   pioneers.debian.net

       -s          Don't start the game immediately; wait for a command on the
                   admin port (-a) instead.

       -T [0|1]    Choose  a  terrain type: 0 for the default, or 1 for random
                   terrain.

       -t mins     Tournament mode: add AI players after mins minutes.

       -v points   Specify the number of "victory points" required to win  the
                   game.

       -x          Automatically exit after a player has won.

ENVIRONMENT

       The default settings of the server can be influenced with the following
       three environment variables:

       PIONEERS_META_SERVER
              The hostname of the meta-server when no meta-server is specified
              on the command-line.

       PIONEERS_SERVER_NAME
              The  hostname  of the server.  If it is not set, the hostname is
              determined by hostname(1).

       PIONEERS_DIR
              The path to the game definition files.  If it is  not  set,  the
              default installation path will be used.

FILES

       /usr/share/games/pioneers/*.game and $XDG_DATA_HOME/pioneers/*.game
              Game definitions

AUTHOR

       This manual page was written by Steve Langasek <vorlon@debian.org>, and
       updated by Roland Clobus <rclobus@bigfoot.com>.  Pioneers  was  written
       by  Dave  Cole  <dave@dccs.com.au>, Andy Heroff <aheroff@mediaone.net>,
       and Roman Hodek <roman@hodek.net>, with contributions from  many  other
       developers  on  the  Internet;  see  the  AUTHORS  file in the pioneers
       distribution for a complete list of contributing authors.

SEE ALSO

       pioneers(6), pioneers-server-gtk(6), pioneersai(6), hostname(1)