Dungeon Generator – Procedural Dungeon Creation System!
New versions coming out soooonnn :3
Hey if u like my Scripts, would not mind u joining my dc server to see what im up too! MaxRealm!/M.E
Model Link: Dungeon Generator
- Status -
This project is in V2. if u find bugs report it in Max Realm Studio - DC
NEW:
Added Zombies and Props spawning!
Overview
The Dungeon Generator is a robust procedural room-placement system designed to generate rogue-like dungeon layouts using prebuilt modular rooms. It performs collision-aware room placement, supports weighted randomness for room selection, and auto-furnishes placed rooms with decorative objects.
Ideal for dungeon crawlers, adventure games, and randomized level design.
Features
Infinite room generation until no spawn points remain
AABB-based overlap checking
Weighted room selection (via NumberValueobject in template)
Automatic Place Objects from pre-defined room slots
Clean modular code split across multiple scripts
Script Breakdown
DungeonGenerator.lua
Handles the entire generation logic:
- Scans for spawn points and overlap boxes
- Aligns rooms based on designated
SpawnPlacerparts - Rejects overlapping placements
- Recursively processes new spawn points
- Outputs full log of generation process to output
DungeonGenerator:Generate(rootRoom)
RoomRegistry.lua
Provides a weighted random pool of room templates stored in ServerStorage.RoomTemplates. To adjust room rarity, insert a NumberValue named Weight under the model.
{
Model = RoomTemplate,
Weight = 3, -- Higher means more likely
}
FurnIsh.lua
Auto-furnishes each room after placement. Looks inside a folder named Objects in each room and replaces placeholder parts with real object clones from ServerStorage.Objects.
Setup Instructions
Folder Structure
ServerStorage
├── RoomTemplates
│ ├── Room1 (Model) [has Weight NumberValue]
│ ├── Room2 ...
└── Objects
├── Water (Normal Part)
└── Chest (Model)
ReplicatedStorage / ServerScriptService
├── DungeonGenerator (Folder/Module)
│ ├── DungeonGenerator.lua
│ ├── RoomRegistry.lua
│ └── FurnIsh.lua
Workspace
├── StartRoom (room with RoomSpawnPoints)
Required Room Parts
Each room template must contain:
SpawnPlacer (red part): Determines alignment point for placement
RoomSpawnPoints: Parts named "RoomSpawnPoint"used as connection points- OVERLAPBOXS folder: Holds parts used for collision detection
How to Use
- Place the StartRoom manually in
Workspacewith at least oneRoomSpawnPoint. - Call:
local DungeonGenerator = require(path_to_DungeonGenerator)
DungeonGenerator:Generate(workspace.StartRoom)
- Watch as rooms are placed in real-time until all spawn paths are exhausted.
Notes
- Rooms missing
SpawnPlacerwill be skipped with a warning. - Overlapping rooms are auto-removed during placement.
- Room weighting can control generation flow and room rarity.
Feedback & Suggestions
Feel free to reply here with improvements or showcase your generated dungeons!
This system is modular and designed to be extended (e.g., biomes, room types, custom room validation).
Example Output (Console)
🛠️ Starting dungeon generation from: StartRoom
⤷ Queued spawn point: StartRoom.RoomSpawnPoints.Part
🎯 Processing spawn point: StartRoom.RoomSpawnPoints.Part
🔄 Trying template 'RoomA' (weight=2.00), 5 left in pool
✅ Placed room: RoomA
➕ New spawn point queued: RoomA.RoomSpawnPoints.Part1
...
🏁 Dungeon generation complete. No more spawn points.
Example Video & Place
Is this help full?
- Yes
- No
- Needs some work
