pioneers(6) [debian man page]

pioneers(6)							   Games Manual 						       pioneers(6)

NAME

       pioneers - network implementation of Settlers of Catan

SYNOPSIS

       pioneers [ --server server ] [ --port port ] [ --name name ]

DESCRIPTION

       This manual page documents briefly the pioneers 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.  You will need to connect to a machine	running  either  pioneers-
       server-gtk or pioneers-server-console to play.  An AI client, pioneersai, is also available.

OPTIONS

       Pioneers accepts the standard GTK+/GNOME commandline options, and the following options:

       -s, --server server
	      Hostname of the server

       -p, --port port
	      Portname of the server

       -n, --name name
	      Use this name for the player instead of the name in the settings file

       -v, --spectator
	      Connect as spectator instead of as a player

       -m, --meta-server meta-server
	      Connect to this meta-server instead of the meta-server in the settings file

       --debug
	      Turn on debugging mode

       --version
	      Show the version and quit

       When the server and port are both provided, the client automatically quits when the connection is broken.

ENVIRONMENT

       The default settings can be influenced with the following environment variable:

       PIONEERS_META_SERVER
	      The hostname of the meta-server.	If it is not set, the default meta-server will be used.

FILES

       /usr/share/games/pioneers/themes/*
	      Themes for display of the map. Each theme goes in a separate subdirectory.
       /usr/share/pixmaps/pioneers/*
	      Icons
       /usr/share/pixmaps/pioneers.png
	      Main icon
       $XDG_CONFIG_HOME/pioneers
	      Saved settings
       $XDG_DATA_HOME/pioneers/themes
	      Personal themes

AUTHOR

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

       More detailed user documentation is available in the online help.

       pioneers-server-gtk(6), pioneers-server-console(6), pioneersai(6)

pioneers							  January 8, 2012						       pioneers(6)

pioneers-server-console(6)					   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.

   Meta-server options
       -r,--register
	      Register with a meta server.  The meta server to use can be overridden with the -m option. Default meta sever: pioneers.debian.net

       -m,--meta-server 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_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
       /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  writ-
       ten  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							  January 8, 2012					pioneers-server-console(6)