Man Linux: Main Page and Category List


       freeciv-server - The server for the Freeciv game


       freeciv-server  [  -b|--bind  address  ]  [ -d|--debug level_number ] [
       -e|--exit-on-end ] [ -f|--file filename ] [ -h|--help ] [ -i|--identity
       address ] [ -l|--log filename ] [ -M|--Metaserver address ] [ -m|--meta
       ] [ -p|--port port ] [ -P|--Ppm ] [ -q|--quitidle time ] [ -R|--Ranklog
       filename  ]  [  -r|--read  filename ] [ -S|--Serverid id ] [ -s|--saves
       directory ] [ -v|--version ]

       Auth  aware  servers  have  additional  parameters:  [  -a|--auth  ]  [
       -G|--Guests ] [ -N|--Newusers ]

       IPv6  aware servers have additional parameter: [ -A|--announce protocol


       Freeciv is a free turn-based multiplayer strategy game, in  which  each
       player  becomes  the  leader  of a civilization, fighting to obtain the
       ultimate goal: To become the greatest civilization.

       Players of Civilization II(R) by Microprose(R)  should  feel  at  home,
       since one aim of Freeciv is to have compatible rules.

       Freeciv   is   maintained  by  an  international  team  of  coders  and
       enthusiasts, and is easily one of the most fun  and  addictive  network
       games out there!

       This  is  the  server  program used to establish a Freeciv server - See
       also freeciv-client(6)

       This manual page only lists the command line arguments. For details  of
       the  directives  necessary  to  configure freeciv-server see the Server
       Manual which can be found at  as  well  as  the
       documentation which is part of the Freeciv distribution.


       The  following  options are accepted on the command line of the server.
       They may not be combined; that  is,  "freeciv-server  -fp  savegame.sav
       5557" will not work, instead you would need to enter "freeciv-server -f
       savegame.sav -p 5557". All options have a short form (single hyphen and
       single  letter)  and  a  long form (double hyphen and a complete word);
       their effects are identical.

       -A, --announce protocol
              Uses protocol when announcing game in LAN.  Possible values  for
              protocol are:




       -a, --auth
              Enables  server  authentication  and allows access to registered
              players only.

       -b address, --bind address
              Sets the address on which the server will listen for clients.

       -d level_number, --debug level_number
              Sets the amount of debugging information to  be  logged  in  the
              file   named  by  the  -l  option.  Acceptable  values  for  the
              level_number are:

              0    for fatal messages only.

              1    for fatal and error messages.

              2    for fatal, error and normal messages.

              3    for fatal, error, normal, and verbose messages.

       -e, --exit-on-end
              When a game ends, exit instead of restarting.

       -f filename, --file filename
              Loads  a  saved  game  (filename)   into   the   server   before
              initialization,  instead  of  starting  a  new game. This is for
              reloading  saved  games,   or   for   loading   scenarios.   The
              distribution  comes  with  such  scenarios,  typically stored in

              o british-isles-85x80-v2.80.sav

              o earth-160x90-v2.sav

              o earth-80x50-v2.sav

              o europe-200x100-v2.sav

              o hagworld-120x60-v1.2.sav

              o iberian-peninsula-136x100-v1.0.sav

       -G, --Guests
              Allow guests to login as 'guest' when authentication is enabled.

       -h, --help
              Prints  out a description of the command line options and

       -i address, --identity address
              Reports  the  address  to  the  metaserver.   Then,   the
              metaserver will use this address to redirect the users.

       -l filename, --log filename
              Defines  a  log  file,  filename,  to  be produced during
              processing. Use the -d option to set how much is  logged.
              By  default,  fatal  and  normal  messages are printed to
              standard output.  With a log file, such  messages  go  to
              the log instead.

       -M address, --Metaserver address
              Specifies  the  address  of  the  metaserver to send your
              server's information to.

       -m, --meta
              Directs the server to communicate with  a  metaserver,  a
              place  where  Freeciv servers can publish their presence.
              Freeciv clients consult the metaserver to offer  users  a
              selection  of  games  to  join.  By  default the standard
              Freeciv metaserver is used. You may specify an  alternate
              metaserver with the -M option.

       -N, --Newusers
              Allow new users to login and be registered in the players
              base if authentication is enabled.

       -p port, --port port
              Specifies the TCP  port  number  to  which  clients  will
              connect;  players  must  know  this  number to be able to
              connect if they are  not  to  use  the  default  of  5556
              decimal.  You  may  need  to  use  this  if  5556  is not
              available for your use on your system, or  if  you  would
              like to run multiple servers on the same system.

       -P, --Ppm
              Save map ppms to savegames.

       -q time, --quitidle time
              Quits  if  no players are present for the specified time,
              in seconds, and restarts a new server.

       -R filename, --Ranklog filename
              Defines a log  file,  filename,  to  be  produced  during
              processing.  This  log  contains  information  for player

       -r filename, --read filename
              Specifies a file, filename, of server commands which  the
              server will automatically read and process, as if you had
              typed them in at the server's  prompt.  The  distribution
              comes  with a few examples that set options to be similar
              to Civilization I(R) and Civilization II(R) .  The  files
              are  named  civ1.serv  and  civ2.serv,  and are typically
              found at /usr/local/share/freeciv/.

       -S, --Serverid id
              Sets the server id.

       -s directory, --saves directory
              Specifies the directory to place save game files  created
              by  the  server.   This  is especially useful when you're
              running more than one server on the same  system,  as  it
              inhibits  your  servers from clobbering other's save game

       -v, --version
              Causes the server to display its version number and exit.


       freeciv-server --file oldgame.sav --port 2244
              Starts  a server on port 2244, loading the save game file

       freeciv-server -R ranklog -l logfile -r script -f oldgame.sav.gz
       -p 2244
              Starts a server on port 2244, loading the save game  file
              oldgame.sav.gz.  Ranking  related  events  are written to
              ranklog, other logging information is written to logfile.
              When  the  server  starts,  it  immediately  executes the
              commands contained in script.

       freeciv-server -m -a -q 60 -p 2244 -d 2 -l logfile -r script  -s
              Starts a server on port 2244 with authentication  enabled
              and  communicates  its  existence to the standard Freeciv
              metaserver. Fatal, error, and normal messages are written
              to   logfile.  When  the  server  starts  it  immediately
              executes the commands  contained  in  script.  Save  game
              files are stored in the ~/saves directory. When there are
              no users on the server for 60 seconds,  the  server  will


       You  may  enter  commands  into  the  server at any time, either
       before or during the running of a game.

       Type "help" or "help help" for starters.


       The Freeciv server requires the following files in  the  Freeciv
       data directory, which is /usr/local/share/freeciv by default:

       o default/buildings.ruleset

       o default/cities.ruleset

       o default/game.ruleset

       o default/governments.ruleset

       o default/nations.ruleset

       o default/techs.ruleset

       o default/terrain.ruleset

       o default/units.ruleset

       These  are  the  default  rule sets used for the game. Alternate
       sets of rules  can  be  used  by  placing  them  in  a  separate
       directory  and  using  the  rulesetdir  command  to  change your
       server's ruleset directory.

       Type help rulesetdir for more information.


       The Freeciv server accepts these environment variables:

              A string containing a list of "capabilities" provided  by
              the server. The compiled-in default should be correct for
              most  purposes,  but  if  you  are  familiar   with   the
              capability  facility  in  the  source  you  may use it to
              enforce some constraints between clients and server.

              Sets the compression level for network traffic.

              Sets the data encoding (used for data  files,  savegames,
              and network strings).

              Sets the internal encoding (used for GUI strings).

              Sets the local encoding (used for terminal output).

              Sets the multicast group (for the LAN tab).

              A  colon  separated  list  of directories pointing to the
              freeciv data directory. By default freeciv looks  in  the
              following  directories, in order, for any data files: the
              current directory; the "data" subdirectory of the current
              directory; the subdirectory ".freeciv" in the user's home
              directory; and the directory where the files  are  placed
              by running "make install".

       HOME   Specifies the user's home directory.

              Set this variable accordingly when using a proxy.

       LANG  or  LANGUAGE
              Sets the language and locale on some platforms.

       LC_ALL  or  LC_CTYPE
              Similar to LANG (see documentation for your system).

       USER   Specifies the username of the current user.


       Please report bugs to


       The Freeciv homepage is located at

       Updates and new info is first posted there.


       The Freeciv Team <freeciv-dev AT>.

       This  manpage  was  originally  put  together  by  Florian Ernst
       <florian_ernst AT>  using  the  Server  Manual  and  the
       comments  in  the  sourcecode.  It  was  updated  by  Ben Bettin
       <bwbettin  AT>  to  add   new   features,   integrate
       information  from  the  website's  online documentation, and for
       slight formatting adjustments. Feel free to use it as you  wish.


       freeciv-client(6) and the Server Manual on the Freeciv homepage.

                               October 22th 2009                    FREECIV(6)