Game Asset Preflight — Asset Folder QA

PREFLIGHT TOOLKIT #002 · Version 1.0.0

Find missing glTF textures and OBJ/MTL references before asset handoff. Scan the exported folder and get an HTML + JSON report with file paths, evidence and next steps, while the source files stay unchanged.

You get the checker, Windows launcher, guides, tests and example reports. Windows 11 verified; Python 3.12 and Pillow 12.3.0 required. Try the free PASS and FAIL reports before buying; the scanner is in the paid download.

Python command-line source package. This is a folder checker; it does not import assets into Blender, Godot, Unity or Unreal.

What it checks

• glTF / GLB: external image and buffer references, missing files, path case mismatches, basic GLB structure and declared buffer sizes.
• OBJ / MTL: material-library and texture-map paths, including common map options and quoted paths.
• Textures: decoding of PNG, JPEG, TGA, TIFF and BMP; corrupt or empty files; non-power-of-two dimensions and configurable size limits.
• Folder consistency: exact duplicate files, nonportable names, large files, texture-channel size mismatches and LOD filename gaps. Missing channels are errors only when you explicitly require them.

What you get

The source CLI, Windows launcher, README, installation guide, quickstart, changelog, automated tests, original synthetic fixtures and complete PASS / FAIL HTML + JSON example reports. The code is MIT licensed; Pillow has its own license. No exclusive rights are sold.

Local processing

The scanner reads your input files and writes reports to a new folder outside the input. It does not fix, rename, delete or upload assets. No telemetry, accounts, paid API or backend. Installing the Python dependency may require internet; scanning runs locally.

Requirements and tested environment

Python 3.12 + Pillow 12.3.0 required. Install instructions are included. This download is source code, not a standalone .exe. No game engine installation is needed.

Verified on Windows 11 / Python 3.12.14 / Pillow 12.3.0: 53 automated tests, 51 passed and 2 skipped because Windows did not permit creating real symlinks. A fresh ZIP extraction passed the suite, CLI, Windows launcher and demo runs. Linux and macOS have not been runtime-tested. A fresh internet dependency installation was not tested.

Quick example

python game_asset_preflight.py "asset folder" --output "new report"

The output directory must not already exist, its parent must exist, and it must be outside the input. Use --help for thresholds and optional required channels. Exit codes: 0 PASS/WARN, 1 FAIL (or WARN with --fail-on-warn), 2 unresolved UNKNOWN without FAIL, invalid arguments or operational failure.

Limitations

FBX is inventory only: its texture and material dependencies are not parsed. Embedded glTF images, extensions and unsupported image formats are reported as UNKNOWN. This is not a full glTF conformance validator. No geometry, UV, material appearance, unused-asset or engine-import validation. LOD checks inspect names, not mesh quality. Unreadable, skipped or ambiguous checks remain visible as UNKNOWN; a PASS is limited to the implemented checks.

Try the reports first

The free sample contains two HTML reports and two JSON reports, no scanner. The clean synthetic demo scans 9 files with no findings. The deliberately broken demo reports 6 FAIL, 4 WARN and 5 UNKNOWN. Gallery images summarize those actual scan results; they are not engine or application screenshots.

For reproducible bugs on the documented setup, leave a comment with the command and error text, without private assets. Custom engine integrations and asset repair are outside this release.

More PREFLIGHT tools

UDIM Preflight checks declared texture tile sets. Sprite Sheet Preflight checks a declared PNG grid and reports cell indices.

Need all three workflows? See the current PREFLIGHT TOOLKIT bundle offer. Individual tools remain available separately.