GameConfigWML - Revision history

Octalot: /* Color Palettes */ Add font_color

2026-09-13T14:43:24Z

Color Palettes: Add font_color

← Older revision		Revision as of 14:43, 13 September 2026
Line 63:		Line 63:
	** '''name''': A translatable name for the color. <s>This may be ignored for non-core colors?</s>		** '''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:		** '''rgb''': A comma-separated sequence of four hexadecimal colors:
	**# the average shade of a unit's team-color portions		**# the average shade ("mid") of a unit's team-color portions
	**# the maximum highlight shade of a unit's team-color portions		**# the maximum highlight shade of a unit's team-color portions
	**# the minimum shadow shade of a unit's team-color portions		**# the minimum shadow shade of a unit's team-color portions
	**# the color of the markers on the mini-map.		**# the color of the markers on the mini-map.
			** '''font_color''': {{DevFeature1.19\|28}} one hexadecimal color, which is used for text, for example the player name in chat messages. Defaults to the "mid" shade.
	** '''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)		** '''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)

Soliton: /* The [game_config] tag */

2025-06-27T14:34:48Z

The [game_config] tag

← Older revision		Revision as of 14:34, 27 June 2025
Line 11:		Line 11:
	* '''base_income''': (standard 2) how much your leader earns without any villages		* '''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		* '''village_income''': (standard 1) how much your leader earns for each village you control
			* '''village_support''': (standard 1) how many unit levels a village supports
	* '''poison_amount''': (standard 8) the amount of damage poison deals to a unit		* '''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		* '''rest_heal_amount''': (standard 2) how much HP a unit gains each turn it rests

Soliton: /* Color Palettes */

2025-01-16T17:17:01Z

Color Palettes

← Older revision		Revision as of 17:17, 16 January 2025
Line 66:		Line 66:
	**# the minimum shadow shade of a unit's team-color portions		**# the minimum shadow shade of a unit's team-color portions
	**# the color of the markers on the mini-map.		**# 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 ==		== See Also ==

Soliton: /* Color Palettes */

2025-01-16T17:16:37Z

Color Palettes

← Older revision		Revision as of 17:16, 16 January 2025
Line 66:		Line 66:
	**# the minimum shadow shade of a unit's team-color portions		**# the minimum shadow shade of a unit's team-color portions
	**# the color of the markers on the mini-map.		**# 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 ==		== See Also ==

Soliton: /* Color Palettes */

2025-01-16T16:55:59Z

Color Palettes

← Older revision		Revision as of 16:55, 16 January 2025
Line 66:		Line 66:
	**# the minimum shadow shade of a unit's team-color portions		**# the minimum shadow shade of a unit's team-color portions
	**# the color of the markers on the mini-map.		**# 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)

	== See Also ==		== See Also ==

Soliton: /* Color Palettes */

2025-01-16T15:02:43Z

Color Palettes

← Older revision		Revision as of 15:02, 16 January 2025
Line 55:		Line 55:
	== Color Palettes ==		== 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_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().		** '''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>		** '''name''': A translatable name for the color. <s>This may be ignored for non-core colors?</s>

Dalas120 at 22:01, 14 January 2025

2025-01-14T22:01:37Z

← Older revision		Revision as of 22:01, 14 January 2025
Line 58:		Line 58:

	* '''[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_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.		* '''[color_range]''': Defines a target color palette. This tag can also be used at top level.
	** '''id''': Used to reference the palette, for example from '''[side]''' or ~RC().		** '''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>		** '''name''': A translatable name for the color. <s>This may be ignored for non-core colors?</s>

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

2023-01-31T06:15:51Z

The [game_config] tag: Document the orbs

← Older revision		Revision as of 06:15, 31 January 2023
Line 22:		Line 22:
	* '''energy''': (standard 'misc/bar-energy.png') the images used to display hp/xp bars.		* '''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''': (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'.
			* '''show_moved_orb''', '''show_partial_orb''', '''show_unmoved_orb''': (default to 'yes' when omitted from the .cfg) whether to show the orb for the player's own units when they're in the given state
			* '''show_disengaged_orb''': (defaults to 'yes' when omitted from the .cfg) whether to show a special orb instead of the "partial" orb when a unit can move but can't attack
			* '''show_ally_orb''': (defaults to 'yes' when omitted from the .cfg) whether to show an orb on allied units
			* '''show_enemy_orb''': (defaults to '' 'no' '' when omitted from the .cfg) whether to show an orb on opposing units
			* '''show_status_on_ally_orb''': (defaults to 'yes' when omitted from the .cfg) if true, during allies' turns their units have orbs that show the unmoved/partial/moved status. If true, overrides 'show_ally_orb' during that ally's turn.
			* '''ally_orb_color''': (standard 'lightblue') target for recoloring the ally orb
			* '''enemy_orb_color''': (standard 'black') target for recoloring the enemy orb, although by default this orb is not shown
			* '''moved_orb_color''': (standard 'red') target for recoloring the moved orb
			* '''partial_orb_color''': (standard 'brightorange') target for recoloring the partially-moved orb, also used for half of the disengaged orb
			* '''unmoved_orb_color''': (standard 'brightgreen') target for recoloring the fully-moved orb, also used for half of the disengaged orb

	* '''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_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.

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

← Older revision		Revision as of 01:34, 24 January 2023
Line 6:		Line 6:
	In official versions of Wesnoth it is in ''game_config.cfg''; values used there are labeled 'standard'.		In official versions of Wesnoth it is in ''game_config.cfg''; values used there are labeled 'standard'.

			{{Note\|This page is very outdated, and will take multiple edits to update.}}

	The following keys are recognised		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.		* '''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.

	* '''icon''': (standard 'wesnoth-icon.png') the game icon file
	* '''title''': (standard 'misc/title.png') the title screen image
	* '''logo''': (standard 'misc/logo.png') the wesnoth logo which will be put over the title image
	* '''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_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		* '''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		* '''title_music''': (standard 'main_menu.ogg') the music to play at the title screen
	* '''logo_x''': (standard 292) the x position of the logo on the title screen
	* '''logo_y''': (standard 120) the y position of the logo on the title screen
	* '''buttons_x''': (standard 760) the x position of the buttons on the title screen
	* '''buttons_y''': (standard 330) the y position of the buttons on the title screen
	* '''buttons_padding''': (standard 20) space between buttons, and border in main menu
	* '''tip_x''': (standard 100) space between the button panel left edge and the tip-of-the-day panel right edge
	* '''tip_y''': (standard 500) not used (the bottom right corner of the tip-of-the-day panel is pegged to align with the bottom of the button panel)
	* '''tip_width''': (standard 495) max width in pixels of the tip-of-the-day panel. The width will actually adjust to be the smallest size necessary to fit the text. Once the max width is reached, if text must flow onto multiple lines, then the height will also automatically adjust.
	* '''tip_padding''': (standard 20) space between the edge of the tip-of-the-day panel and an imaginary bounding box containing the text inside the panel

	* '''~~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.
	* '''~~moved_ball_image~~''': (standard 'misc/~~ball-moved~~.png') the orb image to add on top of the hp bar ~~for player's moved units~~; see 'Orbs', [[WesnothManual]]
	* '''~~unmoved_ball_image~~''': (standard 'misc/~~ball~~-~~unmoved~~.png') like '''~~moved_ball_image~~''', but ~~for player's unmoved units~~
	* '''partmoved_ball_image''': (standard 'misc/ball-partmoved.png') like '''moved_energy_image''', but for player's partially moved units
	* '''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_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.		* '''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].		* ''' 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].		* ''' 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].
	* '''cross_image''': (standard 'misc/cross.png') the cross image displayed on the map at start of scenarios; see [[IntroWML]]
	* '''dot_image''': (standard 'misc/dot.png') the dot image used to draw a path on the map before scenarios

	* '''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.		* '''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		* '''unreachable_image''': (standard 'terrain/darken.png') the stripes mask used to show unreachable locations

	* '''missile_n_image''': (standard 'projectiles/missile-n.png') orthogonal missile image to use if none is specified; see ''image'', '''[missile_frame]''', [[AnimationWML]]
	* '''missile_ne_image''': (standard 'projectiles/missile-ne.png') diagonal missile image to use if none is specified; see ''image_diagonal'', '''[missile_frame]''', [[AnimationWML]]
	* '''observer_image''': (standard 'misc/eye.png') the image to use for observer in multi-player games. (The eye in the upper right hand corner.)		* '''observer_image''': (standard 'misc/eye.png') the image to use for observer in multi-player games. (The eye in the upper right hand corner.)
	* '''download_campaign_image''': (standard no image) the icon for the "Download more Campaigns" campaign menu option.
	* '''zoom_levels''': {{DevFeature1.13\|8}} A comma-separated list of valid zoom levels, with 1.0 representing 100%.		* '''zoom_levels''': {{DevFeature1.13\|8}} A comma-separated list of valid zoom levels, with 1.0 representing 100%.

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)

← Older revision		Revision as of 18:32, 26 September 2019
Line 69:		Line 69:
	* '''[color_range]''': Defines a target color palette.		* '''[color_range]''': Defines a target color palette.
	** '''id''': Used to reference the palette, for example from '''[side]''' or ~RC().		** '''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:		** '''rgb''': A comma-separated sequence of four hexadecimal colors:
	**# the average shade of a unit's team-color portions		**# the average shade of a unit's team-color portions