From DoomWiki.org

This article is about the map generator. For other uses, see Obsidian.
Obsidian title gfx big.png
Codebase OBLIGE
Initial release 1 (2021-03-04, 2 years ago)
Latest release 21 (2023-08-07, 6 months ago)
Development status Active
Written in Lua, C++, C
Target Platform Cross-platform
License GPL-2.0
Website https://obsidian-level-maker.github.io/
Source Repository



OBSIDIAN is a procedural map generator developed as a community effort.[1] It is a fork of the final version of OBLIGE that has two prominent differences: a new GUI for changing the tool's many settings and full incorporation of the former ObAddon project, which provided a large addition of visual assets and Lua code.

First released in March 2021, OBSIDIAN currently has two versions: a stable release and a rolling unstable preview of the next release. The project builds successfully on Linux, BSD, Mac, Haiku and Windows platforms; pre-compiled Windows releases are provided on the project's homepage.


Notable improvements over the final OBLIGE release include:

  • Additional games supported: Wolfenstein 3D/Spear of Destiny, Super 3D Noah's Ark, Chex Quest 3, HacX 1.2, Harmony, Hexen and Strife
  • Direct integration of previous versions of Oblige for further variety in map generation
  • Customizable GUI with more granularity for important settings like map size and monster density
  • More prefabs[2] and shape grammars[3]
  • Improved internationalization support; in particular updated localization template file and support for the Russian language
  • Vanilla Doom support, via the bundled SLUMP generator[4]
  • Unified 64-bit random number generation for both OBSIDIAN and SLUMP using fastPRNG[5]
  • Ability to use arbitrary-length strings as RNG seeds
  • UDMF output, with the ability to convert existing binary-formatted prefabs at runtime
  • ZDBSP as the internal node builder, providing compressed, extended, and UDMF-compatible nodes for engines that support them
  • Optional PK3/ZIP output
  • Ability to save an animated GIF of the map-building process
  • "Surprise Me" total randomization of settings
  • Compile-time option to create CLI-only builds, for systems without a graphical environment or that do not support Obsidian's FLTK GUI toolkit

External links[edit]


  1. List of contributors
  2. Prefabs info
  3. Shape Grammar info
  4. Vanilla support info
  5. fastPRNG info