#labels Documentation,Engine,Frontend

The basic parameters to pass to the Hedgewars frontend and engine control the location of the game data, configuration files and saves.

= Frontend =

There are two options that enable to load the data directory and the configuration directory in non standard locations.

  * {{{--data-dir=[path containing 'hedgewars/Data']}}}

  * {{{--config-dir=[path containing 'Demos' 'Saves' etc.]}}}

You can set up both on the command line. The program exits if either of the folders is not correct; quotes are optional, but needed if your path contains spaces

_Example_ 

{{{

$ /usr/bin/hedgewars --data-dir="/opt/local/share/" --config-dir=".hedgewars/tesing config/"

}}}

= Engine =

It is possible to start a replay or save file directly from the terminal issuing the standalone {{{hwengine}}} utility with very simple syntax. 

== Standard Use ==

{{{$ hwengine [options] <path to replay file>}}}

By default hwengine will look in the current folder for game assets, if you wish to use another directory you should set the --prefix and --user-prefix option. See below for even more commands.

The replay file can be stored anywhere. Note that, as always, engine can only load replay files generated from the same Hedgewars version.

== Advanced Use ==

It is possible to specify almost any settings by adding additional arguments:

  * {{{--prefix [path to Hedgewars data folder]}}} - Sets the path to the system game data folder

  * {{{--user-prefix [path to custom Hedgewars folder]}}} - Sets the path to the custom data folder to find game content

  * {{{--locale [language file]}}} - Sets the game language (en.txt for sample)

  * {{{--nick [string]}}} - Represents the user nickname

  * {{{--width [size]}}} - Starts the game with the given width (in pixels)

  * {{{--height [size]}}} - Starts the game with the given height (in pixels)

  * {{{--volume [level]}}} - Sets the volume level, possible values range from 0-100 (negative is muted)

  * {{{--nomusic}}} - Disables music

  * {{{--nosound}}} - Disables sound effects

  * {{{--fullscreen}}} - Starts game in fullscreen

  * {{{--showfps}}} - Shows a fps counter in the top right

  * {{{--altdmg}}} - Uses an alternative damage indicator

  * {{{--low-quality}}} - Lowers the game quality

  * {{{--stereo [type]}}} - Sets stereoscopic rendering type (1 to 14)

  * {{{--help}}} - Shows this list of command line options

=== More Advanced use ===

  * {{{--raw-quality [flags]}}} - (For advanced users only). Manually specifies the reduced quality flags, see below. 

  * {{{--fullscreen-width [size]}}} - Starts the game with the given width (in pixels) when fullscreen

  * {{{--fullscreen-height [size]}}} - Starts the game with the given height (in pixels) when fullscreen

Note: any modification to the command line arguments should be reflected in the autostart .desktop file, game.cpp, GameInterfaceBridge.m.

Personal game data is by default contained in the following directory:

  * _Windows_: {{{%USERPROFILE%\Hedgewars}}}

  * _Linux_: {{{~/.hedgewars}}}

  * _Mac OS X_: {{{~/Library/Application Support/Hedgewars}}}

  * {{{qLowRes        = 1}}}

  * {{{rqBlurryLand   = 2}}}

  * {{{rqNoBackground = 4}}}

  * {{{rqSimpleRope   = 8}}}

  * {{{rq2DWater      = 16}}}

  * {{{rqAntiBoom     = 32}}}

  * {{{rqKillFlakes   = 64}}}

  * {{{rqSlowMenu     = 128}}}

  * {{{rqPlainSplash  = 256}}}

  * {{{rqClampLess    = 512}}}

  * {{{rqTooltipsOff  = 1024}}}

  * {{{rqDesyncVBlank = 2048}}}

Ex: to have blurry land and simple rope, you would use the number 10 (2+8)