DragonFly On-Line Manual Pages

pioneers-server-console(6)  DragonFly Games Manual  pioneers-server-console(6)

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

SYNOPSIS
       pioneers-server-console [ OPTIONS ]

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
   Application options
       -g,--game-title 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.

       --filefilename
              Load the ruleset in the file filename.

       -p,--port port
              Use port port for player connections.

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

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

       -R,--seven-rule[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.

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

       -c,--computer-players num
              Start up num computer players.

       --version
              Show version information.

   Metaserver options
       -r,--register
              Register with a metaserver.  The metaserver to use can be
              overridden with the -m option. Default metaserver:
              pioneers.debian.net

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

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

   Miscellaneous options
       -x,--auto-quit Automatically exit after a player has won.

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

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

       -a,--admin-port port
              Listen for administrative commands on port port.

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

       --fixed-seating-order
              Give players numbers according to the order they enter the game.

       --debug
              Enable debug messages.

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

       PIONEERS_METASERVER
              The hostname of the metaserver when no metaserver 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
       /usr/share/games/pioneers/computer_names
              A list of names the computer player can use

AUTHOR
       This manual page was written by Steve Langasek <vorlon@debian.org>, and
       updated by Roland Clobus <rclobus@rclobus.nl>.  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)

pioneers                       February 24, 2013    pioneers-server-console(6)