Dungeons and Mazes

Dungeons and Mazes is a commercial Godot 4 addon for procedural maze and dungeon generation, built as a native GDExtension for projects that need configurable generation, rich gameplay metadata, and native-code runtime performance.

The addon wraps the dungeons_and_mazes C++ core library and exposes a Godot-friendly API for generating classic mazes, room-and-corridor dungeons, and multi-floor layouts with stairs, semantic room roles, mission structure, and data you can use directly in gameplay systems.

What You Get

• A Godot 4 GDExtension addon packaged under addons/dungeons_and_mazes
• Maze generation with multiple algorithms and post-processing controls
• Dungeon generation with multiple layout families and corridor strategies
• Multi-floor support with stair metadata
• Semantic cell metadata for doors, start cells, keys, locks, exits, treasure, boss rooms, hubs, and secrets
• Room, corridor, region, mission, and room-graph metadata returned directly to Godot
• Included demo scenes for flyover and first-person inspection
• Addon documentation covering installation, API usage, result formats, and controls

Maze Features

• Depth-first backtracker
• Randomized Prim
• Growing Tree
• Hunt and Kill
• Randomized Kruskal
• Wilson
• Eller
• Aldous-Broder
• Sidewinder
• Binary Tree

Maze options also support room stamping, stairs, dead-end pruning, and braid-style loop creation.

Dungeon Features

• Scatter room layouts
• BSP layouts
• Cellular automata cave-style layouts
• Digger layouts
• TinyKeep-inspired layouts
• Sequential corridor linking
• Minimum-spanning-tree corridor linking
• Minimum-spanning-tree with loops

Dungeon results include semantic room roles, door placement, connected-region metadata, mission structure, room graph data, and start-to-exit distance metrics.

Godot API Highlights

The addon registers DungeonMazeGenerator as a Godot class. From GDScript, you generate a maze or dungeon with a dictionary-based options interface and receive metadata-rich dictionaries back.

You can query:

• Walkable layers per floor
• Cell semantic types
• Room ownership per cell
• Region IDs per cell
• Room metadata
• Corridor metadata
• Stairs metadata
• Mission path data
• Room graph connectivity

That makes the addon useful not just for visualization, but also for spawn selection, encounter placement, key-lock progression, mission routing, minimaps, and runtime gameplay logic.

Included Demo Scenes

The package includes sample scenes for:

• Maze flyover
• Dungeon flyover
• Maze first-person exploration
• Dungeon first-person exploration

These scenes are intended to help you validate the addon quickly in a clean Godot project and inspect generated layouts and semantic markers.

Kenney Showcase Examples

The wider demo project for this addon also includes optional showcase scenes built with Kenney's CC0 asset packs, including Mini Dungeon, Modular Dungeon Kit, and Modular Space Kit. These examples show how the same generation data can be presented with a themed visual layer instead of primitive debug geometry.

The shipped addon itself remains art-agnostic. Kenney showcase assets and themed demo content are for demonstration in the repository demo project and are not part of the packaged runtime addon download.

Installation

1. Copy the dungeons_and_mazes addon folder into your project's addons/ directory.
2. Make sure the binary for your target platform is included.
3. Open the project in Godot 4.
4. Instantiate DungeonMazeGenerator from GDScript with ClassDB.instantiate("DungeonMazeGenerator").

License

This addon is distributed under the Dungeons and Mazes commercial license. It is intended for licensed use in your own projects and applications, not for redistribution as a standalone competing plugin or toolkit.

Good Fit For

• Godot developers building roguelikes, dungeon crawlers, adventure games, tactics games, and exploration systems
• Teams that want native-code generation speed and richer metadata than a minimal tile-only generator
• Projects that need a reusable procedural generation system rather than a one-off demo script

Scope

This addon focuses on generation and metadata. It does not ship a complete gameplay framework, combat system, AI stack, or finished art pipeline.

Support

If you run into integration issues, first verify that the correct addon binary is present for your platform and that the packaged dungeons_and_mazes.gdextension file matches the included binaries.