Provided by: wesnoth-1.10-core_1.10.2-1_i386 bug

NAME

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

SYNOPSIS

       wesnoth [OPTIONS] [PATH_TO_DATA]

DESCRIPTION

       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 online players.
       Create your own custom units, scenarios or campaigns,  and  share  them
       with others.

OPTIONS

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

       -c, --campaign  [<id_campaign>]
              goes directly to the campaign with id <id_campaign>. A selection
              menu will appear if no id was specified.  Note: When using  this
              switch please ensure that you specify the data directory path as
              the final argument aswell, otherwise  the  game  will  take  the
              campaign/scenario id as the data dir.

       --campaign-difficulty <difficulty>
              The  difficulty  of  the  specified campaign (1 to max). If none
              specified, the campaign difficulty selection widget will appear.

       --campaign-scenario <id_scenario>
              The id of the scenario from the specified campaign. The  default
              is the first scenario.

       --config-dir name
              sets the user configuration directory to name under $HOME or "My
              Documents\My Games"  for  windows.   You  can  also  specify  an
              absolute  path for the configuration directory outside the $HOME
              or "My Documents\My Games"

       --config-path
              prints the path of the user configuration directory and exits.

       --data-dir <directory>
              overrides the data directory with the one specified

       -d, --debug
              enables additional command mode options in-game  (see  the  wiki
              page   at   http://www.wesnoth.org/wiki/CommandMode   for   more
              information about command mode).

       -e, --editor file
              start the in-game map editor directly.  If  file  is  specified,
              equivalent to -l --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.

       --log-level=domain1,domain2,...
              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
              used.

       --logdomains [filter]
              lists  defined  log  domains (only the ones containing filter if
              used) and exits

       --max-fps
              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.

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

       --nocache
              disables caching of game data.

       --nomusic
              runs the game without music.

       --nosound
              runs the game without sounds and music.

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

       --preprocess,   -p[=<define1>,<define2>,...]   <file/folder>    <target
       directory>
              preprocesses  a  specified  file/folder.  The  file(s)  will  be
              written in specified target directory: a plain cfg  file  and  a
              processed  cfg  file.  If  a  folder  is  specified,  it will be
              preprocessed recursively based on the known preprocessor  rules.
              The   common   macroses   from   the  data/core/macros  will  be
              preprocessed      before      the      specified      resources.
              define1,define2,...   -  the  extra defines will be added before
              processing the files. If you want to add them you must  add  the
              '='  character before.  If 'SKIP_CORE' is in the define list the
              data/core    won't     be     preprocessed.      Example:     -p
              ~/wesnoth/data/campaigns/tutorial           ~/result          or
              -p=MULTIPLAYER,MY_OWN_CAMPAIGN      ~/wesnoth/data/campaign/camp
              ~/result

       --preprocess-input-macros <source file>
              used  only by the '--preprocess' command.  Specifies a file that
              contains [preproc_define]s to be included before preprocessing.

       --preprocess-output-macros [<target file>]
              used only  by  the  '--preprocess'  command.   Will  output  all
              preprocessed  macros  in  the  target  file.  If the file is not
              specified the output will be file '_MACROS_.cfg' in  the  target
              directory  of preprocess's command.  This switch should be typed
              before the --preprocess command.

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

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

       --strict-validation
              validation errors are treated as fatal errors.

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

       --validcache
              assumes that the cache is valid. (dangerous)

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

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

       --with-replay
              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.

       --ai_confignumber=value
              selects a configuration file to load for the AI  controller  for
              this side.

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

       --controllernumber=value
              selects the controller for this side.  Available  values:  human
              and ai.

       --era=value
              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.

       --exit-at-end
              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.

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

       --parmnumber=name:value
              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)

       --scenario=value
              selects a multiplayer scenario by id. The default scenario id is
              multiplayer_The_Freelands.

       --sidenumber=value
              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.

       --turns=value
              sets the number of turns for the chosen scenario. The default is
              50.

EXIT STATUS

       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.

AUTHOR

       Written by David White <davidnwhite@verizon.net>.
       Edited by Nils Kneuper <crazy-ivanovic@gmx.net>, ott <ott@gaon.net> and
       Soliton <soliton.de@gmail.com>.
       This  manual  page   was   originally   written   by   Cyril   Bouthors
       <cyril@bouthors.org>.
       Visit the official homepage: http://www.wesnoth.org/

COPYRIGHT

       Copyright (C) 2003-2011 David White <davidnwhite@verizon.net>
       This  is Free Software; this software is licensed under the GPL version
       2, as published by the Free Software Foundation.  There is NO warranty;
       not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.

SEE ALSO

       wesnothd(6).