Skip to main content
Version: 3.4

Procedural Dungeon Plugin

Overview​

This is an Unreal Engine plugin that let you create dungeons procedurally like "The Binding of Isaac" or "Rogue Legacy" but in 3D.
With this plugin you create rooms by hand and you define your generation rules with blueprint.
The plugin then generate a dungeon that can be random or deterministic following what rules you've programmed.

Example​

Some hand-made rooms defined with bounds and doors:

RoomSpawn RoomA RoomB RoomC RoomD RoomExit

Some very simple generation rules:

  • A special room (red) used to spawn the player.
  • Then 10 rooms chosen randomly in a list (blue, green, yellow, cyan).
  • Then a special room (purple) used as an end goal for the player.
  • Finally 10 other rooms chosen randomly.

Possible results:

Result1 Result2

What you need to do​

First, read the Installation page to install the plugin.
Then, read and follow the instructions in the Getting Started page. This will give you a minimal working dungeon.
You can then read the Advanced Features section to know what the plugin has to offer on top of the basics.

An example project is available if you want to try a minimal working project.

You can also join the Discord server dedicated to this plugin if you want to ask question or get help from the community.

Tips​

The generation take a certain time (the generation itself is done on one frame, but the instantiation and loading of each room take some times proportionally to the number and complexity of the rooms).
So, if you have the player character spawned at start, it will fall into the void of the universe before the dungeon has the time to generate.

To manage this situation, you have multiple solutions:

  • The easy and ugly way is to place a little plane somewhere with the player start on it, and disable the inputs from the player to prevent him to fall from this plane, then when the generation is complete you teleport the player into the first room and unlock the inputs;
  • The better and cleaner way is to spawn the player as spectator until the generation is finished, and then you spawn the character actor in the first room (or anywhere else if you want to) and make it possessed by the player controller. (I've added a Spectate blueprint node to ease this solution)

Both solutions use the Post Generation Event to know when the generation is done. You will also want to show or keep a loading screen when you start your game map, and you hide it on this event too.