Next: , Previous: Show options, Up: Reference


4.4 Path options

4.4.1 config-file

— Command-line option: --config-file
— Environment variable: LW6_CONFIG_FILE

Type: string.

Set the config file path. This enables you to use whatever config file you like, keeping all other informations in the same place. Default is '$HOME/.liquidwar6/config.xml'.

4.4.2 data-dir

— Command-line option: --data-dir
— Environment variable: LW6_DATA_DIR

Type: string.

Set the data directory. By changing ths value you'll be able to use an alternative data directory. Default is '/usr/local/share/liquidwar6-<version>/data'.

4.4.3 log-file

— Command-line option: --log-file=<value>
— Environment variable: LW6_LOG_FILE
— XML key: log-file

Type: string.

Set the log file path. This enables you to use whatever log file you like, keeping all other informations in the same place. Default is '$HOME/.liquidwar6/log.csv'.

4.4.4 map-dir

— Command-line option: --map-dir
— Environment variable: LW6_MAP_DIR

Type: string.

Set the map directory path. By changing this value you'll be able to play with your own maps in your own directory. Note that there are other ways to achieve that, but using this option will work. However, a side effect is that you might not see builtin maps anymore. Default is '/usr/local/share/liquidwar6-<version>/map'.

4.4.5 map-path

— Command-line option: --map-path=<value>
— Environment variable: LW6_MAP_PATH
— XML key: map-path

Type: string.

Set the map search path. By changing this value you'll be able to play with your own maps in your own directory. This is different from 'map-dir', since it includes 'map-dir', plus it adds a number of other search paths. Unlike most other parameters, the values given from the command-line, from the environment variables, or from the config file, are not overwritten, but appended. That is to say if you specify a 'map-path' with the command-line argument 'map-path=path', but also define the 'LW6_MAP_PATH' value and finally edit 'config.xml' to change the 'map-path' entry in it, you'll end up with the game searching for maps in all these directories. Additionnally, 'map-dir' and '<user-dir>/map' will always be in the list. Any given value can itself include several pathes, separated by the path separator. This separator is ':' on GNU/Linux, and ';' on Microsoft Windows. For instance, on a GNU/Linux box, you could use the command-line argument 'map-path=/foo/bar/map:/home/user/map/:/map'.

4.4.6 mod-dir

— Command-line option: --mod-dir
— Environment variable: LW6_MOD_DIR

Type: string.

Set the module directory path. By changing this you will load dynamic shared libraries (game specific modules such as the graphical backend) from an alternative place. Use this at your own risks, for there can always be a binary incompatibility. You've been warned. Default is '/usr/local/lib/liquidwar6-<version>'.

4.4.7 prefix

— Command-line option: --prefix
— Environment variable: LW6_PREFIX

Type: string.

Override the prefix value given to the GNU Autoconf ./configure script when building the game. Not all path will be changed, some of them might remain the same, for instance message translations (localedir). But most game-specific data including maps, graphics, sounds, will be searched according to the new given parameter. Default is '/usr/local'.

4.4.8 script-file

— Command-line option: --script-file
— Environment variable: LW6_SCRIPT_FILE

Type: string.

Set the main script file path. This file is very important, since the program is more or less a hudge scheme interpreter, and this file is the file loaded by Guile. In short, it is the main program. Default is '/usr/local/share/liquidwar6-<version>/script/liquidwar6.scm'.

4.4.9 user-dir

— Command-line option: --user-dir=<value>
— Environment variable: LW6_USER_DIR
— XML key: user-dir

Type: string.

Set the user directory path. This is where run-time data, config files, log files, are stored. If you override this value, other parameters such as where the config and log files reside, will change. Default is '$HOME/.liquidwar6'.