From 876fb5988253b2a5574fe5fa366d2159c865bd1b Mon Sep 17 00:00:00 2001 From: Zwitschi Date: Tue, 3 Nov 2026 09:01:46 +0100 Subject: [PATCH] Add unversioned local map development section --- TODO.md | 70 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 70 insertions(+) diff --git a/TODO.md b/TODO.md index dba6b55..be5f34e 100644 --- a/TODO.md +++ b/TODO.md @@ -286,6 +286,76 @@ not delay the release. yes, prototype the local MPFB/MakeHuman pipeline outside the repo and commit only the final CC0-derived assets with provenance. +## Local map development + +Goal: build a local, data-backed map pipeline that can replace or supplement the stylized venue +geometry with licensed OpenStreetMap footprints, 3D building massing, reference-derived photoreal +facades and AI-assisted composition. This is an unversioned development track, not a release gate. + +### Data, licensing and scope + +- [ ] Define the first target block and whether the result replaces, supplements or only informs + the current stylized venue specs (`docs/hollywood-boulevard-map.md`, + `docs/joke-shop-map.md`). +- [ ] Audit OpenStreetMap's ODbL attribution/share-alike obligations and decide whether derived + geometry ships, stays development-only, or needs a separate data layer. +- [ ] Choose an offline OSM extract workflow (Overpass/Geofabrik) and pin the extract date and + query so the map build is reproducible. +- [ ] Evaluate licence-compatible 3D building datasets (OSM Buildings, Overture, CityGML/LOD1–2 + or local authority data); record coverage, accuracy, format and redistribution terms. +- [ ] Add a provenance sidecar for every map source and derived asset, including source URL, + licence, capture/extract date and attribution text. + +### Reference imagery + +- [ ] Write a reference shot list per block: facade materials, windows, signage, rooflines, + street furniture, curb cuts and lighting. +- [ ] Download and catalogue reference images from Wikimedia Commons, local/own photography or + other clearly licensed sources; record author, licence and attribution. Do not use + unlicensed Street View or scraped commercial imagery. +- [ ] Separate development-only references from shipped textures; commit only images with clear + redistribution rights and keep the rest under `tmp/` or the ignored reference folders. +- [ ] Define the photoreal target and a material-derivation workflow (albedo/normal/roughness, + AO, weathering) that matches the existing Compatibility renderer. + +### Geometry and AI-assisted composing + +- [ ] Prototype OSM footprint import into Blender at game scale and orientation, then compare it + against the current venue footprint/collider layout. +- [ ] Import 3D building massing for the target block, clean the topology and assign LOD bands; + do not import unbounded city-scale meshes into the runtime. +- [ ] Build a reusable photoreal facade kit (window bays, cornices, storefronts, awnings, signage) + so buildings share materials and stay inside the venue triangle/material budgets. +- [ ] Add an AI-assisted composition step for palette, facade rhythm and reference boards; record + the model, prompt and output, and keep human review as the acceptance gate. AI output must + not be treated as licensed map data or shipped without provenance. +- [ ] Integrate the result behind `WorldBuilder.VENUE_SPECS` with colliders, navigation obstacles, + occlusion and the existing day/night materials. + +### Gaussian splatting evaluation + +- [ ] Evaluate Gaussian splatting as a development tool: local capture, splat reconstruction, + Blender import and comparison against the concept/reference set. +- [ ] Test whether a splat can be used as a photoreal reference or backdrop, and measure file + size, render/import cost and Godot Compatibility support. +- [ ] Check capture permissions, privacy (people, plates, storefronts) and the licence of every + capture before using it in the repository. +- [ ] Record a go/no-go decision in an ADR. Keep splats development-only unless runtime + performance, collision/navigation and provenance are all proven. + +### QA and exit + +- [ ] Compare the data-backed block against the existing screenshots and map documentation; keep + the stylized fallback available. +- [ ] Run the venue triangle/mesh budget, navigation and collider checks, plus day/night capture + comparisons. +- [ ] Update `docs/architecture.md`, the venue map documents, `docs/asset-tooling.md`, + `docs/development-status.md` and `CHANGELOG.md` when the pipeline ships or a source is + rejected. +- [ ] Exit: one local block is reconstructed from licensed data with reference-derived photoreal + facades, passes performance/navigation/visual QA and has complete provenance; or the + pipeline is rejected with the findings recorded. + ## Future 0.x / non-blocking candidates - [ ] Live 3D body-camera replay.