Isometric Subterranean Cartographer

Isometric Subterranean Cartographer

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.

Saving a mapCopy SVG puts the whole drawing on your clipboard. Paste it into a text file saved as .svg, or into Inkscape or Illustrator. The fonts travel inside the file.

The graph

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.

    Checks

      Graph JSON

      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.

      Reading the JSON

      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
      }

      The top level

      format, version
      Labels that say this is an IsoDungeon graph; leave them as they are.
      type
      The kind of place. It picks the colours, the connectors, the creatures and the generated names. Choose one: crypt mine temple undercity oubliette seacave
      seed, variant
      The random number the map grew from, and which re-roll of it passed the checks. Changing them alters the small details drawn inside rooms.
      title, subtitle
      The words on the ribbon and the line under it. Leave title as "" to use the name in the Dungeon name box.
      layout.salt
      Which of several trial placements on the page was kept. Delete the whole "layout" entry to let the app try fresh placements when you redraw.

      levels

      id
      A short unique name such as "L1"; rooms and edges refer to it.
      name
      The level’s heading in its legend. Rename freely.
      depth
      How far below the entrance: 0 for the top, then 1, 2 …
      kind
      Built rooms and corridors, or natural cave: dungeon cave A top level may also carry "surface": true to be drawn open to the sky.
      W, H
      The level’s size in flagstones (W 8–20, H 8–16). One flagstone is about 5 ft.
      heights
      Dungeon levels only: the floor heights rooms may step between, e.g. [0, 0.5, -0.5, 1].
      liquid, liquidFrac
      Cave levels only: what pools in the low places, and roughly how much (0–1). water lava
      wallH, rails
      Optional: taller walls on a surface level; mine-cart rails along a mine’s corridors (true).
      number
      Written by the app: the level’s number on the map. You can ignore it.

      rooms

      id, level
      A unique name such as "L2.3", and the level it is on. A dungeon level holds 2–6 rooms, a cave level 2–4.
      role
      What the room is for; it decides what is drawn inside and the room’s title. Any role works in any type of place, but these are each type’s own: crypt 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 oozepit

      edges

      Every connection is an edge with an id and a kind: passage way loop

      passage
      A corridor between two rooms on one level, named by 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.
      way
      A built way down from one level to another: { "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.
      loop
      A second route between rooms on two levels, which closes a loop (1–3 of them): "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.
      role
      Loops only: what the second route is like, which picks how it is built. 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.
      oneWay
      true on a one-way loop; set with the oneway role.
      ifHidden
      Words used only if a loop can’t be built on the page: it is then drawn as a trapdoor and a dotted line, and the legend calls it this (e.g. "a bone chute").

      resolved: what was actually built

      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.

      built
      true if it was built on the map, false if it fell back to a trapdoor.
      fromLevel, toLevel, fromRoom, toRoom
      Where it actually leaves and arrives; it always goes downhill from from to to.
      build
      The template used, e.g. grand, spiral, switchback, lift, chute, secretstair, crawlway.
      parts
      The pieces in order, with their flavour in brackets, e.g. "chute (bone chute)".
      door
      How it meets the room it arrives in: open closed portcullis secret barred
      role, roleKept
      The loop’s role, and whether a connector of that kind fitted (false means an open route was used instead).

      Try this

      1. Rename a level: change its "name" and press Draw this JSON.
      2. Turn a loop into a shortcut: change its "role" to "shortcut", delete "layout", and redraw.
      3. Change the place: set "type" to "seacave"; the colours, creatures and connectors follow.

      Reading the map

      Each level is a cut slice of earth with its front walls removed. Numbered circles match the legends. Lettered diamonds mark where each way starts (↓) and where it arrives (↑). Ways down are lettered first; loop ways follow. Hidden ways run inside a sleeve of rock with its near face cut away. If a loop way could not be built on the page, it falls back to a trapdoor and a dotted line.

      The graph

      Rooms are the nodes. Passages join rooms on one level; built ways join a level to one below it, at most two per level because a level has two front faces to leave from; loop ways join any two levels and are built the same way, from a front face down to a back-wall doorway. Loops = edges − rooms + 1.

      The checks

      A graph must pass two stages. Structure: 3–5 levels, one entrance, every level reached by one built way, rooms joined on each level, 1–3 loops. Page: every level, way and loop way built with no overlaps, and the drawing filling at least a set share of the chosen page. A graph that falls short is re-rolled as a variant of the same seed.

      Why loops

      A dungeon that is a tree has one route to everything. Loops give a party choices: a second way down, a shortcut back up, a one-way chute that cuts them off. Each loop way carries a role in the JSON, and the role picks its connector. Loops within a level are extra passages between rooms at least two passages apart. The idea follows Jennell Jaquays’s multi-path dungeon levels and Joris Dormans’s cyclic dungeon generation.

      No redundant links

      Two routes never join the same pair of rooms unless one is hidden, barred or one-way. A second link between the same two levels must arrive at least two passages from the first, so its loop runs through three rooms or more. Links that skip a level are rare outside five-level dungeons.

      Bestiary

      Twenty-eight occupants, each with a threat (0 harmless to 4 deadly), a habitat and the dungeon types it haunts. Rooms get their set pieces from their recipe, and now and then a wanderer drawn from the level’s pool: deeper levels lean to deadlier things, and water-dwellers (gators, octopuses, merrow, sirens) wait beside the water.

      Names

      Every new map gets a name built from its type of place: an adjective, a word for the place, and a person, a power or a place-name, as in “The Reeking Cisterns of the Rat King” or “The Salt Cove of Captain Morrow”. Type over it to use your own, or press New name.

      Long drops

      No ladder runs more than about 15 ft: tall shafts are staged on ledges, and deep drops prefer spiral stairs, switchback towers, lifts (cage, chain platform, coffin lift, cargo net), rock chimneys or a waystation part-way down.

      Versions

      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.

      Licenses

      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.