What is here
There are several things in this GitHub package:
- ObHack, a fork of Oblige 2
- Doomsday 1.8.6, whose source code I host in order to maintain GPL compliance
- midi3mus, a package which converts MIDI files in to MUS files. I used this to fix some problems Doomsday 1.8.6 had with FreeDoom’s newer MIDI files; the MIDIs would not always start until I converted them in to MUS files.
- A fork of wad2pdf which is here so I can make PDFs of the files, only showing items which show up when playing single player maps at Ultra Violence difficulty.
- FLTK, GlBSP, and Zlib, which are needed to compile the ObHack GUI (GlBSP is also used by wad2pdf to generate pdf files)
- ObHack itself, which has both the C++ source code and the LUA scripts to randomly make levels
- “tests” which I run to ensure ObHack is correctly making levels and correctly generating pseudo-random numbers
- Win32-binary, which has a special debug version of ObHack
- FreeDoom, which has “ObHack FreeDoom”, my fork of FreeDoom
ObHack: A random map generator for Doom
ObHack is a random map generator for Doom. This was the state of the art
in random Doom map generation back in 2007; these days, newer generators
are available here:
The home page for this generator is here:
I should, of course, mention SLIGE, the very first random map generator
How to get this code
This code is available at https://samiam.org/slump and is also available
as a Git checkout at GitHub,
Why this code is here
The reason for this branch is to make a small, compact random map
generator for Doom which I can put on a tiny 50-megabyte hockey-rink
shaped business card CD. This allows me to have consistent a 32-map
megawad without taking up too much space, and to generate other
maps as desired.
Running this code
On Windows systems, one can run this code by simply entering the
ObHack-engine-697 directory and running the supplied
On other operating systems, read the section “How to
What this is
ObHack is my name for some modifications Fritz and myself have made
to Oblige, a random map generator for the original Doom, Doom 2, and
Heretic. It is name thusly because it is a hacked Oblige, and as a tribute
to the ObHacks posted to the once-great Usenet newsgroup alt.hackers.
ObHack is a fork of version 2 of Oblige (Oblige 0.81-0.97). It has the
following features that Oblige2 does not have:
- Real secret areas that take work to find
- Improved random number generator which allows arbitrary English or
Spanish text to be the seed, resulting in a nearly infinite number of
- New modes: Single Player + Deathmatch, Deathmatch without exits, and
- Progressive level size: Levels get bigger as one gets to higher levels
in the wad
- Tiny and small level sizes
- Option to have swarms of mosters
- Choice of player starting weapon
- More texture packs, including contributions from Mr. Chris
- Deathmatch starts and extra deathmatch-only weapons and ammo in
single player maps
Once the ObHack program is open, a window with various options appears.
This determines how the maps look and are layed out. In theory, a given
random seed generates the same maps. In practice, about 5% of the maps
are non-deterministic and will slightly vary, even when generated with
the same seed. The seed always defaults to
1FreeDoom1, a seed which
does generate 100% deterministic maps; it can be changed by clicking on
“New Seed”, or by typing in a new seed in the “Random seed” box.
The game determines which particular game we make random maps for:
- Doom 2: Doom 2
- FreeDoom: Doom 2 with fewer possible monsters (since some monsters
do not look as good in FreeDoom)
Note that Hexen is not available. It is available in Oblige 0.97.
Note that Doom 1 and Heretic are not available. They are available in
the ObHack-8-Final version of this code.
This pull down does not have any options.
- Single Level: One level
- One Episode: A smaller megawad of nine or so levels
- Full Game: A full megawad with well over two dozen levels
- Single Player: While this mode is optimized for making single player
maps, it is possible to play Deathmatch with these maps; Deathmatch
starts are made, and more weapons and ammo are available when these
maps are played in Deathmatch mode.
- Co-op: Use this mode for playing Co-op networked games; none of the
other modes make suitable co-cp maps.
- Deathmatch: This makes special deathmatch maps which do not have
monsters, have a lot of weapons, and have more connectivity between
rooms than single player maps.
- SP + DM: This is a compromise between making a single player map and
making a deathmatch map. All locked doors can be opened by keys; the
only “treasures” to be found on the map are weapons, and the maps tend
to have more powerful weapons than pure single player maps. There are
multiple deathmatch starts, and the starts are clearly marked on the
map. On the other hand, the maps still have the hub-and-spoke
“puzzle” layout of single player maps.
- Carnage: These maps have the same architecture as the single player
maps generated with the same seed, but the maps have more monsters, more
weapons, more ammo, but less health than the corresponding Single Player
maps. It makes for a more intense game but one with less strategy than
a standard Single Player game.
- DM (No Exit): This generates pure deathmatch maps which have no exit.
This is for ports of Doom where the deathmatch level is updated after
a given number of frags or a time limit is reached.
Note that the Capture the Flag mode is no longer available. For people
who want CTF support, use the ObHack-8-Final version of ObHack.
- Level size: How big the levels are. “Progressive” means that initial
levels are small, but they get bigger as the player progresses through
- Steepness: How much difference in altitude there is in the map.
- Monsters (“Players” in Deathmatch mode): How many monsters are on the map.
When playing a single player (or Carnage) map in Deathmatch mode, this
also determines how many weapons and how much extra ammo the map has.
- Puzzles: How often the player will need to find a key or switch in order
to open a door when playing a map. This determines how many weapons
there are in pure deathmatch mode.
- Outdoors: How often the map is outdoors. “More” means that the player
will usually start off a level outdoors.
- Switches: If set to “keys only”, there will be no puzzles where the player
needs to find a switch before opening a door. If set to “switches only”,
there will be no keys on the map, only switches to open door. Otherwise,
the map will have both types of puzzles. Note that this has little effect
on “Single Player and Deathmatch” levels, and no effect on “Deathmatch”
- Health: How much health the map has. “None” is an option geared for
playing maps in Deathmatch mode, when it is not desirable to allow the
player to heal after being damaged.
- Ammo: How much ammo we let weapons have on maps.
- Start weapon: We can allow the player to start off with a better weapon
than a pistol. Basic is a shotgun in Doom games, and a crossbow in
Heretic. Hardcore is a rocket launcher in Doom games, and a Phoenix Rod
The other buttons.
“Build” will build the map. “About” describes the game. “Quit” causes the
ObHack level generator window to close.
The ObHack 8 branch
From 2009 until 2017, a lot of work was done on ObHack, including
monster traps, variable room sizes, boss arenas, Blasphemer support,
basic Capture the Flag support, etc.
The ObHack 8 code is still here, in the Git tag
To get this code, go to this URL:
Or, if using Git, type in
git checkout ObHack-8-final
Determinism: About 95% there
ObHack, has, until recently, had issues with making completely different
maps when given the same parameters. I have updated the code to remove
about 95% of the problems.
If I run the ObHack program with the same seed and parameters, I will
sometimes get a given .wad file; multiple invocations will sometimes
give me a file with the same size and exact same contents.
The code which makes the binary
.wad file from a given generated map
is non-deterministic; I have verified this by having the code instead
.txt files (some old debug code which Andrew put there) and
verify that all of the files are the same with a given seed.
In about 5% of the generated maps, some non-deterministic code is run.
It is too deep of a “rabbit hole” for me to figure out exactly why this
happens, so I have instead set it up so that, for
MAP06, we change
the numbers generated by the random number generator (by adding 1234
“empty” runs of the generator) so that the 32-map megawads generated
for Doom2 (actually, FreeDoom) maps are the same if the seed is either
2FreeDoom1 and the default ObHack parameters are
How to compile
These are the files needed to make the Win32 binary of ObHack. To compile,
you will need to install both MinGW-3.1.0-1 and MSYS-1.0.10. Once you do
that, do something like this:
# You may have to edit the makefile
# You may have to edit the Makefile
MinGW and MSYS install directions are here:
Note that that version of MinGW does not run in Windows 10.