Files
gig-line/Tools
zwitschi c9e933376c review: restore character + cubes in ReviewMap, re-render all shots
Root cause of the empty review frames: EditorLevelLibrary.load_level/new_level
are deprecated no-ops in -nullrhi commandlets, so staged actors landed in the
current world and got saved over the wrong map. Switched both map builders to
the LevelEditorSubsystem and reordered the review builder to save ReviewMap
before the DemoMap section (the switch-back to a map that only exists in
memory silently failed, writing demo content over ReviewMap).

Rebuilt both maps, re-rendered every screenshot; user visual check passed.
Screenshots/README.md cube naming corrected (A grounded, B floating), approval
states updated; TODO.md visual-review notes closed. MEMORY.md records the
deprecated-call and save-order traps.
2026-11-07 16:23:59 +01:00
..

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/