AutoDungeon for GameMaker

AutoDungeon is a drop-in, fully-customizable 2D dungeon procedural generator for GameMaker that lets you turn a single line of code into sprawling, handcrafted-feeling levels.  Whether you’re making a roguelike, Metroid-style map, or just need rapid prototyping, AutoDungeon handles the heavy lifting while giving you total control over room types, layout “feel,” and replayable randomness.

The script returns a simple ds_grid of {real} values (-1 for empty cells, and then user-set values for the rooms themselves)

Key Features

• Simple Setup
  • Just instantiate:

dungeon = new AutoDungeonGrid(size, totalRooms, totalUniqueRooms, uniqueRoomsArray, connectingRoomsArray, mandatoryRoomsArray);
dungeon.generate_room([optional seed])

• Flexible room pools

  • Mandatory rooms (boss, special events, etc.)

  • Unique rooms (shops, mini-bosses, treasures) with per-room spawn rates and max-per-dungeon limits

  • Connecting rooms (generic corridors, hallways, filler)

• Reproducible randomness
  Optional seed parameter ensures you can save, share, or replay the exact same dungeon layout.

• Multiple build modes

  • Blob – an organic, cave-like cluster of rooms

  • Drunkard’s Walk – a winding, single-path “drunkard” carving from the start

  • Manhattan Distance – crisp L-shapes radiating out from the center, with optional MST-style linking

• Easy debugging & visualization
  • Built-in debug_draw_map(cellSize, spacing, showText) to instantly preview your grid in the GameMaker debugger.
    
  • All methods in the AutoDungeonGrid, GridUniqueRoom, and GridConnectingRoom constructors are heavily documented

Also includes (and requires) AutoTools, a collection of GameMaker scripts.