1FREECIV(6) Games Manual FREECIV(6)
2
6 freeciv-gtk2, freeciv-sdl, freeciv-xaw, freeciv-win32, freeciv-ftwl, -
7 The clients for the Freeciv game
8
10 freeciv-gtk2|freeciv-sdl|freeciv-xaw|freeciv-win32|freeciv-ftwl [
11 -a|--autoconnect ] [ -d|--debug level_number ] [ -h|--help ] [ -l|--log
12 filename ] [ -M|--Meta URL ] [ -n|--name string ] [ -p|--port port ] [
13 -P|--Plugin string ] [ -r|--read filename ] [ -s|--server address ] [
14 -S|--Sound filename ] [ -t|--tiles string ] [ -v|--version ] [ -- extra
15 parameters ]
16 IPv6 aware clients have additional parameter: [ -A|--announce protocol
18 ]
19 freeciv-gtk2 accepts extra parameters following --: [ -h|--help ]
21 freeciv-sdl accepts extra parameters following --: [ -e|--eventthread ]
23 [ -f|--fullscreen ] [ -h|--help ] [ -t|--theme string ]
24 freeciv-xaw accepts extra parameters following --: [ -h|--help ]
26 freeciv-ftwl accepts extra parameters following --: [ -d|--dump ] [
28 -f|--fullscreen ] [ -h|--help ] [ -r|--res resolution ] [ -t|--theme
29 string ]
30
33 Freeciv is a free turn-based multiplayer strategy game, in which each
34 player becomes the leader of a civilization, fighting to obtain the
35 ultimate goal: To become the greatest civilization.
36 Players of Civilization II® by Microprose® should feel at home, since
38 one aim of Freeciv is to have compatible rules.
39 Freeciv is maintained by an international team of coders and enthusi‐
41 asts, and is easily one of the most fun and addictive network games out
42 there!
43 This is the client program used to connect to a Freeciv server - See
45 also freeciv-server(6)
46 This manual page only lists the command line arguments. For details
48 regarding the options when using freeciv-gtk2 freeciv-sdl freeciv-xaw
49 freeciv-win32 or freeciv-ftwl see the Client Manual which can be found
50 at http://www.freeciv.org/ ⟨⟩ as well as the documentation which is
51 part of the Freeciv distribution.
52
54 All the Freeciv clients accept of the standard X Toolkit command line
55 options along with the additional options listed below. Those may not
56 be combined; that is, "-np caesar 5557" will not work, instead you
57 would need to enter "-n caesar -p 5557". All options have a short form
58 (single hyphen and single letter) and a long form (double hyphen and a
59 complete word); their effects are identical.
60 -A, --announce protocol
62 Uses protocol when searching game from LAN. Possible values for
63 protocol are:
64 IPv4
66 IPv6
68 none
70 -a, --autoconnect
72 Skips the connect dialog, automatically inserting the default
73 values. This is quite convenient when all has been set up prop‐
74 erly.
75 -d level_number, --debug level_number
77 Sets the amount of debugging information to be logged in the
78 file named by the -l option. Acceptable values for the
79 level_number are:
80 0 for fatal messages only.
82 1 for fatal and error messages.
84 2 for fatal, error and normal messages.
86 3 for fatal, error, normal, and verbose messages.
88 -h, --help
91 Prints a short summary of the command line options.
92 -l filename, --log filename
94 Defines a log file, filename, to be produced during processing.
95 Use the -d option to set how much is logged. By default, fatal
96 and normal messages are printed to standard output. With a log
97 file, such messages go to the log instead.
98 -M URL, --Meta URL
100 Specifies the URL of the metaserver to connect to. A metaserver
101 is a place where Freeciv servers can publish their presence.
102 Freeciv clients consult the metaserver to offer users a selec‐
103 tion of games to join. By default the standard Freeciv
104 metaserver is used.
105 -n string, --name string
107 Specifies the name (string) to play under. This option is criti‐
108 cal when reconnecting to a game. Please note that you might need
109 to quote your playername.
110 -p port, --port port
112 Specifies the server port to connect to. By default this is
113 5556, if in doubt ask the server administrator.
114 -P string, --Plugin string
116 Specifies the plugin to use for sound output. Available options
117 for string are:
118 none
120 sdl
122 -r filename, --read filename
125 Specifies a file, filename, of server commands which the server
126 will automatically read and process, as if you had typed them in
127 at the server's prompt. (for spawned server only)
128 -s address, --server address
130 Specifies the game server address to connect to. This server
131 might easily run on the same machine as the client.
132 -S filename, --Sound filename
134 Specifies the filename to read the sound tags from.
135 -t string, --tiles string
137 Specifies the tiles to be used within the game by supplying the
138 name (string) of the tilespec. See the FILES section below for
139 tilespecs included with this distribution.
140 -v, --version
142 Prints the version number and exits.
143 -- All parameters following this -- will be considered as a spe‐
145 cific gui parameter. See below.
146 -- -d, -- --dump
148 Enables screen dumper. Only available for the freeciv-ftwl
149 client.
150 -- -e, -- --eventthread
152 Initializes the event subsystem in other thread. Only available
153 for the freeciv-sdl client under Linux or BeOS.
154 -- -f, -- --fullscreen
156 Starts the client in full screen mode. Only implemented in the
157 freeciv-sdl and freeciv-ftwl clients.
158 -- -h, -- --help
160 Print the specific gui parameters help. Note it is not imple‐
161 mented in the freeciv-win32 client. freeciv-sdl and freeciv-
162 ftwl clients.
163 -- -r resolution, -- --res resolution
165 Uses the given resolution. Note it is not implemented in the
166 freeciv-win32 client. freeciv-sdl and freeciv-ftwl clients.
167 -- -t string, -- --theme string
169 Uses GUI theme string. Only available for the freeciv-ftwl
170 client.
171
173 freeciv-gtk2 --name King Richard --server io.daimi.aau.dk
174 Starts the GTK2 client using the name King Richard and connect‐
175 ing to the server at io.daimi.aau.dk.
176 freeciv-sdl -a -t trident
178 Starts the SDL client with the trident tiles and autoconnects to
179 the localhost.
180
182 ~/.freeciv-client-rc-[version-number]
183 This is where your local settings will be stored.
184 tilespecs
186 The Freeciv client requires several files in the Freeciv data
187 directory, which is /usr/local/share/freeciv by default. Cur‐
188 rently the following tilespecs can be used:
189 · amplio.tilespec
191 · hex2t.tilespec
193 · isophex.tilespec
195 · isotrident.tilespec
197 · trident.tilespec
199
201 The Freeciv client accepts these environment variables:
202 FREECIV_CAPS
204 A string containing a list of "capabilities" provided by the
205 server. The compiled-in default should be correct for most pur‐
206 poses, but if you are familiar with the capability facility in
207 the source you may use it to enforce some constraints between
208 clients and server.
209 FREECIV_COMPRESSION_LEVEL
211 Sets the compression level for network traffic.
212 FREECIV_DATA_ENCODING
214 Sets the data encoding (used for data files, savegames, and net‐
215 work strings).
216 FREECIV_INTERNAL_ENCODING
218 Sets the internal encoding (used for GUI strings).
219 FREECIV_LOCAL_ENCODING
221 Sets the local encoding (used for terminal output).
222 FREECIV_MULTICAST_GROUP
224 Sets the multicast group (for the LAN tab).
225 FREECIV_PATH
227 A colon separated list of directories pointing to the freeciv
228 data directory. By default freeciv looks in the following direc‐
229 tories, in order, for any data files: the current directory; the
230 "data" subdirectory of the current directory; the subdirectory
231 ".freeciv" in the user's home directory; and the directory where
232 the files are placed by running "make install".
233 HOME Specifies the user's home directory.
235 http_proxy
237 Set this variable accordingly when using a proxy.
238 LANG or LANGUAGE
240 Sets the language and locale on some platforms.
241 LC_ALL or LC_CTYPE
243 Similar to LANG (see documentation for your system).
244 USER Specifies the username of the current user.
246
248 Please report bugs to http://gna.org/projects/freeciv/ ⟨⟩
249
252 The Freeciv homepage is located at http://www.freeciv.org/ ⟨⟩
253 Updates and new info is first posted there.
255
257 The Freeciv Team <freeciv-dev AT gna.org>.
258 This manpage was originally put together by Florian Ernst <flo‐
260 rian_ernst AT gmx.net> using the Client Manual and the comments in the
261 sourcecode. It was updated by Ben Bettin <bwbettin AT gmail.com> to add
262 new features, integrate information from the website's online documen‐
263 tation, and for slight formatting adjustments. Feel free to use it as
264 you wish.
265
268 freeciv-server(6) and the Client Manual at the Freeciv homepage.
269 October 30th 2009 FREECIV(6)