zwitschi
386d4bee78
Geo/tools/ is now every geographic script, with Geo/README.md documenting each one; the Blender-side builders moved beside their outputs in Art/blender/*/ and import their helpers from Geo/tools/osm_common.py. That module gains to_unreal_local() and to_blender_local(): the only place in the repository that multiplies metres by 100, so a second silent scale cannot be introduced. block_height_report.py adds height provenance for the block — 3 of 15 buildings have no height data and render at a placeholder 6.4 m. asset_metadata.py writes and audits <asset>.geo.json sidecars; four now exist (hero-facade, terrain, street, blockout) and the audit recomputes each centre from the origin, failing anything that disagrees.
Gig Line
A Linux-first Unreal Engine game about walking and driving through a real city. The first release, 0.1.0, is a walkable exterior demo around 6840 Hollywood Blvd / El Capitan Entertainment Centre, covering the south-side frontage between Highland Avenue and Orange Drive plus the north-side frontage within 50 m of the boulevard.
Status
Pre-production. The Unreal project, prototype content, and geographic data are tracked; the engine itself is not. Current state is tracked in ROADMAP.md, and the per-task setup state in Docs/setup.md.
Layout
| Path | Contents |
|---|---|
Game/ |
Unreal project, configuration, source, game-ready content |
Art/ |
Editable Blender files and original textures |
Geo/ |
Source manifests, permitted geographic data, processing scripts |
Tools/ |
Repeatable import/export helpers |
Docs/ |
Setup, toolchain pins, licensing, release checks |
Getting started
git lfs install # required: content, images, audio, and geo files are LFS-tracked
git lfs pull
Tools/check-lfs.sh # verifies the lfs filter is active and files are stored as pointers
The engine is installed outside the repository and pinned in Docs/toolchain.md. The full procedure is in Docs/setup.md.
Documents
- ROADMAP.md — living task list, source of truth for progress
- PLAN.md — scope, stack, release policy, timeline
- AGENTS.md — contributor and agent rules
- MEMORY.md — shared session memory: discoveries, gotchas, bugs
- Docs/toolchain.md — pinned versions
- Docs/release-checks.md — release gate definitions
- Docs/licensing.md and THIRD_PARTY_NOTICES.md — licensing
- CHANGELOG.md — release history
Licensing
Project-owned code, art, and documentation are dedicated under CC0 1.0. The engine, third-party assets, and geographic data have separate terms; see Docs/licensing.md. OSM-derived output carries "© OpenStreetMap contributors".