1FREECIV(6) Games Manual FREECIV(6)
2
6 freeciv-gtk2, freeciv-gtk3, freeciv-gtk3.22, freeciv-sdl, freeciv-sdl2,
7 freeciv-qt, freeciv-xaw - The clients for the Freeciv game
8
10 freeciv-gtk2|freeciv-gtk3|freeciv-gtk3.22|freeciv-sdl|freeciv-
11 sdl2|freeciv-qt|freeciv-xaw [ -A|--Announce protocol ] [ -a|--autocon‐
12 nect ] [ -d|--debug level_number ] [ -F|--Fatal [ signal_number ] ] [
13 -f|--file filename ] [ -h|--help ] [ -l|--log filename ] [ -M|--Meta
14 URL ] [ -n|--name name ] [ -p|--port port ] [ -P|--Plugin string ] [
15 -r|--read filename ] [ -s|--server address ] [ -S|--Sound name ] [
16 -t|--tiles name ] [ -v|--version ] [ -- client-specific-parameters ]
17 freeciv-gtk2 accepts the standard Gtk parameters following --; see the
19 Gtk documentation. It also accepts [ -h|--help ]
20 freeciv-gtk3 accepts the standard Gtk parameters following --; see the
22 Gtk documentation. It also accepts [ -g|--gtk-warnings ] [ -h|--help ]
23 [ -r|--resolution WIDTHxHEIGHT ]
24 freeciv-gtk3.22 accepts the standard Gtk parameters following --; see
26 the Gtk documentation. It also accepts [ -h|--help ] [ -r|--resolution
27 WIDTHxHEIGHT ]
28 freeciv-qt accepts the standard Qt parameters following --; see the Qt
30 documentation. It also accepts [ -h|--help ]
31 freeciv-sdl accepts the following parameters following --: [
33 -e|--eventthread ] [ -f|--fullscreen ] [ -h|--help ] [ -t|--theme
34 string ]
35 freeciv-sdl2 accepts the following parameters following --: [
37 -f|--fullscreen ] [ -h|--help ] [ -t|--theme string ]
38 freeciv-xaw accepts the standard X11 toolkit parameters following --;
40 see X(7) . It also accepts [ -h|--help ]
41
44 Freeciv is a free turn-based multiplayer strategy game, in which each
45 player becomes the leader of a civilization, fighting to obtain the
46 ultimate goal: To become the greatest civilization.
47 Players of Civilization II® by Microprose® should feel at home, since
49 one aim of Freeciv is to have compatible rules.
50 Freeciv is maintained by an international team of coders and enthusi‐
52 asts, and is easily one of the most fun and addictive network games out
53 there!
54 This is the client program used to connect to a Freeciv server - see
56 also freeciv-server(6) . freeciv-gtk2, freeciv-gtk3, freeciv-gtk3.22,
57 freeciv-qt, freeciv-sdl, and freeciv-sdl2 can also spawn their own
58 local server for single-player games.
59 This manual page only lists the command line arguments. For more
61 details about using freeciv-gtk2, freeciv-gtk3,freeciv-gtk3.22,
62 freeciv-sdl, freeciv-sdl2, freeciv-qt, or freeciv-xaw, see the Client
63 Manual which can be found at the Freeciv website
64 ⟨http://www.freeciv.org/⟩ as well as the documentation which is part of
65 the Freeciv distribution.
66
68 The following options are accepted by all clients. They may not be com‐
69 bined; that is, "-np caesar 5557" will not work, instead you would need
70 to enter "-n caesar -p 5557". All options have a short form (single
71 hyphen and single letter) and a long form (double hyphen and a complete
72 word); their effects are identical.
73 -A protocol, --Announce protocol
75 Uses protocol when searching for games on a LAN. Possible val‐
76 ues for protocol are:
77 IPv4
79 IPv6
81 none
83 -a, --autoconnect
85 Skips the connect dialog, automatically inserting the default
86 values. This is quite convenient when all has been set up prop‐
87 erly.
88 -d level_number, --debug level_number
90 Sets the amount of debugging information to be logged in the
91 file named by the -l option. Acceptable values for the
92 level_number are:
93 0 for fatal messages only.
95 1 for fatal and error messages.
97 2 for fatal, error and normal messages (default).
99 3 for fatal, error, normal, and verbose messages.
101 -F [ signal_number ], --Fatal [ signal_number ]
104 Raise a custom signal on failed assertion. If signal_number is
105 not specified, then the ABRT signal will be used.
106 -f filename, --file filename
108 Loads a saved game file (filename). This is for reloading previ‐
109 ously saved games, or for starting scenarios from the command
110 line.
111 -h, --help
113 Prints a short summary of the standard command line options.
114 -l filename, --log filename
116 Defines a log file, filename, to be produced during processing.
117 Use the -d option to set how much is logged. By default, fatal,
118 error, and normal messages are printed to standard output. With
119 a log file, such messages go to the log instead. If filename
120 already exists, it is appended to.
121 -M URL, --Meta URL
123 Specifies the URL of the metaserver to connect to. A metaserver
124 is a place where Freeciv servers can publish their presence.
125 Freeciv clients consult the metaserver to offer users a selec‐
126 tion of games to join. By default, the standard metaserver run
127 by the Freeciv maintainers will be used.
128 -n name, --name name
130 Specifies the user name (name) to use to connect to the server.
131 This option is critical when reconnecting to a game. Please note
132 that you might need to quote your username.
133 -p port, --port port
135 Specifies the server port to connect to. By default this is
136 5556, if in doubt ask the server administrator.
137 -P string, --Plugin string
139 Specifies the plugin to use for sound output. Available options
140 for string are:
141 none
143 sdl
145 -r filename, --read filename
148 Specifies a file, filename, of server commands which a server
149 spawned by the client will automatically read and process, as if
150 you had typed them in at the server's prompt.
151 -s address, --server address
153 Specifies the game server address to connect to. This server
154 might easily run on the same machine as the client.
155 -S name, --Sound name
157 Specifies the sound set to use. A file called name.soundspec is
158 searched for in the usual places (see the FILES section).
159 -t name, --tiles name
161 Specifies the map graphics ("tiles") to be used within the game.
162 A file called name.tilespec is searched for in the usual places
163 (see the FILES section). Currently the following tilespecs are
164 distributed with Freeciv:
165 · amplio2.tilespec
167 · cimpletoon.tilespec
169 · hex2t.tilespec
171 · isophex.tilespec
173 · isotrident.tilespec
175 · trident.tilespec
177 -v, --version
179 Prints the version number and exits.
180 -- All parameters following this -- will be considered as client-
182 specific parameters.
183 -- -e, -- --eventthread
185 Initializes the event subsystem in other thread. Only available
186 for the freeciv-sdl client under Linux or BeOS.
187 -- -f, -- --fullscreen
189 Starts the client in full screen mode. Only implemented in the
190 freeciv-sdl and freeciv-sdl2 client.
191 -- -h, -- --help
193 Print the client-specific parameter help.
194 -- -r WIDTHxHEIGHT, -- --resolution WIDTHxHEIGHT
196 Behave as if screen resolution were WIDTHxHEIGHT. Only imple‐
197 mented in the freeciv-gtk3 and freeciv-gtk3.22 clients.
198 -- -t theme, -- --theme theme
200 Use a particular GUI theme. Only implemented in the freeciv-sdl
201 and freeciv-sdl2 clients.
202
204 freeciv-gtk3 --name "King Richard" --server io.daimi.aau.dk
205 Starts the GTK3 client using the name King Richard and connect‐
206 ing to the server at io.daimi.aau.dk.
207 freeciv-sdl -a -t trident
209 Starts the SDL client with the trident tiles and autoconnects to
210 localhost.
211
213 ~/.freeciv/freeciv-client-rc-[version-number]
214 This is where your local settings will be stored.
215 tilespecs
217 These are searched for in the data path; see ENVIRONMENT.
218 soundspecs
220 These are searched for in the data path; see ENVIRONMENT.
221 The freeciv-modpack(6) utility can be used to locate and download addi‐
223 tional content such as tilesets and soundsets and (for client-spawned
224 servers only) scenarios and rulesets; it saves files under ~/.freeciv .
225
227 The Freeciv client accepts these environment variables:
228 FREECIV_CAPS
230 A string containing a list of "capabilities" provided by the
231 server. The compiled-in default should be correct for most pur‐
232 poses, but if you are familiar with the capability facility in
233 the source you may use it to enforce some constraints between
234 clients and server.
235 FREECIV_COMPRESSION_LEVEL
237 Sets the compression level for network traffic.
238 FREECIV_DATA_ENCODING
240 Sets the character encoding used for data files, savegames, and
241 network strings). This should not normally be changed from the
242 default of UTF-8, since that is the format of the supplied rule‐
243 sets and the standard network protocol.
244 FREECIV_INTERNAL_ENCODING
246 Sets the character encoding used internally by the freeciv
247 client. This generally needs to match the GUI toolkit, so its
248 default depends on the specific client; most clients default to
249 UTF-8.
250 FREECIV_LOCAL_ENCODING
252 Sets the local character encoding (used for the command line and
253 terminal output). The default is inferred from other aspects of
254 the environment.
255 FREECIV_MULTICAST_GROUP
257 Sets the multicast group (for the LAN tab).
258 FREECIV_DATA_PATH
260 A colon separated list of directories pointing to the freeciv
261 data directories. By default Freeciv looks in the following
262 directories, in order, for any data files: the current direc‐
263 tory; the "data" subdirectory of the current directory; the sub‐
264 directory ".freeciv/2.6" in the user's home directory; and the
265 directory where the files are placed by running "make install".
266 If not set, FREECIV_PATH is checked before these defaults are
267 used.
268 FREECIV_SAVE_PATH
270 A colon separated list of directories pointing to the freeciv
271 save directories. By default Freeciv looks in the following
272 directories, in order, for save files: the current directory;
273 and the subdirectory ".freeciv/saves" in the user's home direc‐
274 tory. If not set, FREECIV_PATH is checked before these defaults
275 are used; in this case Freeciv also looks in "saves" potential
276 subdirectories.
277 (This does not affect where the server spawned by the client
279 creates save game files; these are always created in
280 ".freeciv/saves" in the user's home directory.)
281 FREECIV_SCENARIO_PATH
283 A colon separated list of directories pointing to the freeciv
284 scenario directories. By default Freeciv looks in the following
285 directories, in order, for scenario files: the current direc‐
286 tory; the "data/scenarios" subdirectory of the current direc‐
287 tory; the subdirectories ".freeciv/2.6/scenarios" and then
288 ".freeciv/scenarios" in the user's home directory; and the
289 directory where the files are placed by running "make install".
290 If not set, FREECIV_PATH is checked before these defaults are
291 used; in this case Freeciv also looks in "scenario" and "scenar‐
292 ios" potential subdirectories.
293 (This does not affect where the server spawned by the client
295 creates scenario files; these are always created in
296 ".freeciv/scenarios" in the user's home directory.)
297 FREECIV_PATH
299 A colon separated list of directories to look for various files.
300 This variable has no effect if FREECIV_DATA_PATH,
301 FREECIV_SAVE_PATH and FREECIV_SCENARIO_PATH are defined
302 together; those variables are the recommended way to override
303 paths, with FREECIV_PATH provided only for backward compatibil‐
304 ity with older versions of Freeciv; FREECIV_PATH will be removed
305 in a future release. The precise search path depends on the type
306 of file being searched for.
307 FREECIV_OPT
309 Specifies a file to contain local settings, instead of
310 ~/.freeciv/freeciv-client-rc-[version-number].
311 HOME Specifies the user's home directory.
313 http_proxy
315 Set this variable accordingly when using a proxy.
316 LANG or LANGUAGE
318 Sets the language and locale on some platforms.
319 LC_ALL or LC_CTYPE
321 Similar to LANG (see documentation for your system).
322 USER Specifies the username of the current user.
324
326 Please report bugs to the Freeciv bug tracker
327 ⟨https://www.freelists.org/list/freeciv-dev⟩ .
328
331 See the Freeciv homepage ⟨http://www.freeciv.org/⟩ .
332 Updates and new info is first posted there.
334
336 The Freeciv Team <freeciv-dev AT freelists.org>.
337 This manpage was originally put together by Florian Ernst <flo‐
339 rian_ernst AT gmx.net> using the Client Manual and the comments in the
340 sourcecode. It was updated by Ben Bettin <bwbettin AT gmail.com> to add
341 new features, integrate information from the website's online documen‐
342 tation, and for slight formatting adjustments. Feel free to use it as
343 you wish.
344
347 freeciv-server(6) freeciv-modpack(6) and the Client Manual at the
348 Freeciv homepage.
349 November 2nd 2016 FREECIV(6)