AcsDungeonGenerator

Introduction
AcsDungeonGenerator is a Windows GUI front end for Blockhead's family of Dungeon Generators. It provides a user-friendly interface for his console operated programs. It is not by any means a replacement, it is an add-on. It is strongly adviced to read the corresponding readme's for a better understanding of Blokhead's programs.

Installation
Copy all the files in this archive into the same directory where you put Blockhead's Dungeon Generators.
When you execute AcsDungeonGenerator, the main window appears:

Quit/Exit program, CTRL+Q
Generate dungeon, ENTER
Abort operation, ESC
Configure supported Programs, CRTL+S
Edit selected Inifile, CRTL+I
CTRL+D, Sets focus to Dungeon style selection
CTRL+T toggles Treasure generation on/off
CTRL+M toggles Monster generation on/off
CTRL+C toggles Clutter generation on/off
CTRL+Y toggles no twistY dungeon on/off
CTRL+B Sets focus to Base cell name
= Select ESP File name, CTRL+F
CTRL+H Sets focus to Horizontal cells #
CTRL+V Sets focus to Vertical levels #
CTRL+S Sets focus to Start level at #
CRTL+SHIFT+D toggles Delete temporary files on/off
CTRL+SHIFT+1 do not show batch processes
CTRL+SHIFT+2 show processes on taskbar
CTRL+SHIFT+3 show batch processes
Dungeon style
Every style corresponds to one of the Dungeon Generators written by Blockhead. So far he created five of them, acsDungeonCreator supports up to eight Dungeon Creators. Configuration can be done by pressing (= Configure supported dungeon styles) or CTRL+P. This opens the configuration window:
= Close and save changes, CTRL+ENTER
= Close without saving, ESC
Edit selected inifile
Each of Blockhead's dungeon generating programs comes with an infile containing configuration settings. Check the relevant readme for more details. Though you can edit the inifiles with any text editor, AcsDungeonGenerator offers an elementary editor for ease of use. Pressing (= Edit selected infiles) or CTRL+I opens the infile in the editor:
= Close and save changes, CTRL+ENTER
= Close without saving, ESC
Switches
The checkboxes correspond with the switches the Dungeon Generators uses.

Turn off treasure generation.
When this is set, there will be no crates, bags, small chests, etc. in the dungeon. Any clutter that is placed on top of crates (like those squat candles) will not be created either.

Turn off monster generation.
When this is set, no monsters are placed in the dungeon.

Turn off clutter generation.
This turns off anything that is not monster or treasure. When this is set, there will be no lights in the dungeon (aside from lights on crates, if treasure is left on).

Using all three options at the same time will generate a dungeon that is a bare stone maze, ready for whatever manual decoration you wish to do!

No twisty dungeon.
This option will force nub removal to always be 2 passes. This results in almost all of the dead end corridors being removed. This makes the dungeon less twisty but will help your in-game frame rate a little bit. Without the option, the program randomly determines the twistyness for each cell.

Base cell name
Base cell name is the cell name that you want the interior cells to have in the game. This base name, plus the cell coordinates, will form a unique name for each cell. This can have spaces in it, as long as you put quotes around it. If you do not uses spaces, quotes are not necessary.

Output file name
This name is the name that you want to use for the esp file. It must not have spaces in it.

Horizontal cells #
This controls the number of cells generated. Setting this to 1 will generate one cell. Setting this to 2 will generate a dungeon three cells by three cells, for a total of nine cells. Take the size number, double it, subtract 1, and then square it to get the total cell count of the output dungeon.

Vertical levels #
This option allows the dungeon to extend vertically down, similar to the way GenMod works. Any number from 1 to 99999999 is allowed, although it is not recommended to try 99999999.

Note: the cell with coordinates (0, 0) will always have inter-level connections. Other cells only have a 1 in three chance of having an up connection and and 1 in 3 change of having a down connection.

Start level #
Start level allows the number of the first level to be set. So if you want your dungeon to have levels 100 to 200, you'd choose 100 to start with.

Delete temporary files when done
Checking this option will delete files which are created during the process but are of no further use afterwards.

Show batch processes
AcsDungeonGenerator executes the programs provided by Blockhead in the same way you would do by entering a command in a console window ("DOS box"). You can choose whether those programs will be excecuted unseen, make these programs appear as an icon on the taskbar, or show the console window wherein the programs are executed.


Download AcsDungeonGenerator