1pioneers-server-console(6) Games Manual pioneers-server-console(6)
2
3
4
6 pioneers-server-console - command-line game server for Pioneers
7
8
10 pioneers-server-console [ OPTIONS ]
11
12
14 This manual page documents briefly the pioneers-server-console command.
15
16 Pioneers is a computerized version of a well known strategy board game.
17 The goal of the game is to colonize an island. The players play the
18 first colonists hence the name pioneers. It uses a client/server model
19 for networked play of between two and eight players. This program pro‐
20 vides a console-only server that pioneers clients can connect to.
21
22
24 Application options
25 -g,--game-title game title Load the ruleset specified by game title.
26 The title can be found in the *.game files. You need quotes for titles
27 with spaces.
28
29 --filefilename
30 Load the ruleset in the file filename.
31
32 -p,--port port
33 Use port port for player connections.
34
35 -P,--players num
36 Start a game for num total players (including computer players).
37
38 -v,--points points
39 Specify the number of "victory points" required to win the game.
40
41 -R,--seven-rule[0|1|2]
42 "Sevens rule": Specify gameplay behavior when a player rolls a
43 seven. A value of 0 (the default) means that rolling a seven
44 always moves the robber. A value of 1 requires the player to
45 re-roll if a seven is rolled on the first two turns. A value of
46 2 means the player always re-rolls.
47
48 -T,--terrain[0|1]
49 Choose a terrain type: 0 for the default, or 1 for random ter‐
50 rain.
51
52 -c,--computer-players num
53 Start up num computer players.
54
55 --version
56 Show version information.
57
58
59 Metaserver options
60 -r,--register
61 Register with a metaserver. The metaserver to use can be over‐
62 ridden with the -m option. Default metaserver: pio‐
63 neers.debian.net
64
65 -m,--metaserver metaserver
66 Register this server with the metaserver at the specified
67 address.
68
69 -n, --hostname hostname
70 Use this hostname instead of the hostname reported by host‐
71 name(1).
72
73
74 Miscellaneous options
75 -x,--auto-quit Automatically exit after a player has won.
76
77 -k,--empty-timeout secs
78 Automatically stop the server if no one has connected after secs
79 seconds.
80
81 -t,--tournament mins
82 Tournament mode: add AI players after mins minutes.
83
84 -a,--admin-port port
85 Listen for administrative commands on port port.
86
87 -s,--admin-wait
88 Don't start the game immediately; wait for a command on the
89 admin port (-a) instead.
90
91 --fixed-seating-order
92 Give players numbers according to the order they enter the game.
93
94 --debug
95 Enable debug messages.
96
97
99 The default settings of the server can be influenced with the following
100 three environment variables:
101
102 PIONEERS_METASERVER
103 The hostname of the metaserver when no metaserver is specified
104 on the command-line.
105
106 PIONEERS_SERVER_NAME
107 The hostname of the server. If it is not set, the hostname is
108 determined by hostname(1).
109
110 PIONEERS_DIR
111 The path to the game definition files. If it is not set, the
112 default installation path will be used.
113
114
116 /usr/share/games/pioneers/*.game and $XDG_DATA_HOME/pioneers/*.game
117 Game definitions
118 /usr/share/games/pioneers/computer_names
119 A list of names the computer player can use
120
121
123 This manual page was written by Steve Langasek <vorlon@debian.org>, and
124 updated by Roland Clobus <rclobus@rclobus.nl>. Pioneers was written by
125 Dave Cole <dave@dccs.com.au>, Andy Heroff <aheroff@mediaone.net>, and
126 Roman Hodek <roman@hodek.net>, with contributions from many other
127 developers on the Internet; see the AUTHORS file in the pioneers dis‐
128 tribution for a complete list of contributing authors.
129
130
132 pioneers(6), pioneers-server-gtk(6), pioneersai(6), hostname(1)
133
134
135
136pioneers February 24, 2013 pioneers-server-console(6)