Add unversioned local map development section
This commit is contained in:
1 parent
979c6ad789
commit
876fb59882
1 file changed
+70
@@ -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.
|
||||
|
||||
Reference in new issue
Block a user