TerrainCodesWML - Revision history

Soliton: /* Terrain codes in map data */

2025-06-05T15:39:51Z

‎Terrain codes in map data

Octalot: /* Decoding the Terrain Codes */ P is used for Portals

2024-04-29T05:30:47Z

‎Decoding the Terrain Codes: P is used for Portals

Octalot: /* Decoding the Terrain Codes */ Q is used for elevation overlays

2024-04-29T04:49:48Z

‎Decoding the Terrain Codes: Q is used for elevation overlays

Soliton: /* Terrain strings */

2023-08-11T15:34:46Z

‎Terrain strings

Celtic Minstrel: /* Decoding the Terrain Codes */ Add t

2023-02-17T06:54:19Z

‎Decoding the Terrain Codes: Add t

Soliton: /* See Also */

2021-12-15T15:17:08Z

‎See Also

Shadowm: /* Terrain strings */

2020-05-04T14:07:27Z

‎Terrain strings

Soliton: /* Decoding the Terrain Codes */

2019-10-25T12:27:12Z

‎Decoding the Terrain Codes

Celtic Minstrel: /* Decoding the Terrain Codes */ The T terrains are now in mainline

2019-10-25T12:13:10Z

‎Decoding the Terrain Codes: The T terrains are now in mainline

Octalot: /* Decoding the Terrain Codes */ Add Rails

2019-09-01T16:27:42Z

‎Decoding the Terrain Codes: Add Rails

@@ Line 108: / Line 108: @@
 ** For Wesnoth 1.14, more than 9 sides can work, discussion https://r.wesnoth.org/t48129 and https://r.wesnoth.org/t48082
 * {{DevFeature1.13|12}} In addition to side numbers, terrains may be prefixed by any number of strings (which should consist of alphanumeric characters only, including underscores). All names and side numbers must be delimited by spaces and are separated from the actual terrain code by an additional space.
-** This is broken according to https://r.wesnoth.org/p627595
+** <s>This is broken according to https://r.wesnoth.org/p627595</s> I don't see how this is broken. The editor (as of 1.19.12) only displays a single string per hex though.
 Since text file tiles are squares while game tiles are hexes, some tiles must be shifted.

@@ Line 46: / Line 46: @@
 * N
 * O
-* P
+* P = “Portal” i.e. doors, gates
 * Q = "Un-walkable", {{DevFeature1.17|7}} also used for elevation overlays
 * R = “Road”, also used for “Rails”

@@ Line 47: / Line 47: @@
 * O
 * P
-* Q = "Un-walkable"
+* Q = "Un-walkable", {{DevFeature1.17|7}} also used for elevation overlays
 * R = “Road”, also used for “Rails”
 * S = “Swamp”

@@ Line 7: / Line 7: @@
 The following rules hold for terrain strings. Note most of these rules are not validated since it would slow down Wesnoth; not following these rules might break Wesnoth.
-* terrain strings are composed from one or more terrain codes of 2 to 4 characters each, separated by ^.
+* terrain strings are composed from one or two terrain codes of 2 to 4 characters (bytes) each, separated by ^.
 * terrain codes start with a capital letter and the following letters are lower case
 * terrain strings can only contain letters, the symbols /|\ which are meant for directional items like bridges and the symbol ^
 * the underscore is used as a leader for internal terrain codes
-* the star '*' can be used for wildcards in some places where a terrain code is required
+* the star '*' can be used for wildcards in some places where a terrain code is required for matching
 * the symbol ^ indicates that a terrain is created with layers, for example Gs^Fp means Semi-dry Grass(<b>Gs</b>) with a Forest(<b>Fp</b>) overlay.
-Starting positions are defined by a number followed by 1 space and then the terrain string; this means that a starting position is no longer automatically a keep.
+Starting positions are defined by a number followed by 1 space and then the terrain string.
 The letters Y,y,Z,z are reserved for UMC and mainline campaigns, so any string containing any of these letters is a custom terrain. Other undefined terrain strings are reserved for future expansion within Wesnoth.

@@ Line 81: / Line 81: @@
 * r
 * s = "simple"
-* t
+* t = "archetype", a hidden terrain used only as a base for other terrains
 * u = "underground"
 * v = "elvish"

@@ Line 124: / Line 124: @@
 == See Also ==
 * [[TerrainWML]]
 * [[ReferenceWML]]
 [[Category: WML Reference]]

@@ Line 16: / Line 16: @@
 Starting positions are defined by a number followed by 1 space and then the terrain string; this means that a starting position is no longer automatically a keep.
-The letters Y,y,Z,z are reserved for UMC so any string containing any of these letters is a custom terrain. Other undefined terrain strings are reserved for future expansion within Wesnoth.
+The letters Y,y,Z,z are reserved for UMC and mainline campaigns, so any string containing any of these letters is a custom terrain. Other undefined terrain strings are reserved for future expansion within Wesnoth.
 === Terrain Table ===

@@ Line 50: / Line 50: @@
 * R = “Road”, also used for “Rails”
 * S = “Swamp”
-* T = {{DevFeature1.15|?}} “Toadstool” i.e. fungus
+* T = {{DevFeature1.15|2}} “Toadstool” i.e. fungus
 * U = “Underground”
 * V = “Village”

@@ Line 37: / Line 37: @@
 * E = "Embellishment"
 * F = “Forest”
-* G = “Grass”
+* G = “Grass” i.e. flat
 * H = “Hills”
 * I = "Interior" (possible future use)
@@ Line 48: / Line 48: @@
 * P
 * Q = "Un-walkable"
-* R = “Road”
+* R = “Road”, also used for “Rails”
 * S = “Swamp”
 * T = {{DevFeature1.15|?}} currently in discussion about using for “Toadstool” i.e. fungus