Skip to content

[openworlds-audit] Atlas: seed the BG nav graph for fresh saves (Lower City / Upper City / Outer City / …) #261

Description

@100yenadmin

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.

Metadata

Metadata

Assignees

No one assigned

    Labels

    enhancementNew feature or requestepic:atlasEPIC B — a real, anchored map (Atlas)screen:mapPertains to the map screenseverity:criticalBlocks play or shatters CRPG framing (#242 Phase 5)tier-1Tier 1: Claude Code pluginui-auditFrom the 2026-05-29 UI/UX audit (docs/ui-audit/)

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions