OBLIGE(6)

NAME
oblige - random level generator for Doom and Doom II

SYNOPSIS

oblige [-options] [key=value ...]

DESCRIPTION

oblige creates a patch WAD file for use with Doom or Doom II, containing one or more randomly-generated levels. The generated WAD files are ready to play (no separate node-building pass is needed).

Normally, oblige is controlled by its GUI, but it can be used noninteractively (see the -b option below).

OPTIONS

--home <dir>
    Home directory, where oblige looks for its config file, and creates temporary files. Default is ~/.oblige.

--install <dir>
    Installation directory, where oblige looks for lua scripts and other data. Default is /usr/share/oblige.

--config <file>
    Config file to use. Default is ~/.oblige/CONFIG.txt in GUI mode, none in --batch mode.

--batch, -b <output>
    Batch mode (no GUI). Uses built-in default config (never reads the normal config file used by the GUI), but the --load option can be used to override the defaults. output will be a PWAD file and will be overwritten without prompting if it exists.

--load, -l <file>
    Load settings from a file. This is in the same format as ~/.oblige/CONFIG.txt, and any settings in the loaded file will override the ones there. In --batch mode, "--load ~/.oblige/CONFIG.txt" will generate levels according to the settings configured by the GUI.

--keep, -k
    Keep random seed from loaded settings. Normally the seed stored in the config file is ignored, and a new seed is generated.

--debug, -d
    Enable verbose debugging messages in log.

--terminal, -t
    Print log messages to stdout (rather than ~/.oblige/LOGS.txt). Disabled by default, unless in --batch mode.

--help, -h
    Show built-in help message.

key=value
    Override setting from CONFIG.txt. May be given multiple times.

COPYRIGHT

See the file /usr/doc/oblige-7.70/GPL.txt for license information.

AUTHORS

oblige is (c) 2006-2017 by Andrew Apted.

This man page written for the SlackBuilds.org project by B. Watson, and is licensed under the WTFPL.

SEE ALSO

oblige-legacy4(6), an older version of oblige with a simpler level-generation algorithm and support for other games including Heretic, Hexen, and Quake.

The oblige home page: http://oblige.sourceforge.net