TerrainWML - Revision history

Soliton: /* the toplevel [terrain_type] tag */

2025-04-30T13:46:05Z

‎the toplevel [terrain_type] tag

2025-03-24T03:59:11Z

Better explanation

2025-03-20T10:07:26Z

‎the toplevel [terrain_type] tag

2025-03-10T14:17:25Z

‎the toplevel [terrain_type] tag

2024-05-10T13:37:42Z

Bold tag name

2024-01-04T14:04:06Z

‎the toplevel [terrain_type] tag

2023-09-02T23:00:35Z

More undocumented keys

2023-09-02T22:10:53Z

Document where the image in the help comes from

2019-10-01T15:23:46Z

‎the toplevel [terrain_type] tag: Note that max_light can stack with TOD bonus

2019-08-25T08:03:00Z

‎the toplevel [terrain_type] tag: vision_alias has no effect

@@ Line 3: / Line 3: @@
 The '''[terrain_type]''' tag describes a terrain in WML.
-Terrains are usually described in the terrain.cfg file
+Terrains are usually described in the terrain.cfg file. How the terrain is displayed on the map is decided by [[TerrainGraphicsWML|[terrain_graphics]]].
 The '''[terrain_type]''' tag has the following keys and subtags

@@ Line 33: / Line 33: @@
 * '''editor_group''': a comma separated list of editor_group ids to which this terrain belongs (about editor groups see https://wiki.wesnoth.org/EditorWML#The_.5Beditor_group.5D_tag )
 * '''help_topic_text''': a long description, which will be shown as part of the help page for this terrain.
-* '''hide_if_impassable''': hide the terrain if a unit cannot move on it
+* '''hide_if_impassable''': hide the terrain from the movetype summary if a unit cannot move on it
 * '''hidden''': (boolean) if set to 'yes', makes this terrain not appear in the map editor palettes. A side effect of setting this is that the editor_image will be empty.
 * '''hide_help''': (boolean) if set to 'yes', makes this terrain not appear in the terrain help browser.

@@ Line 33: / Line 33: @@
 * '''editor_group''': a comma separated list of editor_group ids to which this terrain belongs (about editor groups see https://wiki.wesnoth.org/EditorWML#The_.5Beditor_group.5D_tag )
 * '''help_topic_text''': a long description, which will be shown as part of the help page for this terrain.
-* '''hide_if_impassable''':
+* '''hide_if_impassable''': hide the terrain if a unit cannot move on it
 * '''hidden''': (boolean) if set to 'yes', makes this terrain not appear in the map editor palettes. A side effect of setting this is that the editor_image will be empty.
 * '''hide_help''': (boolean) if set to 'yes', makes this terrain not appear in the terrain help browser.

@@ Line 19: / Line 19: @@
 * '''max_light''': signed value: this is the maximum local light level that may be indicated by light=. Defaults to the value of light= and is effectively overridden by the time-of-day lighting, if that is higher. If this is higher than the time-of-day lighting then the local light level can stack in addition to the TOD light - for example, lava (light=25, max_light=35) provides a 35% boost for lawful units at daytime.
 * '''min_light''': signed value: this is the minimum local light level that may be indicated by light=. Defaults to the value of light= and is effectively overridden by the time-of-day lighting, if that is lower.
-* '''heals''': positive value: the amount of HP a unit on this terrain will be healed at the start of every turn.
+* '''heals''': positive value: the amount of HP a unit on this terrain will be healed at the start of every turn. Any value besides 0 also causes curing poison.
 * '''gives_income''': if set to true, this terrain will give income every turn when flagged, as if it were a village
 * '''recruit_onto''': if set to true, it is possible to recruit or recall on that terrain

@@ Line 2: / Line 2: @@
 == the toplevel [terrain_type] tag ==
-The [terrain_type] tag describes a terrain in WML.
+The '''[terrain_type]''' tag describes a terrain in WML.
 Terrains are usually described in the terrain.cfg file
-the [terrain_type] tag has the following keys and subtags
+The '''[terrain_type]''' tag has the following keys and subtags
 * '''symbol_image''': an image used for this terrain in the minimap
 * '''editor_image''': an image used for this terrain in the map editor; if not defined uses symbol_image. This image will also be displayed in the help page for this terrain.

@@ Line 31: / Line 31: @@
 * '''income_description_enemy''': like ''income_description'' but if owned by an enemy
 * '''income_description_own''': like ''income_description'' but if owned by yourself
-* '''editor_group''': a comma separated list of editor_group ids to which this terrain belongs.
+* '''editor_group''': a comma separated list of editor_group ids to which this terrain belongs
 * '''hidden''': (boolean) if set to 'yes', makes this terrain not appear in the map editor palettes. A side effect of setting this is that the editor_image will be empty.
 * '''hide_help''': (boolean) if set to 'yes', makes this terrain not appear in the terrain help browser.

@@ Line 26: / Line 26: @@
 * '''def_alias''': like ''aliasof'' but overides it for defense calculation only
 * '''mvt_alias''': like ''aliasof'' but overides it for movement calculation only
-* '''vision_alias''': like ''aliasof'' but overides it for vision calculation only
+* '''vision_alias''': has no effect, see [https://github.com/wesnoth/wesnoth/pull/4278 PR #4278].
 * '''income_description''': for terrains with ''gives_income'' and owned by nobody this text is shown in the terrain description in the top bar before the brackets. This tag is optional, if not supplied Wesnoth will assume the terrain is a village and sets an appropriate message.
 * '''income_description_ally''': like ''income_description'' but if owned by an ally