Des-file format (UnNetHack) - Revision history

Netzhack: (x,y) is a pair of coordinates (plural) which represent a point (singular) on a two-dimensional map.

2018-08-10T19:22:29Z

(x,y) is a *pair* of coordinates (plural) which represent a point (singular) on a two-dimensional map.

Netzhack: (x, y) is a pair of coordinates (plural) defining a point in two dimensions.

2018-08-10T18:34:12Z

(x, y) is a pair of coordinates (plural) defining a point in two dimensions.

Paxed: /* MAP */

2013-10-02T16:57:02Z

‎MAP

Paxed: MINERALIZE

2013-09-13T10:20:42Z

MINERALIZE

Ozymandias: /* Trap names */

2013-09-08T18:29:03Z

‎Trap names

Paxed: ROOM, SUBROOM, REGION: fill & join flags

2013-09-05T16:23:29Z

ROOM, SUBROOM, REGION: fill & join flags

Paxed: /* Predefined functions and constants */ region(x1,y1,x2,y2)

2013-09-03T14:24:31Z

‎Predefined functions and constants: region(x1,y1,x2,y2)

Paxed: /* REGION */ irregular

2013-09-03T11:53:35Z

‎REGION: irregular

Paxed: /* REGION */ filling

2013-09-03T09:50:34Z

‎REGION: filling

Paxed: /* INIT_MAP */ rogue

2013-08-30T13:20:51Z

‎INIT_MAP: rogue

@@ Line 242: / Line 242: @@
 ===SPILL===
   SPILL:{{sa|coord or variable}}, terrain_type, direction, length
-Create random "pool-like" globs of terrain, starting from coordinates, generally moving towards direction, and at maximum length positions.
+Create random "pool-like" globs of terrain, starting from coordinates, generally moving towards direction, and at a maximum of length positions.
 Coordinates, terrain_type and length can be variables of the appropriate type.
@@ Line 401: / Line 401: @@
 You define a map-part by "drawing" with [[#Map characters|map characters]] between the MAP and ENDMAP. The map can be up to 21 lines high and each line can be up to 76 chars long. Each line must also be the same length. You can also use numbers inside the map, but those will be ignored; they're considered as line numbers.
-The top left of the MAP is coordinate (0,0)
+The top left point of the MAP is represented by the coordinates (0,0).
 See also {{sa|NOMAP}}.
@@ Line 409: / Line 409: @@
   MAZEWALK:{{sa|coord or variable}}, direction, stocked
   MAZEWALK:{{sa|coord or variable}}, direction, stocked, '.'
-Creates a random maze, starting from coordinate.
+Creates a random maze, starting from the coordinates.
 stocked is an optional boolean value and tells whether the maze should get stocked with random loot and monsters.
@@ Line 592: / Line 592: @@
 ===coord or variable===
-This parameter can be either a coordinate, or a variable of the coordinate type. For example:
+This parameter can be either a pair of coordinates, or a variable of the type coord. For example:
   GRAVE: (10,5)
   $foo = (4,10)
@@ Line 600: / Line 600: @@
   GRAVE: rndcoord({{sa|selection}})
-A random coordinate selected from within the {{sa|selection}}
+A random pair of coordinates selected from within the {{sa|selection}}
-The x and y components of a coordinate can be accessed (but not set) separately:
+The x and y coordinates can be accessed (but not set) separately:
   $foo = (4, 10)
   IF [ $foo.x == 4 ] {
@@ Line 634: / Line 634: @@
 ===selection===
-A selection is a collection of map coordinates. The <tt>selection</tt> keyword is only needed when defining a variable of selection type.
+A selection is a collection of points, represented by map coordinates. The <tt>selection</tt> keyword is only needed when defining a variable of selection type.
 Selections can be added together with the '&' operator, for example <tt>rect(5,5, 50,18) & rect(10,2, 40,13)</tt>:
@@ Line 664: / Line 664: @@
 ====line====
   $foo = selection:line {{sa|coord or variable}}-{{sa|coord or variable}}
-The selection contains a straight line between the coordinates.
+The selection contains a straight line between the points.
 Example:
@@ Line 671: / Line 671: @@
 ====random line====
   $foo = selection:randline {{sa|coord or variable}}-{{sa|coord or variable}},{{sa|mathematical expression}}
-The selection contains a meandering line between the coordinates. The integer value is the "roughness" of the line.
+The selection contains a meandering line between the points. The integer value is the "roughness" of the line.
 Example:
@@ Line 679: / Line 679: @@
   $foo = selection:grow ({{sa|selection}})
   $foo = selection:grow ({{sa|list of directions}}, {{sa|selection}})
-Grow a selection by adding the surrounding map points into it. The second form can take a list of directions, and the growth will pick points from those directions to grow into.
+Grow a selection by adding the surrounding map points to it. The second form can take a list of directions, and the growth will pick points from those directions to grow into.
 Example:
@@ Line 689: / Line 689: @@
   $foo = selection:filter ({{sa|selection}}, {{sa|selection}})
   $foo = selection:filter ({{sa|map character or variable}}, {{sa|selection}})
-Remove coordinates from the selection. The first form picks (at random) 50% of the coordinates in the selection, the second chooses points that are common to both selections, third one leaves only places that match the map character.
+Remove points from the selection. The first form picks (at random) 50% of the points in the selection, the second chooses points that are common to both selections, third one leaves only places that match the map character.
 Example:
@@ Line 697: / Line 697: @@
 ====floodfill====
   $foo = selection:floodfill {{sa|coord or variable}}
-"Floodfill" from the coordinate, and add all connected coordinates with the same terrain type to the selection.
+"Floodfill" from the point, adding all connected points with the same terrain type to the selection.
 ====circle====
@@ Line 703: / Line 703: @@
   $foo = selection:circle ({{sa|coord or variable}}, {{sa|mathematical expression}}, filled)
   $foo = selection:circle ({{sa|coord or variable}}, {{sa|mathematical expression}}, unfilled)
-Circle shape. Parameters are center coordinate, radius, and optional <tt>filled</tt> or <tt>unfilled</tt>.
+Circle shape. Parameters are center point, radius, and optional <tt>filled</tt> or <tt>unfilled</tt>.
 Creates an unfilled circle by default.
@@ Line 716: / Line 716: @@
   $foo = selection:ellipse ({{sa|coord or variable}}, {{sa|mathematical expression}}, {{sa|mathematical expression}}, filled)
   $foo = selection:ellipse ({{sa|coord or variable}}, {{sa|mathematical expression}}, {{sa|mathematical expression}}, unfilled)
-Ellipse shape. Parameters are center coordinate, horizontal and vertical radius, and optional <tt>filled</tt> or <tt>unfilled</tt>.
+Ellipse shape. Parameters are center point, horizontal and vertical radius, and optional <tt>filled</tt> or <tt>unfilled</tt>.
 Creates an unfilled ellipse by default.
@@ Line 734: / Line 734: @@
 grad_type can be one of "radial" or "square", and affects the distance calculation from the center.
-Using an optional second coordinate, the "center" of the area is a line segment between the two coordinates.
+If the optional second pair of coordinates is given, the "center" of the area is a line segment between the two pairs of coordinates.
 For example:
@@ Line 745: / Line 745: @@
 ====rndcoord====
-To select a random coordinate from a selection, use <tt>rndcoord({{sa|selection}})</tt>:
+To select a random pair of coordinates from a selection, use <tt>rndcoord({{sa|selection}})</tt>:
   $bar = rndcoord(rect(5,5, 50,18) & rect(10,2, 40,13))
@@ Line 806: / Line 806: @@
 |level.obj_at(obj, coord)
 |integer, 0 or 1
-|Return 1 if there's certain object at coordinate.
+|Return 1 if the specified object is present at the coordinates.
 |-
 |level.mon_at(monster, coord)
 |integer, 0 or 1
-|Return 1 if there's a monster of certain class, or a certain type of monster, or any monster at coordinate. <tt>level.mon_at(monster:'h', (5,5))</tt> matches any monster of class {{white|h}}, <tt>level.mon_at(monster:('h', "hobbit"), (5,5))</tt> matches only a hobbit, <tt>level.mon_at(monster:random, (5,5))</tt> matches any monster.
+|Return 1 if there's a monster of certain class, or a certain type of monster, or any monster at the coordinates. <tt>level.mon_at(monster:'h', (5,5))</tt> matches any monster of class {{white|h}}, <tt>level.mon_at(monster:('h', "hobbit"), (5,5))</tt> matches only a hobbit, <tt>level.mon_at(monster:random, (5,5))</tt> matches any monster.
 |-
 |hero.name
@@ Line 837: / Line 837: @@
 |-
 |coord(int, int)
-|coordinate
+|coordinates
-|Convert two integer values into a coordinate
+|Convert two integer values into a pair of map coordinates.
 |-
 |region(int, int, int, int)

@@ Line 199: / Line 199: @@
 *<tt>state</tt> is either <tt>closed</tt>, <tt>open</tt> or <tt>random</tt>.
-Note that the drawbridge placement is different from door placement; the coordinate must be a place where the drawbridge would be when it's open, and from that place towards the direction there should be a wall, where the portcullis will be.
+Note that the drawbridge placement is different from door placement; the coordinates must be a place where the drawbridge would be when it's open, and from that place towards the direction there should be a wall, where the portcullis will be.
 Example:
@@ Line 215: / Line 215: @@
 ===FOUNTAIN===
   FOUNTAIN:{{sa|selection}}
-Create a fountain in each coordinate in the selection.
+Create a fountain at each pair of coordinates in the selection.
 ===POOL===
   POOL:{{sa|selection}}
-Create a pool in each coordinate in the selection.
+Create a pool at each pair of coordinates in the selection.
 ===SINK===
   SINK:{{sa|selection}}
-Create a sink in each coordinate in the selection.
+Create a sink at each pair of coordinates in the selection.
 ===TERRAIN===
   TERRAIN:{{sa|selection}}, map_character_or_variable
-Set the terrain in each coordinate in the selection.
+Set the terrain at each pair of coordinates in the selection.
 Example:
@@ Line 242: / Line 242: @@
 ===SPILL===
   SPILL:{{sa|coord or variable}}, terrain_type, direction, length
-Create random "pool-like" globs of terrain, starting from coordinate, generally moving towards direction, and at maximum length positions.
+Create random "pool-like" globs of terrain, starting from coordinates, generally moving towards direction, and at maximum length positions.
-Coordinate, terrain_type and length can be variables of the appropriate type.
+Coordinates, terrain_type and length can be variables of the appropriate type.
 For example:
@@ Line 289: / Line 289: @@
 *roomtype is either <tt>random</tt>, or one of the {{sa|Room types|special room names}}, eg. <tt>"morgue"</tt>
 *filled is optional, either <tt>filled</tt> or <tt>unfilled</tt>, and tells whether the room should get stocked with random stuff.
-*irregular is optional, either <tt>irregular</tt> or <tt>regular</tt> and tells whether the room is irregularly shaped. If the room is irregular, only the first coordinate of the region must be inside the room, and the room must be closed off from other areas with non-floor {{sa|map characters}}. Use the boundary symbol <tt>'B'</tt> in the {{sa|MAP}} to enclose an irregular room; it will be converted to floor symbol <tt>'.'</tt> after the level has been created.
+*irregular is optional, either <tt>irregular</tt> or <tt>regular</tt> and tells whether the room is irregularly shaped. If the room is irregular, only the first pair of coordinates defining the region must be inside the room, and the room must be closed off from other areas with non-floor {{sa|map characters}}. Use the boundary symbol <tt>'B'</tt> in the {{sa|MAP}} to enclose an irregular room; it will be converted to floor symbol <tt>'.'</tt> after the level has been created.
 *joined is an optional <tt>joined</tt> or <tt>unjoined</tt>, and tells whether any randomly generated corridors connect to the region.
@@ Line 304: / Line 304: @@
 *chance is optional percentage of the room being the special room; otherwise the room is ordinary.
 *lightstate is <tt>lit</tt>, <tt>unlit</tt>, or <tt>random</tt>.
-*pos can be either <tt>random</tt> or an approximate location in the form of <tt>(1,3)</tt> - this is not a coordinate, but an approximate position on the map - the number ranges are 1..5
+*pos can be either <tt>random</tt> or an approximate location in the form of <tt>(1,3)</tt> - this is not an absolute position, but an approximate position on the map - the number ranges are 1..5
 *align is either <tt>random</tt> or an approximate adjustment to the location in the form of <tt>(horiz, vert)</tt>, where
 **horiz is one of <tt>left</tt>, <tt>half-left</tt>, <tt>center</tt>, <tt>half-right</tt>, or <tt>right</tt>.

@@ Line 400: / Line 400: @@
 This must be immediately preceded by a {{sa|GEOMETRY}} definition.
 You define a map-part by "drawing" with [[#Map characters|map characters]] between the MAP and ENDMAP. The map can be up to 21 lines high and each line can be up to 76 chars long. Each line must also be the same length. You can also use numbers inside the map, but those will be ignored; they're considered as line numbers.
 See also {{sa|NOMAP}}.

@@ Line 269: / Line 269: @@
 *3 = all roads lead to rome. or to the first room.
 *any other value (or leaving style off) will generate normal style corridors.
 ===REGION===

@@ Line 943: / Line 943: @@
 ===Trap names===
-"anti magic", "arrow", "bear", "board", "dart", "falling rock", "fire", "hole", "land mine", "level teleport", "magic portal", "magic", "pit", "polymorph", "rolling boulder", "rust", "sleep gas", "spiked pit", "statue", "teleport", "trap door", "web"
+"anti magic", "arrow", "bear", "board", "dart", "falling rock", "fire", "hole", "land mine", "level teleport", "magic portal", "magic", "pit", "polymorph", "rolling boulder", "rust", "sleep gas", "spiked pit", "statue", "teleport", "trap door", "web", "cold"
 ===Room types===

@@ Line 271: / Line 271: @@
 ===REGION===
-  REGION:region_or_variable, lightstate, roomtype [, filling][, irregular]
+  REGION:region_or_variable, lightstate, roomtype [, filled][, irregular][, joined]
-  REGION:region_or_variable, lightstate, roomtype [, filling][, irregular] { {{sa|Level statements}} }
+  REGION:region_or_variable, lightstate, roomtype [, filled][, irregular][, joined] { {{sa|Level statements}} }
 Define a region on the map with certain light-state and type. This allows defining irregularly-shaped rooms. See also {{sa|ROOM}} and {{sa|SUBROOM}}. {{sa|BREAK}} is allowed within the level statements.
 *lightstate is <tt>lit</tt>, <tt>unlit</tt>, or <tt>random</tt>.
 *roomtype is either <tt>random</tt>, or one of the {{sa|Room types|special room names}}, eg. <tt>"morgue"</tt>
-*filling is optional, either <tt>filled</tt> or <tt>unfilled</tt>, and tells whether the room should get stocked with random stuff.
+*filled is optional, either <tt>filled</tt> or <tt>unfilled</tt>, and tells whether the room should get stocked with random stuff.
 *irregular is optional, either <tt>irregular</tt> or <tt>regular</tt> and tells whether the room is irregularly shaped. If the room is irregular, only the first coordinate of the region must be inside the room, and the room must be closed off from other areas with non-floor {{sa|map characters}}. Use the boundary symbol <tt>'B'</tt> in the {{sa|MAP}} to enclose an irregular room; it will be converted to floor symbol <tt>'.'</tt> after the level has been created.
 Example:
@@ Line 284: / Line 285: @@
 ===ROOM===
-  ROOM:roomtype, [ chance, ] lightstate, pos, align, size [, fill] { {{sa|Level statements}} }
+  ROOM:roomtype, [ chance, ] lightstate, pos, align, size [, filled] [, joined] { {{sa|Level statements}} }
 Creates a room, with walls and floor. The room will be placed on a position defined both by pos and align. pos defines the rough position (in a 5-by-5 grid on the screen), and align defines the room position within that. {{sa|BREAK}} is allowed within the level statements.
@@ Line 297: / Line 298: @@
 **vert is one of <tt>top</tt>, <tt>center</tt>, or <tt>bottom</tt>.
 *size is either <tt>random</tt> or an exact width and height in the form of <tt>(3,5)</tt>.
-*fill is an optional boolean, and tells whether the room should get stocked with random stuff.
+*filled is an optional <tt>filled</tt> or <tt>unfilled</tt>. <tt>unfilled</tt> means the room should get stocked with random stuff.
 The contents (and SUBROOMs) of the room can be defined using the level statements.
@@ Line 304: / Line 306: @@
 ===SUBROOM===
-  SUBROOM:"roomtype", [ chance, ] lightstate, position, size [, fill] { {{sa|Level statements}} }
+  SUBROOM:"roomtype", [ chance, ] lightstate, position, size [, filled] [, joined] { {{sa|Level statements}} }
 Creates a room within a {{sa|ROOM}}, with walls and floor. {{sa|BREAK}} is allowed within the level statements block.
@@ Line 312: / Line 314: @@
 *position is either <tt>random</tt>, or an exact position of the room inside the outer room in the form of <tt>(4,3)</tt>.
 *size is either <tt>random</tt> or an exact width and height in the form of <tt>(3,5)</tt>.
-*fill is an optional boolean, and tells whether the room should get stocked with random stuff.
+*filled is an optional <tt>filled</tt> or <tt>unfilled</tt>. <tt>unfilled</tt> means the room should get stocked with random stuff.
 The contents (and SUBROOMs) of the room can be defined using the level statements.

@@ Line 91: / Line 91: @@
   INIT_MAP:mazegrid,'-'
   INIT_MAP:sheollev
   INIT_MAP:mines, '.' , ' ', true, true, random, true
 Initializes the map with different algorithm.
@@ Line 96: / Line 97: @@
 *<tt>mazegrid</tt>: Generates a grid of solid walls and the specified map characters. Use {{sa|MAZEWALK}} to carve a maze into it.
 *<tt>sheollev</tt>: Generates a Sheol level. No parameters.
 *<tt>mines</tt>: Creates [[Gnomish Mines]]-style levels. Takes several parameters: <tt>foreground, background, smoothed, joined, light_state, walled [, filling ]</tt>
 **<tt>foreground</tt>: The "foreground" fill {{sa|map character}}. This should be something the player can walk on, as the walkable part will be made out of this.