Procedural Dungeon Architect

1. DungeonGenerator Setup

Add DungeonGenerator to an empty GameObject in your scene.

Main parameters:

• Min Rooms / Max Rooms
  Target range for total room count.
• Max Generation Time
  Safety limit (in seconds) to prevent infinite loops.
  The generator will abort and log a warning if exceeded.
• Max Candidate Tries Per Door
  Limits how many attempts are made per door before it is closed.
• Max Rescan Passes
  Secondary passes to try reaching the target room count.
• Room prefab List
  List of the rooms that will be procedurally placed.

2. Room Prefabs

Each room prefab must:

• Contain at least one Closded Door child object with the name tag “Door”.
• Optionally contain ObjectSpawner child objects with the name tag “ObjectSpawner”.
• Have a RoomConfig script component
• Have one or more box colliders (Not marked as Trigger) to define the volume occupied by the room. Those colliders will be used by the script during generation to avoid overlapping and then be deleted. However, you must leave the closed doors outside of those box colliders to allow rooms to be linked. (Allows Physics.ComputePenetration to detect invalid placements)

3. RoomConfig

RoomConfig defines the behavior of a room prefab.

Key options:

Room Placement Rules

• Allowed Neighbors
  Restrict which room prefabs can be attached to this room. It should help to keep a coherent room organization and a believable dungeon.
• Max Instances
  This set the number of times this room will appear in the dungeon.

Distance Constraints

• Use Distance Constraint
• Reference Object
• Min Distance / Max Distance

Allow to set a distance min and max for the spawning of a room in a level. It asks for a reference object where you have to feed a prefab object. It can be useful for special rooms such as:

• Boss rooms
• Treasure rooms
• Exit rooms

Distance is measured from the room pivot to the reference object pivot. So, you can force distances between the start and the end of the dungeon for example.

4. Doors – Critical Setup

Doors are central to correct generation.

Door Requirements

• Must be tagged Door
• Must be a child of the room prefab
• Must be a closed door that the generator will try to open.
• Pivot must be perfectly centered
• Forward direction must point outward

⚠️ Important
Room alignment is computed using door forward vectors.
If the pivot is offset or rotated incorrectly:

• Rooms will misalign
• Doors will not connect correctly

5. Object Spawning System (RoomSpawnPoint)

Each spawn location uses the RoomSpawnPoint component.

This allows:

• Per-spawn-point object selection
• Weighted probabilities
• Full control over what can spawn where

Workflow

1. Add a child object to the room prefab
2. Tag it ObjectSpawner
3. Add RoomSpawnPoint component
4. Define spawnable objects and weights

This replaces global spawn lists and enables for example:

• Furniture-only spawns in corners
• Enemies only in combat zones
• Props only near walls, etc.

6. NavMesh Generation (Runtime & Build-Safe)

The generator can rebuild a NavMesh at runtime, including in builds.

Features:

• Uses Physics Colliders (not meshes)
• Works with procedurally spawned cubes and geometry
• No Read/Write mesh requirement

Key options:

• NavMesh Bounds Size (Create a square area with world (0;0;0) at its center where the NavMesh will be initialized)
• Layer Mask selection
• Runtime Gizmo visualization

A debug NavMesh mesh can be displayed during play mode.