Files
gig-line/Tools
zwitschi e95ba033be docs: correct the LFS trap and add Tools/check-lfs.sh
The lfs filter is inactive until 'git lfs install' writes filter.lfs.*, and a
matched file is then stored as a plain blob without any warning. Document that
instead of the wrong claim that git add fails, and add a guard script.
2026-11-06 21:21:32 +01:00
..

Tools

Repeatable import/export and processing helpers. Anything that was done twice by hand belongs here.

Conventions

  • One script, one job. No interactive prompts; every input is an argument.
  • Each script documents its input format, output format, and the exact tool version it was tested with.
  • Blender scripts run headless (blender --background --python), so they can be re-run for a regression check.
  • No credentials, no absolute machine paths, no writes outside the project by default.
  • A script that produces game content logs what it produced, so Game/Content can be audited against it.

Planned helpers

  • check-lfs.sh — repository guard (exists): fails if git-lfs or the lfs filter is missing, or if an LFS-tracked file was committed as a plain blob
  • Blender export preset runner (named presets, metric scale assertion)
  • Blender→Unreal scale test (export a known-size cube, verify 100× conversion)
  • OSM extract fetch and manifest writer (records date, bounds, checksum)
  • QGIS processing steps as batch scripts, so the geo cleanup is reproducible rather than GUI-only