OBLIGE Level Maker

Advanced random map generator for classic FPS games

QUICK START

First, unpack the zip somewhere (e.g. My Documents). Make sure it is extracted with folders, and also make sure the OBLIGE.EXE file is extracted too (at least one person had the problem that Microsoft Windows would skip the EXE, and he had to change something in the control panels to get it extracted properly).

Double click on the OBLIGE icon (shown right) to run it. Select the target game in the top left panel, and any other options which take your fancy. Then click the BUILD button in the bottom left panel, and enter an output filename, for example "TEST" (without the quotes).

OBLIGE will then build all the maps, showing a blueprint of each one as it goes, and if everything goes smoothly the output file (e.g. "TEST.WAD") will be created at the end. Then you can play it using the normal method for playing mods with that game (e.g. for DOOM source ports: dragging -n- dropping the WAD file onto the source port's EXE is usually enough).

(Some games, especially Quake, may need special setup before running Oblige. See the information on each game for details)

WINDOW LAYOUT

The following diagram shows the GUI for OBLIGE. You can see that the window is divided into five distinct panels. The panels are discussed in separate sections below. Also notice there is no menu bar. To exit you can either click the window's standard close button, or click the "Quit" button in the Build Panel, or just press the ESCAPE key.
PICTURE

GAME SETTINGS

The top left corner panel contains the most important settings.

The first entry is the "SEED" number. Each SEED number produces a unique, distinctive level. Using the same SEED number always produces the exact same level (as long as every other setting is the same).

Other settings include:

LEVEL ARCHITECTURE

The Level Architecture panel lets you control general features of the maps, like what size they should be, what theme to use, how much outdoor areas to make, and so forth.

Choosing "Mix It Up" as a setting means that different levels will get different values (randomly). For example, it makes the Size of maps vary between small and large. However when using it for the Theme and making a full game, each episode will stick to a single theme.

(Note that the 'Lighting' and 'Detail' buttons don't do anything yet)

PLAYING STYLE

This panel is all about the gameplay. Here you can control the amount and strength of the monsters, how much health and ammunition should be added, etc...

The 'Strength' button determines the overall toughness of the monsters. The "Medium" setting is designed to give a mix of monsters similar to the levels in the original game. Compared to that, the "Weak" setting produces weaker monsters and the "Tough" setting gives tougher ones. In all three cases the toughness increases over the course of each episode.

The "Crazy" setting works a bit differently. It forgets all about trying to make battles which are fair (or somewhat fair), and throws any or all of the monsters at you, including bosses! Be warned though, playing maps on this setting can actually drive you insane (hence the name).

(Note that the 'Traps' and 'Powerups' buttons don't do anything yet)

MODULES PANEL

Modules are a great new feature in Oblige V3. The idea is that new functionality can be implemented as a module file (Lua code), and simply dropped into the 'mods' folder, and OBLIGE will load it automatically and allow that module to be enabled or disabled. Modules can even have their own option buttons.

First thing you need to know is: modules are usually specific to a single game, and will only show up in the module panel when that game is selected. Similarly they can depend on a certain engine (source port), and might even depend on other modules. E.g. a module which requires ZDoom will not be visible until ZDoom is chosen in the Game Settings panel. Changing the current game or the current engine (etc) can cause some modules to appear and/or other modules to disappear.

Modules are enabled or disabled by the check-box which appears to the left of the module's name. Modules must be both enabled and shown in order to have any effect, otherwise they do nothing. When a module has options, those options are not shown while the module is disabled (though the option settings are never forgotten).

BUILD PANEL

Once you've chosen the desired settings, press the "Build" button. This will open a Save-File dialog asking you what the output file should be. Enter something appropriate, e.g. TEST, and after that OBLIGE will starting building the levels.

The levels created by OBLIGE are ready to play. There is no need to run the output WAD file through a node-builder program, since OBLIGE does this automatically.

Note: currently the 'Options' button does nothing at all. In the future it will let you set various options which don't fit anywhere else.

MISC NOTES

OBLIGE requires the full version of each game it supports. It will NOT work properly with shareware or demo versions, and never will.

Most games let you play at different skill levels (e.g. Hurt-Me-Plenty vs Ultra-Violence), and OBLIGE takes them into account. Easier skill levels will have less monsters than harder skill levels, and health/ammo are also affected.

You should use a Source Port to play the levels, because the original DOOM.EXE, DOOM2.EXE (etc..) may not cope with the architecture which OBLIGE creates. For example, you might get the "Visplane Overflow" error which quits the game. DOOM.EXE also crashes when saving a level which has too many things in it.

In Wolfenstein-3D mode, the "Build" button does not bring up a dialog box. OBLIGE simply creates the output files in the same folder where it is installed. These files are called GAMEMAPS.WL6 and MAPHEAD.WL6 and you need to copy them into your Wolf3d folder (please make a backup first!).


SourceForge.net
© 2009 Andrew Apted