Critical finding M-01 from docs/ui-audit/screens/map.md. Parent epic: #249.
Symptom
Fresh baldurs-gate save shows ONE known location ("Baldur's Gate — Lower City") on the Atlas. The atlas chrome + region backdrop + layout simulation all work — there's just nothing to render.
File:line
- Engine:
atlas-surface (server.py — known_locations projection)
- UI:
viewer/openworlds/screen-map.jsx:99-99 (locations = surface?.known_locations || [])
Acceptance criteria
The atlas-surface for world="baldurs-gate" seeds the full BG canon nav graph on day 1 of a new save:
- Known on day 1 (party already aware): Lower City, Upper City, Outer City, Wyrm's Crossing, Rivington, Sword Coast region (regional pin).
- Rumoured/discoverable (
unknown:true style): Reithwin, Elturel, Candlekeep, Steel Watch Foundry, Undercity, Bhaal Temple, the Underdark, Avernus portal.
- Edges connect adjacent districts with
route_kind (street/road/river/ferry).
- Verified: the atlas pin count footer reads ≥ 6 known on a fresh save.
Why it matters
A 1-node atlas reads as broken even though the layout + zoom + clock + camp are great. This single fix elevates the screen from "feels empty" to "feels alive".
Related
screen-map.jsx:99 reads known_locations
screen-map.jsx:103 reads quest_markers — seed those too where they have a fixed location.
- Sword Coast regional map already wired as backdrop:
screen-map.jsx:399.
Epic: #249. Umbrella: #242.
Critical finding M-01 from
docs/ui-audit/screens/map.md. Parent epic: #249.Symptom
Fresh
baldurs-gatesave shows ONE known location ("Baldur's Gate — Lower City") on the Atlas. The atlas chrome + region backdrop + layout simulation all work — there's just nothing to render.File:line
atlas-surface(server.py —known_locationsprojection)viewer/openworlds/screen-map.jsx:99-99(locations = surface?.known_locations || [])Acceptance criteria
The atlas-surface for
world="baldurs-gate"seeds the full BG canon nav graph on day 1 of a new save:unknown:truestyle): Reithwin, Elturel, Candlekeep, Steel Watch Foundry, Undercity, Bhaal Temple, the Underdark, Avernus portal.route_kind(street/road/river/ferry).Why it matters
A 1-node atlas reads as broken even though the layout + zoom + clock + camp are great. This single fix elevates the screen from "feels empty" to "feels alive".
Related
screen-map.jsx:99readsknown_locationsscreen-map.jsx:103readsquest_markers— seed those too where they have a fixed location.screen-map.jsx:399.Epic: #249. Umbrella: #242.