Computer-drawn isometric maps of places under the earth, three to five levels deep, built from a random graph with loops. Six kinds: crypt, mine, temple, undercity, oubliette and sea cave. Built ways join the levels as a branching tree; one to three loop ways close loops as alternative routes, shortcuts, dangerous paths or one-way drops, built from stairs, switchbacks, lifts, chutes, crawlways and secret stairs to suit the dungeon. Pick a type, set the levels and loops, roll a seed, and copy out the SVG or the graph as JSON. Pause the cursor over the Copy SVG button for instruction.
.svg, or into Inkscape or Illustrator. The fonts travel inside the file.
Boxes are levels, solid lines the ways down, dashed lines the loop ways, labelled with their role. The role picks the build: an alternative route is an open stair or lift, a shortcut is hidden or barred from the far side, a dangerous path is a rope bridge, scree or chimney, and a one-way drop is a chute or a sheer shaft.
The dungeon as data. Edit it (rename levels, change room roles, give a loop way another role: alternative, shortcut, dangerous or oneway; join it to other levels; add a level) and draw it again. The layout.salt field pins the placement; delete it to let the forge try fresh placements.
Don’t be put off by the size of it: the JSON is just a list of the map’s parts, written so a program can read it. The graph on the left is a picture of this same data. Each box there is an entry in levels, each solid line is an edge of kind way, and each dashed line is an edge of kind loop, labelled with its letter and role. The rooms and the passage edges that join them live inside the boxes. Change the JSON, press Draw this JSON, and the map, the graph and the checks all follow.
Text in "quotes" is a word or name; bare numbers are numbers; [ … ] is a list; { … } is a group of named fields. Keep the commas between items and the quotes around names, and the editor will be happy. If something is wrong, Checks says what and where.
{
"type": "crypt", which kind of place
"seed": 1031, the dice roll it came from
"title": "", blank = use the generated name
"levels": [ { "id": "L1", … }, … ], the boxes
"rooms": [ { "id": "L1.1", "level": "L1", "role": "crypt" }, … ],
"edges": [ passages, ways, loops ], how it all joins up
"layout": { "salt": 1 } pins the placement
}
crypt mine temple undercity oubliette seacavetitle as "" to use the name in the Dungeon name box."layout" entry to let the app try fresh placements when you redraw."L1"; rooms and edges refer to it.0 for the top, then 1, 2 …dungeon cave A top level may also carry "surface": true to be drawn open to the sky.[0, 0.5, -0.5, 1].water lavatrue)."L2.3", and the level it is on. A dungeon level holds 2–6 rooms, a cave level 2–4.crypt ossuary treasury shrine traphall prison library guard nave courtyard
mine minework camp storage guard lair
temple vestibule idolhall sanctum library traphall prison magma hoardcave
undercity culvert cistern sluiceroom ratden sump
oubliette cellblock guardroom torture oubpit warden escape yard gatehouse
seacave dock wreck tidepool smugstore smugcamp
caves, any type grotto fungus flooded oozepitEvery connection is an edge with an id and a kind: passage way loop
a and b: { "id": "p7", "kind": "passage", "a": "L1.1", "b": "L1.3" }. Each level’s passages form a tree; an extra one marked "loop": true makes a loop within the level (up to 3), and should join rooms at least two passages apart.{ "id": "A", "kind": "way", "from": { "level": "L1" }, "to": { "level": "L2" } }. The ways form a tree from the entrance: every level but the top is reached by exactly one, and a level can send at most two down. The app chooses the rooms."from" and "to" each name a level and a room. The app tries to use those rooms but may land in a neighbour if the page needs it.alternative shortcut dangerous oneway An alternative is an open stair, lift or the like; a shortcut is hidden (a secret stair, crawlway or well) or barred from the far side; a dangerous path is a rope bridge, scree slope or rock chimney; a oneway drop is a chute or sheer shaft.true on a one-way loop; set with the oneway role."a bone chute").After drawing, the app adds a resolved group to each way and loop, recording the result. You never need to edit it; it is ignored when you redraw.
true if it was built on the map, false if it fell back to a trapdoor.grand, spiral, switchback, lift, chute, secretstair, crawlway."chute (bone chute)".open closed portcullis secret barredfalse means an open route was used instead)."name" and press Draw this JSON."role" to "shortcut", delete "layout", and redraw."type" to "seacave"; the colours, creatures and connectors follow.I. IsoDungeon Forge. A single branch of three levels, drawn as cut-away isometric slices in a hand-inked style on parchment: crypt, mine and temple, with room legends, generated names and SVG export.
II. Graph architecture. The app split into separate modules: a random graph generator (3–5 levels, 1–3 loops), a validator for structure, a page-fitting stage that tries placements and variants until the map fills the page, and a renderer. Dungeons became JSON you can edit and redraw, with a schematic and page sizes; loop ways were built from the same stairs, bridges and shafts as the ways down, painted in depth order.
III. Parts, roles and new types. A library of connector parts: hidden ways in cut-away rock sleeves, staged shafts, switchback towers, lifts, waystations and natural forms. Loop ways gained roles (alternative, shortcut, dangerous, one-way), redundancy rules and loops within a level. Undercity, Oubliette and Sea Cave joined, each defined by one data entry.
Bestiary and license. Occupants became data (threat, habitat, dungeon types) with sixteen new creatures, restyled after a reference sheet, and wandering occupants chosen by depth. The code took the MIT License and the maps CC0. The app was renamed the Isometric Subterranean Cartographer.
The code is free software under the MIT License: use it, change it, share it or sell it, as long as the copyright and license notice stay with it. It was designed by Daniel O’Neil and written with Claude, Anthropic’s AI model.
The maps you make here are yours to use however you like: each one is dedicated to the public domain under CC0 1.0, as the fine print at its foot says (see the Creative Commons licenses). Credit (“made with the Isometric Subterranean Cartographer”) is appreciated but not required.
The fonts embedded in the page and in each map, MedievalSharp (Wojciech Kalinowski) and Almendra (Ana Sanfelippo), are used under the SIL Open Font License 1.1, which allows them to be bundled with software but not sold on their own.