# 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.