← all kitsfoundation kit

procgen

seeded dungeons and maps

The "vast but cheap" lever: seeded, deterministic generators whose output drops straight into TileMap2D data strings and spawn lists. Same seed ⇒ same output on every device/server/test. Every map generator guarantees connectivity (BFS-validated, retried internally) and returns a report. Example: games/examples/kit-roguelike-demo (rooms-stitched, rooms-and-corridors and cave floors, budgeted enemies, loot, a boss every 3rd floor).

Setup

local procgen = require("@kit/procgen")
local level = procgen.dungeon({ seed = runSeed * 1000 + floor, w = 30, h = 30, rooms = 8 })
entity("map").data = procgen.toTileMap(level, { ["."] = "f" })   -- "." is always empty in TileMap2D: map floor to a tile char
local x, y = procgen.cellToWorld(level.start.x, level.start.y, 16)  -- map at (0,0)

Grid chars: # wall, . floor (configurable wall/floor). Cells are 0-based like TileMap2D.

Full reference on GitHub