From DoomWiki.org

UDMF (an abbreviation for Universal Doom Map Format) is a specification for laying out maps in a textual way. It is essentially a new map format for Doom engine based games. The format is not backwards-compatible with older Doom engine games.

The idea for this format was first suggested by James Haley (Quasar) as a universal solution to add unlimited extra information to map elements, so that the wide range of new features in Doom source ports can be better supported by editors and implemented in the map information more easily. UDMF was further developed by Haley, Christoph Oelckers (Graf Zahl) and Pascal vd Heiden (CodeImp), with suggestions from a few others. The name for the map format was coined by Russell Rice.

UDMF version 1.0 was finalized on May 29th, 2008. Support for it is currently implemented in DelphiDoom, Eternity, GZDoom, EDGE, Vavoom, ZDoom, Skulltag, Zandronum, DSDA-Doom, Sonic Robo Blast 2, ZDBSP, Ultimate Doom Builder and SLADE 3. It is also expected to be supported in Doomsday[1].


To prevent conflicts, the UDMF specifications require maps to start with a declaration of the namespace used, which then defines which map editing features are available and used. "Map editing features" is used here to describe only features that are directly used when making a map: the correspondence between editor numbers and thing types (such as 3001 for the imp), the one between linedef types and their expected effects, and the list of flags and properties that can be set on things, sides, lines, sectors, and vertices. Four namespaces are reserved by the specifications, and they should not be enhanced or extended with additional map editing features.

  • Doom: all map editing features of vanilla Doom, Boom, and MBF.
  • Heretic: all map editing features of vanilla Heretic
  • Hexen: all map editing features of vanilla Hexen
  • Strife: all map editing features of vanilla Strife

Source ports wanting to add new map editing features should define their own namespace.

Eternity Engine namespaces[edit]

  • Eternity: Shared by all games supported by Eternity, and allows full use of all map editing features available. Mostly compatible with ZDoom mapping features which are also supported by Eternity.

ZDoom namespaces[edit]

  • ZDoom: This namespace is shared by all games supported by ZDoom, and allows full use of all map editing features available.
  • ZDoomTranslated: This namespace will be processed by a map translator which will convert line types and sector types as if they were in the binary map format shared by Doom, Heretic, and Strife. It is otherwise identical to the main ZDoom namespace.

DSDA-Doom namespaces[edit]

  • dsda: This namespace was based on the ZDoom one, however, it comes with several additional sidedef and sector effects, including those for scrolling walls, floors and ceilings.

External links[edit]

Doomworld threads[edit]


  1. "1.9.7's BSP Builder already supports the UDMF vertex spec and post 1.9.8 I intend to implement a UDMF map converter plugin."