Map

Game levels in Weissblatt are commonly called Maps while the act of creating a map is called Mapping. Like with many multiplayer PC games, this terminology is inherited from Doom.

Weissblatt supports two different map formats:

1. Legacy maps (sometimes called binary maps) - This format is inherited from Sonic Robo Blast 2 and is generally advised against when mapping.
2. UDMF maps, upon which Weissblatt is built.

Map format Basics

To fully understand mapping, you should understand the concepts of how (modern) Doom engines construct their maps in the abstract:

Sectors, Walls and Linedefs

In short, Doom maps are essentially two-dimensional top-down vertex structures with added properties for height and other gameplay mechanics.

Walls are lines between two or more vertices on a map. Each wall can either be solid with a single texture assigned to it or it can be a two-sided Linedef seperating two sectors. Depending on the two sectors' floor and ceiling heights, each Linedef may be assigned a top, middle or bottom texture per-side. Linedefs can also be equipped a Type which can trigger various effects at runtime.

Walls can also have multiple flags, which can have effects on movement and rendering such as Peg Midtexture or Impassable.

Sectors are polygons made up of multiple walls through which the player can move. Sectors can be assigned

• Top and Bottom Flat
• Floor and ceiling height
• Light level
• Colored lighting (depending on the map format)
• One or multiple Tags
• Various unique effects, such as damage upon touch

Tagging

Walls, sectors, and Things within a map can be tagged using an integer number. Depending on the sector effect and Linedef type, Sectors and Linedefs with matching tags may trigger one another, given trigger-dependent conditions, such as one or all players entering a sector or (not) having collected all Chakra Shards when doing so. Matching tags can also be used for triggers relating to Things.

Binary Space partitioning

Simply put, Doom maps are heavily preprocessed using a so-called node builder before being included in the game. A modern node builder with UDMF support is ZDBSP from the ZDoom source port.

Node builders implement an algorithm called Binary Space Partitioning or BSP. Through BSP, all map sectors are subdivided into convex shapes and assembled into a binary tree. The game engine can then per-frame traverse the leaves of any given branch of that tree to determine all potentially visible walls.

<more TBA>

Floor-over-Floor (FOF)

Floor-over-Floor sectors or FOFs are an extension upon the original Doom format which allows for multi-floor sectors like hovering bridges. To achieve this, a separate control sector is created outside of the play area to which other host sectors are tagged. Triggered through an FOF Linedef Type, the engine then uniformly applies a subdivision in between the host sector's space based on the control sector's assigned textures and flats.

Polyobjects

Polyobjects are an extension to use pieces of predefined map geometry as if they were map objects. This allows for many more gameplay mechanics such as spinning geometry, sideways crushers or swinging doors.

Things and MOBJs

Full page: Category:MOBJ

Things are static spawners for game objects placed within sectors. Upon map load, things are initialized and spawn their respective MOBJs. Things can also be given parameters and flags, which may modify the Thing's behavior. Since Things are only initialized upon map load, this requires some gameplay design considerations when placing enemies such as monster closets.

MOBJs are only spawned at runtime and represent game objects, such as enemies, gems or decorative sprites. MOBJs contain their own Object flags, which are distinct from Thing flags.

UDMF Mapping

UDMF stands for Universal Doom Map Format. It is a textual map format developed for near-infinite extensibility within modern Doom engine source ports. It is not backwards compatible to older formats.

A UDMF map consists of the following lumps within a WAD or PK3, :

• MAPxx - A simple marker lump denoting the map number. Required.
• TEXTMAP contains information on the map geometry (vertices, linedefs, sectors), SIDEDEFs and Things. Despite UDMF being a text format, it is not intended to be read or edited manually. Instead it should be parsed by dedicated programs such as Ultimate Zone Builder, SLADE or Weissblatt's game engine.
• ZNODES - BSP information generated by ZDBSP (as it's the only node builder with UDMF support). If missing, many Doom engines expect it to be generated on-the-fly by a ZDBSP instance built into the engine.

• ENDMAP - a simple marker lump. Required

TEXTMAP specification

Weissblatt supports UDMF TEXTMAPs of namespace weissblatt and srb2.

Legacy Mapping

The Legacy map format was inherited from Sonic Robo Blast 2 and is now considered deprecated. Weissblatt does not develop it any further and merely maintains it for backwards compatibility. As such the format will be missing many features compared to Weissblatt's UDMF implementation.

Like traditional Doom maps, legacy maps are a binary map format, meaning all data is encoded directly into byte structures. This brings some limitations:

1. Each Sector/Linedef/Thing can only be assigned one tag
2. Texture/Flat/Thing scaling is not supported
3. Flat alignment/rotation is not supported
4. Only 65536 tags are allowed.
5. The total amount of possible walls, Linedefs, Sectors, etc. within a map may be limited.
6. <TBA>

Binary maps are made up of the following lumps:

1. THINGS
2. VERTEXES
3. LINEDEFS
4. SIDEDEFS
5. SECTORS

Reserved specialty tags

The Legacy map format does not support multitagging and is generally less flexible when it comes to tagging Things. To get around this, some Tag numbers are given special treatment:

Tag	SOC/Lua Constant	Effect
649	LE_AXE	Triggered when
650	LE_KOOPA	Triggered when <++> is defeated. Raises matching sectors' ceiling to the highest adjacent ceiling
680	LE_CAPSULE0	Triggered when a boss is defeated.
681	LE_CAPSULE1
682	LE_CAPSULE2
4200	LE_BRAKPLATFORM	Triggered after six hits to the alternate form of KOTU.
32000	LE_TURRET	Triggered when a turret is destroyed.
65530 (-6)	LE_BRAKVILEATACK	Triggered when KOTU starts casting magic.
65531 (-5)	LE_BOSS4DROP	Triggered when <++> drops <++>
65532 (-4)	LE_BOSSDEAD	Triggered when any Boss is defeated
65533 (-3)	LE_ALLBOSSDEAD	Triggered when all Bosses are defeated
65534 (-2)	LE_PINCHPHASE	Triggered when Bosses switch into their pinch phase
65535 (-1)		Affect every sector in a map
	LE_PARAMWIDTH

Conversion to UDMF

Legacy maps can be converted to UDMF maps: Simply launch the game using -textmap and -warp <MAPNUM>. After you quit the game, the engine will save a UDMF conversion of your map to the file TEXTMAP within your game directory. You can use SLADE or Ultimate Zone Builder to recompile the newly-generated TEXTMAP into a proper UDMF map.