1FREECIV(6) Games Manual FREECIV(6)
2
6 civclient - The client for the Freeciv game
7
9 civclient [ -a|--autoconnect ] [ -d|--debug level_number ] [ -h|--help
10 ] [ -l|--log filename ] [ -m|--meta address ] [ -n|--name string ] [
11 -p|--port port ] [ -P|--Plugin string ] [ -r|--read filename ] [
12 -s|--server address ] [ -S|--Sound filename ] [ -t|--tiles string ] [
13 -v|--version ]
14
16 Freeciv is a free turn-based multiplayer strategy game, in which each
17 player becomes the leader of a civilization, fighting to obtain the
18 ultimate goal: To become the greatest civilization.
19 Players of Civilization II® by Microprose® should feel at home, since
21 one aim of Freeciv is to have compatible rules.
22 Freeciv is maintained by an international team of coders and enthusi‐
24 asts, and is easily one of the most fun and addictive network games out
25 there!
26 This is the client program used to connect to a Freeciv server - See
28 also civserver(6)
29 This manual page only lists the command line arguments. For details
31 regarding the options when using civclient see the Client Manual which
32 can be found at http://www.freeciv.org/ ⟨⟩ as well as the documentation
33 which is part of the Freeciv distribution.
34
36 civclient accepts all of the standard X Toolkit command line options
37 along with the additional options listed below. Those may not be com‐
38 bined; that is, "civclient -np caesar 5556" will not work, instead you
39 would need to enter "civclient -n caesar -p 5556". All options have a
40 short form (single hyphen and single letter) and a long form (double
41 hyphen and a complete word); their effects are identical.
42 -a, --autoconnect
44 Skips the connect dialog, automatically inserting the default
45 values. This is quite convenient when all has been set up prop‐
46 erly.
47 -d level_number, --debug level_number
49 Sets the amount of debugging information to be logged in the
50 file named by the -l option. Acceptable values for the
51 level_number are:
52 0 for fatal messages only.
54 1 for fatal and error messages.
56 2 for fatal, error and normal messages.
58 3 for fatal, error, normal, and verbose messages.
60 -h, --help
63 Prints a short summary of the command line options.
64 -l filename, --log filename
66 Defines a log file, filename, to be produced during processing.
67 Use the -d option to set how much is logged. By default, fatal
68 and normal messages are printed to standard output. With a log
69 file, such messages go to the log instead.
70 -m address, --meta address
72 Specifies the address of the metaserver to connect to. A
73 metaserver is a place where Freeciv servers can publish their
74 presence. Freeciv clients consult the metaserver to offer users
75 a selection of games to join. By default the standard Freeciv
76 metaserver is used.
77 -n string, --name string
79 Specifies the name (string) to play under. This option is criti‐
80 cal when reconnecting to a game. Please note that you might need
81 to quote your playername.
82 -p port, --port port
84 Specifies the server port to connect to. By default this is
85 5555, if in doubt ask the server administrator.
86 -P string, --Plugin string
88 Specifies the plugin to use for sound output. Available options
89 for string are:
90 none
92 esd
94 sdl
96 -r filename, --read filename
99 Specifies a file, filename, of server commands which the server
100 will automatically read and process, as if you had typed them in
101 at the server's prompt. (for spawned server only)
102 -s address, --server address
104 Specifies the game server address to connect to. This server
105 might easily run on the same machine as the client.
106 -S filename, --Sound filename
108 Specifies the filename to read the sound tags from.
109 -t string, --tiles string
111 Specifies the tiles to be used within the game by supplying the
112 name (string) of the tilespec. See the FILES section below for
113 tilespecs included with this distribution.
114 -v, --version
116 Prints the version number and exits.
117
119 civclient --name King Richard --server io.daimi.aau.dk
120 Starts the client using the name King Richard and connecting to
121 the server at io.daimi.aau.dk.
122 civclient -a -t trident
124 Starts the client with the trident tiles and autoconnects to the
125 localhost.
126
128 ~/.civclientrc
129 This is where your local settings will be stored.
130 tilespecs
132 The Freeciv client requires several files in the Freeciv data
133 directory, which is /usr/local/share/freeciv by default. Cur‐
134 rently the following tilespecs can be used:
135 · isophex.tilespec
137 · isotrident.tilespec
139 · trident.tilespec
141 · trident_shields.tilespec
143
145 The Freeciv client accepts these environment variables:
146 FREECIV_CAPS
148 A string containing a list of "capabilities" provided by the
149 server. The compiled-in default should be correct for most pur‐
150 poses, but if you are familiar with the capability facility in
151 the source you may use it to enforce some constraints between
152 clients and server.
153 FREECIV_COMPRESSION_LEVEL
155 Sets the compression level.
156 FREECIV_DATA_ENCODING
158 Sets the data encoding (used for data files, savegames, and net‐
159 work strings).
160 FREECIV_INTERNAL_ENCODING
162 Sets the internal encoding (used for GUI strings).
163 FREECIV_LOCAL_ENCODING
165 Sets the local encoding (used for terminal output).
166 FREECIV_MULTICAST_GROUP
168 Sets the multicast group (for the LAN tab).
169 FREECIV_PATH
171 A colon separated list of directories pointing to the freeciv
172 data directory. By default freeciv looks in the following direc‐
173 tories, in order, for any data files: the current directory; the
174 "data" subdirectory of the current directory; the subdirectory
175 ".freeciv" in the user's home directory; and the directory where
176 the files are placed by running "make install".
177 HOME Specifies the user's home directory.
179 http_proxy
181 Set this variable accordingly when using a proxy.
182 LANG or LANGUAGE
184 Sets the language and locale on some platforms.
185 LC_ALL or LC_CTYPE
187 Similar to LANG (see documentation for your system).
188 USER Specifies the username of the current user.
190
192 Please report bugs to http://bugs.freeciv.org/ ⟨⟩
193 Tickets may also be created by sending an email to <bugs AT
195 freeciv.org>.
196
198 The Freeciv homepage is located at http://www.freeciv.org/ ⟨⟩
199 Updates and new info is first posted there.
201
203 The Freeciv Team <freeciv-dev AT freeciv.org>.
204 This manpage was originally put together by Florian Ernst <flo‐
206 rian_ernst AT gmx.net> using the Client Manual and the comments in the
207 sourcecode. It was updated by Ben Bettin <bwbettin AT gmail.com> to add
208 new features, integrate information from the website's online documen‐
209 tation, and for slight formatting adjustments. Feel free to use it as
210 you wish.
211
214 civserver(6) and the Client Manual at the Freeciv homepage.
215 January 29th 2005 FREECIV(6)