zwitschi
e95ba033be
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.
20 lines
1.1 KiB
Markdown
20 lines
1.1 KiB
Markdown
# 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
|