Man Linux: Main Page and Category List


       wesnoth - Battle for Wesnoth, a turn-based fantasy strategy game


       wesnoth [OPTIONS] [PATH_TO_DATA]


       Battle for Wesnoth is a turn-based fantasy strategy game.

       Defeat  all  enemy  leaders using a well-chosen cadre of troops, taking
       care to manage your resources of gold  and  villages.  All  units  have
       their own strengths and weaknesses; to win, deploy your forces to their
       best advantage while denying your foes the chance to do  the  same.  As
       units  gain  experience,  they  acquire  new  abilities and become more
       powerful. Play in your own language and test your skill against a smart
       computer  opponent,  or  join  Wesnoth's  large  community  of  on-line
       players. Create your own custom  units,  scenarios  or  campaigns,  and
       share them with others.


       --bpp number
              sets BitsPerPixel value. Example: --bpp 32

       -c, --campaign
              goes directly to the campaign selection menu.

       --config-dir name
              sets the user configuration directory to name under $HOME or "My
              Documents\My Games" for windows.

              prints the path of the user configuration directory and exits.

       -d, --debug
              enables additional command mode options in-game  (see  the  wiki
              page   at   for   more
              information about command mode).

       -e, --editor file
              start the in-game map editor directly.  If  file  is  specified,
              equivalent to -e --load

       --fps  displays  the  number of frames per second the game is currently
              running at, in a corner of the screen.

       -f, --fullscreen
              runs the game in full screen mode.

       --gunzip infile.gz
              decompresses a file which should be in gzip format and stores it
              without the .gz suffix. The infile.gz will be removed.

       --gzip infile
              compresses  a  file  in  gzip format, stores it as infile.gz and
              removes infile.

       -h, --help
              displays a summary of command line options to  standard  output,
              and exits.

       -l, --load file
              loads  the  savegame file from the standard save game directory.
              If the -e or --editor option is used as well, starts the  editor
              with  the  map  from file open. If it is a directory, the editor
              will start with a load map dialog opened there.

              sets the severity level of the log domains.  all can be used  to
              match      any      log      domain.      Available      levels:
              error, warning, info, debug.  By  default  the  error  level  is

              Dumps a list of all log domains and exits.

              the  number  of  frames  per second the game can show, the value
              should be between the 1 and 1000, the default is 50.

       -m, --multiplayer
              runs a multiplayer game. There are additional options  that  can
              be  used  together  with  --multiplayer as explained below. Only
              these additional options can follow --multiplayer.

              runs the game without any delays for graphic benchmarking.  This
              is automatically enabled by --nogui.

              disables caching of game data.

              runs the game without music.

              runs the game without sounds and music.

       --path prints the name of the game data directory and exits.

       -r XxY, --resolution XxY
              sets the screen resolution. Example: -r 800x600

              allows  to  use screen resolutions down to 800x480 and resizes a
              few interface elements.

       -s, --server [host]
              connects to the specified host if any, otherwise connect to  the
              first     server     in     preferences.    Example:    --server

       -t, --test
              runs the game in a small test scenario.

              assumes that the cache is valid. (dangerous)

       -v, --version
              shows the version number and exits.

       -w, --windowed
              runs the game in windowed mode.

              replays the game loaded with the --load option.

Options for --multiplayer

       The side-specific multiplayer options are marked with  number.   number
       has  to  be replaced by a side number. It usually is 1 or 2 but depends
       on the number of players possible in the chosen scenario.

              selects a configuration file to load for the AI  controller  for
              this side.

              selects a non-standard algorithm to be used by the AI controller
              for this side. Available values: idle_ai and sample_ai.

              selects the controller for this side.  Available  values:  human
              and ai.

              use  this  option  to  play  in  the selected era instead of the
              Default era. The era is chosen by an id. Eras are  described  in
              the data/multiplayer/eras.cfg file.

              exits   once   the   scenario   is   over,   without  displaying
              victory/defeat dialog which requires the user to click OK.  This
              is also used for scriptable benchmarking.

              runs  the game without the GUI. Must appear before --multiplayer
              to have the desired effect.

              sets additional parameters for this side. This parameter depends
              on  the  options  used  with  --controller  and --algorithm.  It
              should only be useful for people designing their  own  AI.  (not
              yet documented completely)

              selects a multiplayer scenario by id. The default scenario id is

              selects a faction of the current era for this side. The  faction
              is   chosen   by   an   id.   Factions   are  described  in  the
              data/multiplayer.cfg file.

              sets the number of turns for the chosen scenario. The default is


       Normal  exit status is 0. An exit status of 1 indicates an (SDL, video,
       fonts, etc) initialization error. An exit  status  of  2  indicates  an
       error with the command line options.


       Written by David White <>.
       Edited by Nils Kneuper <>, ott <> and
       Soliton <>.
       This  manual  page   was   originally   written   by   Cyril   Bouthors
       Visit the official homepage:


       Copyright (C) 2003-2009 David White <>
       This  is Free Software; this software is licensed under the GPL version
       2, as published by the Free Software Foundation.  There is NO warranty;


       wesnoth_editor(6), wesnothd(6)