GameConfigWML - Revision history

Soliton: /* The [game_config] tag */

2025-06-27T14:34:48Z

‎The [game_config] tag

Soliton: /* Color Palettes */

2025-01-16T17:17:01Z

‎Color Palettes

Soliton: /* Color Palettes */

2025-01-16T17:16:37Z

‎Color Palettes

Soliton: /* Color Palettes */

2025-01-16T16:55:59Z

‎Color Palettes

Soliton: /* Color Palettes */

2025-01-16T15:02:43Z

‎Color Palettes

Dalas120 at 22:01, 14 January 2025

2025-01-14T22:01:37Z

Octalot: /* The [game_config] tag */ Document the orbs

2023-01-31T06:15:51Z

‎The [game_config] tag: Document the orbs

Octalot: /* The [game_config] tag */ Update docs about orbs, and clear out some of the obsolete data

2023-01-24T01:34:32Z

‎The [game_config] tag: Update docs about orbs, and clear out some of the obsolete data

Josteph: /* Color Palettes */ delete sentence that seems to be wrong (tested with Ravana's color changer and #4366)

2019-09-26T18:32:23Z

‎Color Palettes: delete sentence that seems to be wrong (tested with Ravana's color changer and #4366)

Celtic Minstrel: Document [color_range] and [color_palette]

2018-05-08T00:37:21Z

Document [color_range] and [color_palette]

@@ Line 11: / Line 11: @@
 * '''base_income''': (standard 2) how much your leader earns without any villages
 * '''village_income''': (standard 1) how much your leader earns for each village you control
 * '''poison_amount''': (standard 8) the amount of damage poison deals to a unit
 * '''rest_heal_amount''': (standard 2) how much HP a unit gains each turn it rests

@@ Line 66: / Line 66: @@
 **# the minimum shadow shade of a unit's team-color portions
 **# the color of the markers on the mini-map.
-** '''default''': (only under '''[game_config]''') if yes this color is added to the colors that get assigned to sides/teams by default in the order they appear (side 1 gets the first color with default=yes (red) etc)
+** '''default''': (only under '''[game_config]''') if yes this color is added to the colors that get assigned to sides by default in the order they appear (side 1 gets the first color with default=yes (red) etc)
 == See Also ==

@@ Line 66: / Line 66: @@
 **# the minimum shadow shade of a unit's team-color portions
 **# the color of the markers on the mini-map.
-** '''default''': (only in '''[game_config]''') if yes this color is added to the colors that get assigned to sides/teams by default in the order they appear (side 1 gets the first color with default=yes (red) etc)
+** '''default''': (only under '''[game_config]''') if yes this color is added to the colors that get assigned to sides/teams by default in the order they appear (side 1 gets the first color with default=yes (red) etc)
 == See Also ==

@@ Line 66: / Line 66: @@
 **# the minimum shadow shade of a unit's team-color portions
 **# the color of the markers on the mini-map.
 == See Also ==

@@ Line 55: / Line 55: @@
 == Color Palettes ==
-Color palettes are defined by two tags within '''[game_config]'''.
+Color palettes are defined by two tags within '''[game_config]'''. These tags also work in a couple of other places (https://github.com/wesnoth/wesnoth/issues/8555) like the top level.
 * '''[color_palette]''': Contains the definitions of source palettes, such as magenta. Each key defines a palette, and must be set to a comma-separated list of hexadecimal colors.
-* '''[color_range]''': Defines a target color palette. This tag can also be used at top level.
+* '''[color_range]''': Defines a target color palette.
 ** '''id''': Used to reference the palette, for example from '''[side]''' or ~RC().
 ** '''name''': A translatable name for the color. <s>This may be ignored for non-core colors?</s>

@@ Line 22: / Line 22: @@
 * '''energy''': (standard 'misc/bar-energy.png') the images used to display hp/xp bars.
 * '''orb''': (standard 'misc/orb.png') the orb image to add on top of the hp bar, this is recolorable to show the status; see 'Orbs', [[WesnothManual]]
-* '''orb_two_color''': (standard 'misc/orb-two-color.png') like '''orb''', but has two separate recolorable parts
+* '''orb_two_color''': (standard 'misc/orb-two-color.png') like '''orb''', but has two separate recolorable parts. Note this is the image to use, although the colors to use for recoloring it also have names that end '_color'.
 * '''flag_image''': (standard 'image/flag'terrain/flag-1.png:150,terrain/flag-2.png:150,terrain/flag-3.png:150,terrain/flag-4.png:150') the default flag animation to mark captured villages (if no custom flag is defined in the [side] tag). By example, this animation has 4 frames of 150ms each. An automatic side-coloring is applied.

@@ Line 6: / Line 6: @@
 In official versions of Wesnoth it is in ''game_config.cfg''; values used there are labeled 'standard'.
 The following keys are recognised
@@ Line 15: / Line 16: @@
 * '''kill_experience''': (standard 8) killing a unit with ''level=X'' will give ''X''*''kill_experience'' experience to the killing unit. However, if a unit has ''level=0'', it will still give half of ''X'' experience.
 * '''default_defeat_music''': (standard 'defeat.ogg,defeat2.ogg') default list of music tracks that are chosen to play on player's defeat; this can be overriden per-scenario
 * '''default_victory_music''': (standard 'victory.ogg,victory2.ogg') default list of music tracks that are chosen to play on player's victory; this can be overriden per-scenario
 * '''title_music''': (standard 'main_menu.ogg') the music to play at the title screen
-* '''map_image''':   (standard 'maps/wesnoth.png') the background image for the "About" screen
+* '''energy''': (standard 'misc/bar-energy.png') the images used to display hp/xp bars.
-* '''sidebar_image''': (standard 'misc/rightside.png') border of window when displaying unit statistics
+* '''orb''': (standard 'misc/orb.png') the orb image to add on top of the hp bar, this is recolorable to show the status; see 'Orbs', [[WesnothManual]]
-* '''sidebar_image_bottom''': (standard 'misc/rightside-bottom.png') border of image when displaying unit statistics
+* '''orb_two_color''': (standard 'misc/orb-two-color.png') like '''orb''', but has two separate recolorable parts
-* '''energy_image''': (standard 'misc/bar-energy.png') the images used to display hp/xp bars.
 * '''flag_image''': (standard 'image/flag'terrain/flag-1.png:150,terrain/flag-2.png:150,terrain/flag-3.png:150,terrain/flag-4.png:150') the default flag animation to mark captured villages (if no custom flag is defined in the [side] tag). By example, this animation has 4 frames of 150ms each. An automatic side-coloring is applied.
 * '''flag_icon_image''': (standard 'flags/flag-icon.png') the default flag icon to indicate the side playing in the statusbar (if no custom flag_icon is defined in the [side] tag). An automatic side-coloring is applied.
 * ''' hp_bar_scaling ''': (standard '0.6') The ratio of hitpoints to height used for displaying the hp bar. Can be overwritten in [unit] and [unit_type].
 * ''' xp_bar_scaling ''': (standard '0.5') The ratio of xp to height used for displaying the xp bar. Can be overwritten in [unit] and [unit_type].
 * '''footprint_left_nw''', '''footprint_left_n''', '''footprint_right_nw''', '''footprint_right_n''': images used to display the path that a unit would take to the tile the cursor is on.
@@ Line 56: / Line 40: @@
 * '''unreachable_image''': (standard 'terrain/darken.png') the stripes mask used to show unreachable locations
 * '''observer_image''': (standard 'misc/eye.png') the image to use for observer in multi-player games. (The eye in the upper right hand corner.)
 * '''zoom_levels''': {{DevFeature1.13|8}} A comma-separated list of valid zoom levels, with 1.0 representing 100%.

@@ Line 69: / Line 69: @@
 * '''[color_range]''': Defines a target color palette.
 ** '''id''': Used to reference the palette, for example from '''[side]''' or ~RC().
-** '''name''': A translatable name for the color. This may be ignored for non-core colors?
+** '''name''': A translatable name for the color. <s>This may be ignored for non-core colors?</s>
 ** '''rgb''': A comma-separated sequence of four hexadecimal colors:
 **# the average shade of a unit's team-color portions