Map style.xml - Liquid War 6
Description: Liquid War 6

Next: Map teams.xml, Previous: Map hints.xml, Up: Reference

### 4.13 Map style.xml

#### 4.13.1 animation-density

— Command-line option: `--animation-density=<value>`
— Environment variable: `LW6_ANIMATION_DENSITY`
— XML key: `animation-density`

> Type: float

> Default value: 1.0 Min value: 0 Max value: 10

> Density of the background animation, that is, for instance, if the background animation is about displaying bubbles, using a high value will display many bubbles. A value of 1.0 corresponds to the default setting.

#### 4.13.2 animation-speed

— Command-line option: `--animation-speed=<value>`
— Environment variable: `LW6_ANIMATION_SPEED`
— XML key: `animation-speed`

> Type: float

> Default value: 1.0 Min value: 0 Max value: 10

> Speed of the background animation, that is, for instance, if the background animation is about displaying bubbles, using a high value will cause bubbles to move very fast. A value of 1.0 corresponds to the default setting.

#### 4.13.3 background-color-root-bg

— Command-line option: `--background-color-root-bg=<value>`
— Environment variable: `LW6_BACKGROUND_COLOR_ROOT_BG`
— XML key: `background-color-root-bg`

> Type: color

> Default value: #000000

> Defines the main background color. This is, for instance, the color which will be used to clear the screen before drawing thing. Will be automatically guessed from the map texture if color-auto is set. Can be #RGB, #RGBA, #RRGGBB or #RRGGBBAA.

#### 4.13.4 background-color-root-fg

— Command-line option: `--background-color-root-fg=<value>`
— Environment variable: `LW6_BACKGROUND_COLOR_ROOT_FG`
— XML key: `background-color-root-fg`

> Type: color

> Default value: #cccccc

> Defines a color which will be used together with color-base-bg to compose the background. It can be wise to have a minimum contrast between this color and color-base-bg, but it is not mandatory, especially if other colors are manually redefined. Will be automatically guessed from the map texture if color-auto is set. Can be #RGB, #RGBA, #RRGGBB or #RRGGBBAA.

#### 4.13.5 background-color-stuff-bg

— Command-line option: `--background-color-stuff-bg=<value>`
— Environment variable: `LW6_BACKGROUND_COLOR_STUFF_BG`
— XML key: `background-color-stuff-bg`

> Type: color

> Default value: #333333

> Defines a color which will be used together with color-alternate-fg to draw things (animations, sprites, text, whatever) in the background. It should be different enough from color-alternate-fg so that one can really distinguish these colors. Will be automatically guessed from the map texture if color-auto is set. Can be #RGB, #RGBA, #RRGGBB or #RRGGBBAA.

#### 4.13.6 background-color-stuff-fg

— Command-line option: `--background-color-stuff-fg=<value>`
— Environment variable: `LW6_BACKGROUND_COLOR_STUFF_FG`
— XML key: `background-color-stuff-fg`

> Type: color

> Default value: #ffffff

> Defines a color which will be used to draw things (animations, sprites, text, whatever) in the background. It should be different enough from color-alternate-bg so that one can really distinguish these colors. Think of this as the sprite, the text, the whatever-needs-to-be-seen-uses-this color. Will be automatically guessed from the map texture if color-auto is set. Can be #RGB, #RGBA, #RRGGBB or #RRGGBBAA.

#### 4.13.7 background-style

— Command-line option: `--background-style=<value>`
— Environment variable: `LW6_BACKGROUND_STYLE`
— XML key: `background-style`

> Type: string

> Default value: bubbles

> The background defines, of course, what is displayed at the background, but it also conditions the colors used for other items, such as the menus for instance. The possible values are 'void' and 'bubbles'.

#### 4.13.8 blink-cursor

— Command-line option: `--blink-cursor=<value>`
— Environment variable: `LW6_BLINK_CURSOR`
— XML key: `blink-cursor`

> Type: boolean

> Default value: false

> If set, then cursor will blink, allowing you to see what's under the cursor. It's just a matter of taste, you might to always have your cursor displayed, or prefer to have it disappear from time to time so that you can see the action below

#### 4.13.9 color-alternate-bg

— Command-line option: `--color-alternate-bg=<value>`
— Environment variable: `LW6_COLOR_ALTERNATE_BG`
— XML key: `color-alternate-bg`

> Type: color

> Default value: #333333

> Defines the alternate color, more precisely, its bg (background) part. Colors are always defined by a bg/fg pair. Most colors in the game can be deduced from this one, usually to color a map you only need to define color-base-bg, color-base-fg, color-alternate-bg and color-alternate-fg.

#### 4.13.10 color-alternate-fg

— Command-line option: `--color-alternate-fg=<value>`
— Environment variable: `LW6_COLOR_ALTERNATE_FG`
— XML key: `color-alternate-fg`

> Type: color

> Default value: #ffffff

> Defines the alternate color, more precisely, its fg (foreground) part. Colors are always defined by a bg/fg pair. Most colors in the game can be deduced from this one, usually to color a map you only need to define color-base-bg, color-base-fg, color-alternate-bg and color-alternate-fg.

#### 4.13.11 color-base-bg

— Command-line option: `--color-base-bg=<value>`
— Environment variable: `LW6_COLOR_BASE_BG`
— XML key: `color-base-bg`

> Type: color

> Default value: #000000

> Defines the base color, more precisely, its bg (background) part. Colors are always defined by a bg/fg pair. Most colors in the game can be deduced from this one, usually to color a map you only need to define color-base-bg, color-base-fg, color-alternate-bg and color-alternate-fg.

#### 4.13.12 color-base-fg

— Command-line option: `--color-base-fg=<value>`
— Environment variable: `LW6_COLOR_BASE_FG`
— XML key: `color-base-fg`

> Type: color

> Default value: #cccccc

> Defines the base color, more precisely, its fg (foreground) part. Colors are always defined by a bg/fg pair. Most colors in the game can be deduced from this one, usually to color a map you only need to define color-base-bg, color-base-fg, color-alternate-bg and color-alternate-fg.

#### 4.13.13 colorize

— Command-line option: `--colorize=<value>`
— Environment variable: `LW6_COLORIZE`
— XML key: `colorize`

> Type: boolean

> Default value: true

> If set, then all background drawings including textures will use the background colors. This means, for instance, that if background colors are set automatically by color-auto from the map texture, then the background will adopt the same range of colors than the map itself. In short, the background will mimic the map.

#### 4.13.14 colorize-cursor

— Command-line option: `--colorize-cursor=<value>`
— Environment variable: `LW6_COLORIZE_CURSOR`
— XML key: `colorize-cursor`

> Type: boolean

> Default value: true

> If set, then all cursors will use the automatic guessed colors, or the specified colors, but basically they won't be displayed using their native colors. This can be usefull for you can wish to use a generic non-colored texture for your cursor and let it be colorized automatically so that it's accorded to the level.

#### 4.13.15 cursor-size

— Command-line option: `--cursor-size=<value>`
— Environment variable: `LW6_CURSOR_SIZE`
— XML key: `cursor-size`

> Type: float

> Default value: 1.0 Min value: 0 Max value: 10

> Size of the cursors on the map. 1 is the default, setting it to a higher value will make cursors bigger, a lower value will make them smaller.

#### 4.13.16 hidden-layer-alpha

— Command-line option: `--hidden-layer-alpha=<value>`
— Environment variable: `LW6_HIDDEN_LAYER_ALPHA`
— XML key: `hidden-layer-alpha`

> Type: float

> Default value: 0.1 Min value: 0 Max value: 1

> Whenever players are supposed to be hidden behind a wall, for instance if they are in layer 2 and layer 1 is filled with walls, it's still possible to see them, but with a low alpha value (almost transparent). This parameter allows you to trick this value, 0 will make these players absolutely invisible, 1 will make them totally opaque, like if they were on layer 1.

#### 4.13.17 hud-color-frame-bg

— Command-line option: `--hud-color-frame-bg=<value>`
— Environment variable: `LW6_HUD_COLOR_FRAME_BG`
— XML key: `hud-color-frame-bg`

> Type: color

> Default value: #000000

> Defines the background color for the hud frame. Ignored if hud-color-auto is set. Can be #RGB, #RGBA, #RRGGBB or #RRGGBBAA.

#### 4.13.18 hud-color-frame-fg

— Command-line option: `--hud-color-frame-fg=<value>`
— Environment variable: `LW6_HUD_COLOR_FRAME_FG`
— XML key: `hud-color-frame-fg`

> Type: color

> Default value: #cccccc

> Defines the foreground color for the hud frame. Ignored if hud-color-auto is set. Can be #RGB, #RGBA, #RRGGBB or #RRGGBBAA.

#### 4.13.19 hud-color-text-bg

— Command-line option: `--hud-color-text-bg=<value>`
— Environment variable: `LW6_HUD_COLOR_TEXT_BG`
— XML key: `hud-color-text-bg`

> Type: color

> Default value: #333333

> Defines the background color for hud text. Ignored if hud-color-auto is set. Can be #RGB, #RGBA, #RRGGBB or #RRGGBBAA.

#### 4.13.20 hud-color-text-fg

— Command-line option: `--hud-color-text-fg=<value>`
— Environment variable: `LW6_HUD_COLOR_TEXT_FG`
— XML key: `hud-color-text-fg`

> Type: color

> Default value: #ffffff

> Defines the foreground color for hud text. Ignored if hud-color-auto is set. Can be #RGB, #RGBA, #RRGGBB or #RRGGBBAA.

#### 4.13.21 hud-style

— Command-line option: `--hud-style=<value>`
— Environment variable: `LW6_HUD_STYLE`
— XML key: `hud-style`

> Type: string

> Default value: floating

> The hud is where informations about the game are displayed. This means, who is winning, are other status-like informations. Possible values include 'floating' and 'tactical'.

#### 4.13.22 keep-ratio

— Command-line option: `--keep-ratio=<value>`
— Environment variable: `LW6_KEEP_RATIO`
— XML key: `keep-ratio`

> Type: boolean

> Default value: true

> Defines wether the map should keep its ratio, or if it should be stretched to fill the shape of your screen.

#### 4.13.23 menu-color-default-bg

— Command-line option: `--menu-color-default-bg=<value>`
— Environment variable: `LW6_MENU_COLOR_DEFAULT_BG`
— XML key: `menu-color-default-bg`

> Type: color

> Default value: #333333

> Defines the default background color for menus. Ignored if menu-color-auto is set. Can be #RGB, #RGBA, #RRGGBB or #RRGGBBAA.

#### 4.13.24 menu-color-default-fg

— Command-line option: `--menu-color-default-fg=<value>`
— Environment variable: `LW6_MENU_COLOR_DEFAULT_FG`
— XML key: `menu-color-default-fg`

> Type: color

> Default value: #ffffff

> Defines the default foreground color for menus. In fact, this is the main color for menu text, the color used to draw letters in menus. Ignored if menu-color-auto is set. Can be #RGB, #RGBA, #RRGGBB or #RRGGBBAA.

#### 4.13.25 menu-color-disabled-bg

— Command-line option: `--menu-color-disabled-bg=<value>`
— Environment variable: `LW6_MENU_COLOR_DISABLED_BG`
— XML key: `menu-color-disabled-bg`

> Type: color

> Default value: #000000

> Defines the background color for a disabled menu item. Ignored if menu-color-auto is set. Can be #RGB, #RGBA, #RRGGBB or #RRGGBBAA.

#### 4.13.26 menu-color-disabled-fg

— Command-line option: `--menu-color-disabled-fg=<value>`
— Environment variable: `LW6_MENU_COLOR_DISABLED_FG`
— XML key: `menu-color-disabled-fg`

> Type: color

> Default value: #cccccc

> Defines the foreground color for a disabled menu item. Ignored if menu-color-auto is set. Can be #RGB, #RGBA, #RRGGBB or #RRGGBBAA.

#### 4.13.27 menu-color-selected-bg

— Command-line option: `--menu-color-selected-bg=<value>`
— Environment variable: `LW6_MENU_COLOR_SELECTED_BG`
— XML key: `menu-color-selected-bg`

> Type: color

> Default value: #ffffff

> Defines the background color for a selected menu item. Ignored if menu-color-auto is set. Can be #RGB, #RGBA, #RRGGBB or #RRGGBBAA.

#### 4.13.28 menu-color-selected-fg

— Command-line option: `--menu-color-selected-fg=<value>`
— Environment variable: `LW6_MENU_COLOR_SELECTED_FG`
— XML key: `menu-color-selected-fg`

> Type: color

> Default value: #333333

> Defines the foreground color for a selected menu item. Ignored if menu-color-auto is set. Can be #RGB, #RGBA, #RRGGBB or #RRGGBBAA.

#### 4.13.29 menu-style

— Command-line option: `--menu-style=<value>`
— Environment variable: `LW6_MENU_STYLE`
— XML key: `menu-style`

> Type: string

> Default value: cylinder

> The menu style is simply the name of the engine used to power the menu system. The only possible value, for now, is 'cylinder'.

#### 4.13.30 music-exclude

— Command-line option: `--music-exclude=<value>`
— Environment variable: `LW6_MUSIC_EXCLUDE`
— XML key: `music-exclude`

> Type: string

> Default value: Chadburn

> If this string is found in a music file name, it will be excluded from the list when playing in random mode.

#### 4.13.31 music-file

— Command-line option: `--music-file=<value>`
— Environment variable: `LW6_MUSIC_FILE`
— XML key: `music-file`

> Type: string

> Default value:

> Allows you to play a custom music file (typically your own ogg music) and override default game music. If file does not exist, game will use its internal music. The file will be searched for in the current 'music-path' but also in the current map directory. No absolute or even relative path are allowed, only a plain filename with no slash or backslash. Avoid special characters at all cost.

#### 4.13.32 music-filter

— Command-line option: `--music-filter=<value>`
— Environment variable: `LW6_MUSIC_FILTER`
— XML key: `music-filter`

> Type: string

> Default value:

> A music filter, used when files are played randomly. This is not a complex regex-enabled filter, just a plain string search. Even the '*' wildcard won't work. If you want precise control on what music file to play, please consider reorganizing your files and/or use the 'music-file' parameter.

#### 4.13.33 pixelize

— Command-line option: `--pixelize=<value>`
— Environment variable: `LW6_PIXELIZE`
— XML key: `pixelize`

> Type: boolean

> Default value: false

> Depending on the renderer capabilities, will try to pixelize some parts of the game. This can be used to emulate the old LW5 appearance.

#### 4.13.34 system-color-bg

— Command-line option: `--system-color-bg=<value>`
— Environment variable: `LW6_SYSTEM_COLOR_BG`
— XML key: `system-color-bg`

> Type: color

> Default value: #333333

> Defines the system background color, used when displaying system info, such as the number of frames per second. Can be #RGB, #RGBA, #RRGGBB or #RRGGBBAA.

#### 4.13.35 system-color-fg

— Command-line option: `--system-color-fg=<value>`
— Environment variable: `LW6_SYSTEM_COLOR_FG`
— XML key: `system-color-fg`

> Type: color

> Default value: #ffffff

> Defines the system foreground color, used when displaying system info, such as the number of frames per second. This will typically be text color. Can be #RGB, #RGBA, #RRGGBB or #RRGGBBAA.

#### 4.13.36 team-color-blue

— Command-line option: `--team-color-blue=<value>`
— Environment variable: `LW6_TEAM_COLOR_BLUE`
— XML key: `team-color-blue`

> Type: color

> Default value: #0000ff

> Defines the color for the blue team. Syntax is HTML-like, #RGB or #RRGGBB.

#### 4.13.37 team-color-cyan

— Command-line option: `--team-color-cyan=<value>`
— Environment variable: `LW6_TEAM_COLOR_CYAN`
— XML key: `team-color-cyan`

> Type: color

> Default value: #00ffff

> Defines the color for the cyan team. Syntax is HTML-like, #RGB or #RRGGBB.

#### 4.13.38 team-color-dead

— Command-line option: `--team-color-dead=<value>`
— Environment variable: `LW6_TEAM_COLOR_DEAD`
— XML key: `team-color-dead`

> Type: color

> Default value: #000000

> Defines the color for the teams when they are dead. By default it is black, this means when a team is weak it becomes black. Syntax is HTML-like, #RGB or #RRGGBB.

#### 4.13.39 team-color-green

— Command-line option: `--team-color-green=<value>`
— Environment variable: `LW6_TEAM_COLOR_GREEN`
— XML key: `team-color-green`

> Type: color

> Default value: #00ff00

> Defines the color for the green team. Syntax is HTML-like, #RGB or #RRGGBB.

#### 4.13.40 team-color-lightblue

— Command-line option: `--team-color-lightblue=<value>`
— Environment variable: `LW6_TEAM_COLOR_LIGHTBLUE`
— XML key: `team-color-lightblue`

> Type: color

> Default value: #88bbff

> Defines the color for the light blue team. Syntax is HTML-like, #RGB or #RRGGBB.

#### 4.13.41 team-color-magenta

— Command-line option: `--team-color-magenta=<value>`
— Environment variable: `LW6_TEAM_COLOR_MAGENTA`
— XML key: `team-color-magenta`

> Type: color

> Default value: #ff00ff

> Defines the color for the magenta team. Syntax is HTML-like, #RGB or #RRGGBB.

#### 4.13.42 team-color-orange

— Command-line option: `--team-color-orange=<value>`
— Environment variable: `LW6_TEAM_COLOR_ORANGE`
— XML key: `team-color-orange`

> Type: color

> Default value: #ff8800

> Defines the color for the orange team. Syntax is HTML-like, #RGB or #RRGGBB.

#### 4.13.43 team-color-pink

— Command-line option: `--team-color-pink=<value>`
— Environment variable: `LW6_TEAM_COLOR_PINK`
— XML key: `team-color-pink`

> Type: color

> Default value: #ff88bb

> Defines the color for the pink team. Syntax is HTML-like, #RGB or #RRGGBB.

#### 4.13.44 team-color-purple

— Command-line option: `--team-color-purple=<value>`
— Environment variable: `LW6_TEAM_COLOR_PURPLE`
— XML key: `team-color-purple`

> Type: color

> Default value: #bb88ff

> Defines the color for the purple team. Syntax is HTML-like, #RGB or #RRGGBB.

#### 4.13.45 team-color-red

— Command-line option: `--team-color-red=<value>`
— Environment variable: `LW6_TEAM_COLOR_RED`
— XML key: `team-color-red`

> Type: color

> Default value: #ff0000

> Defines the color for the red team. Syntax is HTML-like, #RGB or #RRGGBB.

#### 4.13.46 team-color-yellow

— Command-line option: `--team-color-yellow=<value>`
— Environment variable: `LW6_TEAM_COLOR_YELLOW`
— XML key: `team-color-yellow`

> Type: color

> Default value: #ffff00

> Defines the color for the yellow team. Syntax is HTML-like, #RGB or #RRGGBB.

#### 4.13.47 view-color-cursor-bg

— Command-line option: `--view-color-cursor-bg=<value>`
— Environment variable: `LW6_VIEW_COLOR_CURSOR_BG`
— XML key: `view-color-cursor-bg`

> Type: color

> Default value: #333333

> Defines the background cursor color. Will typically be used to draw the shape of the cursor. Ignored if view-color-auto is set. Can be #RGB, #RGBA, #RRGGBB or #RRGGBBAA.

#### 4.13.48 view-color-cursor-fg

— Command-line option: `--view-color-cursor-fg=<value>`
— Environment variable: `LW6_VIEW_COLOR_CURSOR_FG`
— XML key: `view-color-cursor-fg`

> Type: color

> Default value: #ffffff

> Defines the foreground cursor color. Will typically be used to draw text in the cursor. Ignored if view-color-auto is set. Can be #RGB, #RGBA, #RRGGBB or #RRGGBBAA.

#### 4.13.49 view-color-map-bg

— Command-line option: `--view-color-map-bg=<value>`
— Environment variable: `LW6_VIEW_COLOR_MAP_BG`
— XML key: `view-color-map-bg`

> Type: color

> Default value: #000000

> Defines the background map color. If there's no map texture defined or if use-texture is false, this is the color of the places where armies will go. Ignored if view-color-auto is set. Can be #RGB, #RGBA, #RRGGBB or #RRGGBBAA.

#### 4.13.50 view-color-map-fg

— Command-line option: `--view-color-map-fg=<value>`
— Environment variable: `LW6_VIEW_COLOR_MAP_FG`
— XML key: `view-color-map-fg`

> Type: color

> Default value: #cccccc

> Defines the foreground map color. If there's no map texture defined or if use-texture is false, this is the color of walls, what armies can't go through. Ignored if view-color-auto is set. Can be #RGB, #RGBA, #RRGGBB or #RRGGBBAA.

#### 4.13.51 view-style

— Command-line option: `--view-style=<value>`
— Environment variable: `LW6_VIEW_STYLE`
— XML key: `view-style`

> Type: string

> Default value: flat

> The view style conditions which renderer is used for the map, the area where fighters are displayed. This is not the graphics backend. Indeed, the graphics backend defines which technical tool one uses (which library) one runs, wether this parameter says what kind of rendering one wants.

#### 4.13.52 waves

— Command-line option: `--waves=<value>`
— Environment variable: `LW6_WAVES`
— XML key: `waves`

> Type: boolean

> Default value: true

> Activates the wave effect, that's to say level appears to be under water when playing.

#### 4.13.53 x-wrap

— Command-line option: `--x-wrap=<value>`
— Environment variable: `LW6_X_WRAP`
— XML key: `x-wrap`

> Type: boolean

> Default value: true

> Defines wether the map should be wrapped on the x axis. This is the companion of 'x-polarity', if no polarity is defined, map can't be wrapped, but in some cases, one might wish to have a map with polarity but without wrapping if, for instance, textures do not tile nicely.

#### 4.13.54 y-wrap

— Command-line option: `--y-wrap=<value>`
— Environment variable: `LW6_Y_WRAP`
— XML key: `y-wrap`

> Type: boolean

> Default value: true

> Defines wether the map should be wrapped on the y axis. This is the companion of 'y-polarity', if no polarity is defined, map can't be wrapped, but in some cases, one might wish to have a map with polarity but without wrapping if, for instance, textures do not tile nicely.

#### 4.13.55 zoom

— Command-line option: `--zoom=<value>`
— Environment variable: `LW6_ZOOM`
— XML key: `zoom`

> Type: float

> Default value: 1.0

> Defines the map zoom. If lower than 1.0, map will occupy only a fraction of the screen, if greater than 1.0, some areas will be outside the screen, and the player will need to scroll through it.

#### 4.13.56 zoom-max

— Command-line option: `--zoom-max=<value>`
— Environment variable: `LW6_ZOOM_MAX`
— XML key: `zoom-max`

> Type: float

> Default value: 30.0

> Defines the max map zoom. If set to a high value, you'll be able to dynamically view the map with hudge fighters, seeing only a fraction of the level.

#### 4.13.57 zoom-min

— Command-line option: `--zoom-min=<value>`
— Environment variable: `LW6_ZOOM_MIN`
— XML key: `zoom-min`

> Type: float

> Default value: 0.3

> Defines the min map zoom. If set to a low value, you'll be able to dynamically view a very small, reduced map.