Randungeon

a minetest mod that adds highly randomized (incl. materials used for individual parts of each separate level) dungeons into the world, as well as tools to generate these dungeons at chosen locations with chosen or randomized properties.

Please note: This manual/README only documents how you can modify dungeon generation and the parts you can modify & influence, but not how generation of individual dungeon part works or all the dungeon offers in regards to dungeon generation apart from that.

See the "Some Images" section at the end of this manual/README for some screenshots of the actual dungeon generation.

Natural Generation

By default around every tenth 200x200 block area of the world has one dungeon in it, with its heighest level being at y=-50 and its top starcases reaching the ground. These dungeons can range from 10 to 50 levels deep, weighted towards shallower dephs.

Note that dungeon generation can take many seconds and that during this time many normal operations of ones world (e.g. crops growing) will be blocked. You may consider deactivating dungeon generation (or not playing with this mod) if this bothers you.

There are severals new settings added to the "All Settings" page of minetest (under "Mods -> randungeon") for this; these being:

Allow randungeon to generate dungeons naturally in worlds

Enabled/Disabled depending on whether dungeons should generate naturally within the world anywhere. Defaults to true. When disabled, dungeons can only be spawned using the tools available in creative mode.

Worlds for which dungeon generation should be specifically enabled

Comma-separated list of worlds, e.g. "world1,world2,world3" for which dungeon generation should be specifically enabled. Don't append whitespace that isn't actually there in the world name to the world names in this list.

Worlds for which dungeon generation should be specifically disabled

Comma-separated list of worlds, e.g. "world1,world2,world3" for which dungeon generation should be specifically disabled. Don't append whitespace that isn't actually there in the world name to the world names in this list. If a world name is both in both aforementioned lists we'll apply the default setting to it.

Chance for a dungeon to be generated per 200x200 block area in percent

For every 200x200 block wide chunk of the world there is a chance that a dungeon will be generated in it. This chance can be modified with this option. Must be larger than 0 and not more than 100, since it's in percent.

Manual Dungeon Generation

When you're in creative mode (or have creative privileges) you can alsoc reate dungeons manually, regardless of randungeon's settings in minetest's menu.

There are items for this ("Dungeon Spawn Sticks) that you can left-click with to generate a dungeon beneath you, as well as two special inventory tabs ("Make Dungeon" and "Make Dungeon (unrand)") where you can configure (on a per-player basis) what they can do, none of which are only accessible in creative mode.

See https://github.com/phseiff/randungeon#manual-dungeon-generation for documentation on these.

Manual

There's also a manual item (the gray little book) that you can left-click with to open & read this manual/READMe in-game.

Nodes

Randungeon strives to not add any survival-mode-obtainable (and ideally no non-technical creative-mode-obtainable) blocks to the game, since it is decidedly not a block mod.

However, some blocks still got added:

Obtainable blocks:

The five exemplary dungeon part blocks:

There is one special block each for pillar, floor, both wall parts and roof of the dungeon. They are colorcoded, labeled, glow in the dark, and are the default blocks for non-randomized dungeon generation via dungeon sticks. They are only obtainable via creatve mode.

Treasure Blocks:

There are Treasure Blocks found in treasure faults when dungeons are naturally generated; these don't have any special proeprties except for remembering & displaying the location they were found at. If natural dungeon generation is disabled, these blocks cannot be naturally found and aren't present in the creative inventory either.

There are also exemplary Treasure Blocks used as the default value for treasure blocks in manually generated dungeons, which are always present in the creative inventory and don't have any gameplay-enhancing value.

Unobtainable blocks:

Doors:

The dungeon has doors in it, which are unobtainable in that

• they only drop the block they were made from when dug

• they aren't in the creative inventory

• they consist of multiple parts each in contra-intuitive ways so even getting the item via command doesn't make it easily constructable

These doors are different from normal minetest game doors in mor eways than just their looks, in that:

• they are double doors with both sides opening

• they come in all different wood materials that the mod uses

• they have a separate doorframe block above them, which comes in all block types that the mod uses

• doorframe and door are dug separately, and don't drop themselves but rather their material, as mentioned above

Technical blocks:

There are some blocks that mimic blocks already present in minetest game, but display alternative behavior, that are used in some part of the dungeon (not necessarily in all parts that the block they mimic is used in, though) such as

• lava whose source block doesn't ignite anything (in rooms with lava pools)

• water that only flows one block wide (in bubble caves with swamps)

• air that emits light (for dungeons that are lit up)

• bookshelfs with book textures on all four sides and with no book inventory (for when dungeon walls are made from bookshelfs)

• permafrost with snow (for snowy bubble caves; unobtainable due to dropping regular permafrost)

None of these blocks are obtainable without commands; trying to obtain one of them the usual way simply yields the block it is mimiking.

Very Technical Blocks:

There are also some blocks that are placed to mark certain positions during dungeon generation, all of whem get removed at the end of dungeon generation, so you will never get to see them during normal gameplay.

Some Images

Better Gold Blocks

I recommend replacing the default_gold_block.png texture in the default mod with the alternative texture provided by this mod, to make treasure rooms/pools look nicer.

^-- the texture in question