zwitschi
accf3a5306
Completes "Fixed daytime lighting and basic ambience" for 0.1.0. All 14 screenshots approved by the owner. Lighting rig (Tools/ue_build_demo_map.py): - Sun pitch -50 / yaw 120, intensity 4, warm (255/245/230), atmosphere sun light - Sky light 2.6 with real-time capture, sky atmosphere, height fog (density 0.008) - Unbound post-process volume with fixed exposure (min == max brightness) so a shot cannot wash out or crush to black depending on how much sky it frames - Dynamic-only: r.AllowStaticLighting=False plus MOVABLE lights and mesh components, so the editor's "LIGHTING NEEDS TO BE REBUILT" warning no longer fires and nothing needs baking Bugs found and fixed on the way: - Blender diffuse colours do not survive the FBX -> Unreal import: every site material arrived white and the terrain arrived with WorldGridMaterial, which is what actually made the scene look blown out. The demo builder now creates and assigns M_Asphalt, M_Concrete, M_Ground and M_RoadPaint. - Only one of the three crossings reached the game: each zebra band was its own object, so Blender renamed the duplicates .001/.002 and exact-name site assembly skipped them. All bands are now one Crossing_Markings mesh. - Demo cameras: street-level sat inside the facade body (rendering its unlit back face) and the crossing camera aimed at the s=36.6 crossing instead of the designated s=130.1 (UE X -14956). - The terrain had no material and imported as a bright default grid. - Cleared a committed Android File Server SecurityToken (plugin disabled and shipping-excluded; the value must stay empty). Docs: - Screenshots/README.md: one consolidated table for all 14 shots with map, camera view and description; all approved. - MEMORY.md: records the material-import, exposure, light_color struct, band-naming, camera-bounds and lighting-build traps. - TODO.md: lighting item marked done. Squash of branch gameplay-lighting-0.1.0 (PR #3).
Tools
Repeatable helpers that drive Blender, Unreal, and the reference/asset sources. Nothing here is hand-run twice: every step that produced committed content has a script.
Geographic tools live in Geo/tools/ and the Blender-side builders live next to their output in Art/blender/*/; this folder holds everything that talks to Unreal, the network, or the repository.
Conventions
- One script, one job. Every input is an argument; no interactive prompts.
- Absolute paths where a tool crosses into a sandbox (Blender Flatpak, the Unreal commandlet). Those processes do not share the repo's working directory.
- Unreal commandlets swallow
print(), so each writes a result file under/tmp/gigline/. Read the file; do not trust the exit code alone. - No credentials, no writes outside the project by default.
Repository and assets
| Tool | Purpose |
|---|---|
check-lfs.sh |
Fails if the lfs filter is missing or an LFS-tracked file was committed as a plain blob |
sibling_asset_audit.py |
Reads the sibling project's prop library from GLB headers into Art/props/reuse-manifest.json; copies nothing |
scale_test_export.py / ue_scale_test_import.py |
The 1 m = 100 uu scale test; the named presets ue_metric_v1 live in these two files |
Reference gathering
| Tool | Purpose |
|---|---|
commons_fetch.py |
Wikimedia Commons: search, exact File: titles, or a whole category; writes a provenance sidecar.json |
page_image_fetch.py |
Resolves a web page's og:image and downloads it (Flickr, Commons file pages, photo blogs) |
addon_compat_probe.py |
Verifies MPFB/Blosm can load and generate headless on the pinned Blender |
Blender content
| Tool | Purpose |
|---|---|
hero_facade_build.py |
Parametric hero façade; emits a JSON report naming the evidence behind every part |
mpfb_character_export.py |
MPFB human, standard rig, baked skin, FBX export |
Unreal import and level building
| Tool | Purpose |
|---|---|
ue_import_site.py |
Imports the six site FBXs into /Game/Hollywood/Site, setting collision complexity per mesh |
ue_hero_facade_import.py |
Imports the façade and places it on the measured building line |
ue_build_demo_map.py |
Builds /Game/Hollywood/DemoMap: lighting, façade, site meshes, player start |
ue_build_review_map.py |
Rebuilds Test/ReviewMap, stages the shot camera list, and stages the demo-map views |
ue_create_input_assets.py |
Creates /Game/Input actions and the mapping context headlessly |
ue_character_import.py |
Skeletal import plus the material/texture chain Interchange skips |
Visual review
| Tool | Purpose |
|---|---|
render_screenshots.py / render_screenshots.sh |
Rebuilds the review map, runs the game, captures the shot list into Screenshots/ |
judge_screenshot.py |
Vision-model pre-check: judges a screenshot against an expected-scene description (--image + --expect, or --shots for every shot in the README). Reads OPENROUTER_API_KEY from .env (ignored). Optional helper — a human must still approve. |