adds highly randomized vivid dungeons to the world, and tools to spawn/customize them.

Building Mapgen / Biomes / Decoration

For Minetest 5.0 and above

How do I install this?


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.


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


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:


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



Do you recommend this mod?

  • The dungeons and endless corridors...

    This mod reminds me of a game I played in 2016 -- Spooky's House of Jump Scares. I always dreamed of having such structures in minetest. The built-in dungeons are, of course, creepy, but not enough, and they often lack in size. Now, me and my friends (and others' friends also) can finally play hide and seek in a programmatically generated deep, dark dungeon. With their deep, dark fantasies. The only insignificant issue I have detected: upon generating a new world (or entering, I don't know yet), log messages are printed in the chat.

    Officially one of my favorite mods.

  • I'm back

    hello again, I haven't found any dungeon yet of your mod, because I haven't really explored much, I've been just testing and making my selection of mods to play. For now I just have two errors to report: 1- When you start a game the game shows messages like: image, image, image, code, image. I realized that it was this mod because I deactivated it and those messages were gone. 2- It's not compatible with the "Nether" mod by Hybrid Dog. Somehow when you enter to the nether with Randungeon activated the game crashes, and the error says something like:

    AsyncErr: Lua: Runtime error from mod 'nether' in callback environment_OnGenerated(): /home/kerrs/.minetest/mods/nether/nether/init.lua:441: attempt to index a nil value stack traceback: /home/kerrs/.minetest/mods/nether/nether/init.lua:441: in function </home/kerrs/.minetest/mods/nether/nether/init.lua:341> /app/share/minetest/builtin/game/register.lua:431: in function </app/share/minetest/builtin/game/register.lua:417>

    The error message varies sometimes. Again, I know it's this mod the one of the problem because deactivating it everything works properly.
  • Takes a while to generate, but the dungeons are pretty.

    The dungeons are large and make for a fun pastime when you want to go exploring. They may generate any number of trees and resources, mostly spheres of lava and trees/plants. I can see people repurposing dungeons as bases once they've sorted out their loot.

    A small downside is that the dungeons seem to take about 1-3 minutes to generate. While this is going on, the mod stops the rest of the game's processes like chunk loading. The first few times I tried this mod, I believed it to be broken when I encountered chunks not loading or failing to find any dungeons. When in reality, they just take a long while to generate. I would like to see some workaround where segments are generated a few steps at a time, to allow you to play and not have to wait around for any given dungeon to load all at once.