mapwright/README.md

Mapwright — Battle Map Generator (Foundry VTT)

One-click procedural battle maps for any Foundry world. Generates good-looking floor plans with Foundry walls, doors, windows and lighting already placed, so a map is playable the moment it's created. Built to be usable with no prior experience.

Status — v0.4.0

Six map categories. New since v0.3:

• Town / Village and City Block — top-down tactical maps where buildings are solid rooftop blocks (perimeter walls block tokens; streets are the open, token-scaled play space). City = street grid + sidewalks + lane markings; Village = curved road, scattered houses, gardens, trees, optional pond.
• Furniture is now locked Tiles (not painted into the background): room-aware placement (grid-aligned, against walls, doorways clear), players can't move them, sprites auto-generated + cached.
• Backgrounds set via the v14 Level system; flat/fully-lit by default with dynamic lighting opt-in.

Earlier — v0.3.0

Three generator families, all standalone, all auto-placing Foundry walls/doors/lights:

Buildings (Modern / Fantasy)

• Non-rectangular footprints: Rectangle / L / T / U / Cross.
• Multi-floor (1–4): a folder of linked scenes sharing one footprint, with a vertical-circulation column — elevator (modern) or staircase (fantasy) — aligned at the same spot on every floor, plus up/down GM notes.
• Era-aware door & window artwork: planked wood doors / metal-slab glass doors with handles + swing arcs; framed, mullioned windows. The Foundry door/window walls are placed to match the art exactly.
• Furniture / props drawn per room type (beds, desks, meeting tables, server racks, counters, crates, shelves…). System-agnostic, vector, no external art.

Caves / Dungeons (Rough Cave / Crypt / Sewer)

• Organic cellular-automata caverns — flowing, non-axis-aligned walls (contour traced, smoothed, simplified to diagonal Foundry wall segments). Rock floor, cast shadows, scattered debris, labelled features + torch lighting.

Outdoors (Grassland / Desert / Snow / Badlands)

• Open terrain with organic water bodies (shoreline blocks movement, not sight), boulder cover, clustered trees, biome ground texture.

Shared: live WYSIWYG preview, seeded reproducibility (🎲 reroll), Foundry Walls / Doors / Windows / AmbientLights / Notes — works in any world.

Planned next: prop/furniture as interactive Tiles, built-dungeon (rooms+corridors) style, water/elevation in caves, UVTT export.

Architecture

One geometry model drives both the picture and the playable walls, so they can never disagree (the failing the older generators had):

seed → building.mjs (BSP → rooms + region grid)
     → walls.mjs    (region grid → merged wall/door/window segments + connectivity)
        ├─ render-vector.mjs → SVG  (preview + scene background)
        └─ scene.mjs          → Foundry Walls/Doors/Lights/Notes

module/lib/* is pure and Foundry-agnostic (unit-testable in Node). module/app/* is the dialog. module/mapwright.mjs wires the toolbar button.

Try it

1. Enable Mapwright in Manage Modules (it's standalone — no dependencies).
2. Open the Walls tool group in the scene controls → click the map icon (or run game.mapwright.open() in the console, or use the Scenes tab button).
3. Pick a type/size, watch the preview, hit Create Map.

Dev

node dev/render-sample.mjs renders sample SVGs (no Foundry needed) for eyeballing visual quality. On macOS, qlmanage -t -s 1600 -o . *.svg rasterises them to PNG.