Command Line Reference

Interactive Subcommand

--skip-relight

Skip relighting the level. This will generate dungeons faster, but at the cost of lighting not being correct.

-t FLOOR, --term FLOOR

Print a text version of a given floor to the terminal screen. On ANSI systems this will be in color.

--html HTMLPATH

Output html maps of the dungeon levels to the specified path. You can include the optional __DUNGEON__ keyword and it will be replaced with the dungeon name. Handy for maps with multiple dungeons.

--debug

Provide additional debug info.

--force

Force overwriting of html output files.

-s SEED, --seed SEED

Provide a seed for this dungeon that can be used to recreate the same dungeons later. This can be any string.

-o X Y Z, --offset X Y Z

Provide a location offset in blocks for the NW corner of the dungeon. If set, the dungeon will not be buried, but will be rendered at the coordinates you specify.

--force-bury

Attempt to calculate Y when using –offset.

-e X Z, --entrance X Z

Provide an offset for the entrance in chunks. This is the position of the entrance chunk from the NW corner of the dungeon.

--spawn X Z

Override spawn point. Normally all distances are measured from the spawn point origin. Use this to specify a different origin in your world.

--dir SAVEDIR

Override the default map directory.

Platform Default map directory
Windows %AppData%\.minecraftsaves
OS X ~/Library/Application Support/minecraft/saves
Linux ~/.minecraft/saves
--mapstore PATH

Mapstore will provide an alternate world in which to store your dungeon maps. If you’re playing vanilla, don’t worry about this. If you’re using Bukkit with multiple worlds (like multiverse) set this to the name of your primary world. This can also be set on the command line, or in interactive mode.

Add Subcommand

-c CFGFILE, --config CFGFILE

Specify a configuration file. Defaults to default.cfg

--write

Write the dungeon to disk. Leaving this option out will do a “dry run” on your world but not save any changes.

--skip-relight

Skip relighting the level. This will generate dungeons faster, but at the cost of lighting not being correct.

-t FLOOR, --term FLOOR

Print a text version of a given floor to the terminal screen. On ANSI systems this will be in color.

--html BASENAME

Output html maps of the dungeon levels. This produces one file per level of the form BASENAME-(level number).html

--debug

Provide additional debug info.

--force

Force overwriting of html output files.

-s SEED, --seed SEED

Provide a seed for this dungeon that can be used to recreate the same dungeons later. This can be any string.

-o X Y Z, --offset X Y Z

Provide a location offset in blocks for the NW corner of the dungeon. If set, the dungeon will not be buried, but will be rendered at the coordinates you specify.

--force-bury

Attempt to calculate Y when using –offset.

-e X Z, --entrance X Z

Provide an offset for the entrance in chunks. This is the position of the entrance chunk from the NW corner of the dungeon.

--spawn X Z

Override spawn point. Normally all distances are measured from the spawn point origin. Use this to specify a different origin in your world.

-n NUM, --number NUM

Number of dungeons to generate. -1 will create as many as possible given X, Z, and LEVEL settings.

--mapstore PATH

AddTH Subcommand

New in version 0.14.0.

-c CFGFILE, --config CFGFILE

Specify a configuration file. Defaults to default.cfg

--write

Write the treasure hunts to disk. Leaving this option out will do a “dry run” on your world but not save any changes.

--skip-relight

Skip relighting the level. This will generate hunts faster, but at the cost of lighting not being correct.

--debug

Provide additional debug info.

-s SEED, --seed SEED

Provide a seed for this treasure hunt that can be used to recreate the same hunts later. This can be any string.

-o X Y Z, --offset X Y Z

Provide a location offset in blocks for the start of a hunt.

--spawn X Z

Override spawn point. Normally all distances are measured from the spawn point origin. Use this to specify a different origin in your world.

-n NUM, --number NUM

Number of treasure hunts to generate. -1 will create as many as possible given X, Z, and STEPS settings.

--mapstore PATH

Regenerate Subcommand

-d X Z, --dungeon X Z

The X Z coordinates of a dungeon to regenerate.

Note

These will be rounded to the nearest chunk. Multiple -d flags can be specified.

-a, --all

Regenerate all known dungeons. Overrides -d.

-c CFGFILE, --config CFGFILE

Specify a configuration file. Defaults to default.cfg

--skip-relight

Skip relighting the level. This will generate dungeons faster, but at the cost of lighting not being correct.

-t FLOOR, --term FLOOR

Print a text version of a given floor to the terminal screen. On ANSI systems this will be in color.

--html BASENAME

Output html maps of the dungeon levels. This produces one file per level of the form BASENAME-(level number).html

--debug

Provide additional debug info.

--force

Force overwriting of html output files.

--mapstore PATH

mapstore will provide an alternate world in which to store your dungeon maps. If you’re playing vanilla, don’t worry about this. If you’re using Bukkit with multiple worlds (like multiverse) set this to the name of your primary world. This can also be set in config files.

Delete Subcommand

-d X Z, --dungeon X Z

The X Z coordinates of a dungeon to delete.

Note

These will be rounded to the nearest chunk. Multiple -d flags can be specified.

-a, --all

Delete all known dungeons. Overrides -d.

--mapstore PATH

mapstore will provide an alternate world in which to store your dungeon maps. If you’re playing vanilla, don’t worry about this. If you’re using Bukkit with multiple worlds (like multiverse) set this to the name of your primary world. This can also be set in config files.

GenPOI Subcommand

New in version 0.14.0.

--outputdir

Provide the location for the OverViewer generated map.