Metroidvania Map Architect

Procedural Map Architect is a node-based dungeon generator for Pygame. Standard "random walker" algorithms just wander around a grid placing floor tiles, which usually results in messy caves and broken game logic where keys spawn behind the doors they are supposed to unlock.

This asset fixes that by separating game design logic from physical coordinates. The engine first builds a "Golden Path" (Start -> Key -> Lock -> Boss -> Exit), guaranteeing the layout is 100% playable. It then weaves randomized dead-end branches into the graph, and finally maps the entire logic web onto a 2D physical grid without overlapping rooms.

This is the exact logic foundation required to build infinite, replayable Metroidvanias, roguelikes, or Zelda-style dungeons in Python.

Core Features:

• Guaranteed Playability: The dual-phase algorithm ensures the critical path is logically sound before physical generation even begins.
• Customizable Nodes: Easily inject your own room types (Item Rooms, NPC Shops, Trap Rooms) directly into the generation sequence.
• Breadth-First Spatial Mapping: The grid mapper automatically assigns (x, y) coordinates, ensuring corridors connect cleanly and rooms never overwrite each other.
• Interactive Sandbox Included: Run the included main.py file and hit the spacebar to watch the algorithm generate infinite, unique dungeon layouts in real-time.

What's Inside the Package:

• map_logic.py (The graph and node generation brain)
• grid_mapper.py (The spatial and physical coordinate algorithm)
• main.py (The visual Pygame sandbox)
• README.md (Clear integration guide)

License: Purchasing this asset grants you a non-exclusive, royalty-free license to use, modify, and integrate this code into any commercial or non-commercial project. Reselling the raw source code is prohibited.