# Aircraft source and build instructions

Aircraft and these modified assets are GPLv2; see `upstream/LICENSE` and original author credits in `upstream/README.md`.
Sources are pinned to Flightradar24/fr24-3d-models revision dd53267690c6a4ecbb290a3acf0284333a5d68a9.

Modified by Reckoned Force, LLC, October 3, 2026: converted glTF 1.0 GLBs to glTF 2.0 PBR materials with Cesium gltf-pipeline; centered origins using transformed mesh bounds; Draco mesh compression (16-bit position quantization). A few collapsed, zero-area mesh fragments (under 5 mm across, invisible; the import script logs each one) are dropped because the Draco encoder rejects them, as are tiny stray polygons (under 60 cm across, more than a metre from every other part, such as a white quad floating beside the 737's wing) that are attached to nothing. No mesh simplification or texture downsampling. Copyright notices are included under `upstream/`. Each model's preferred editable source archive is served under `source/`; pinned original GLBs are linked from the credits page. The local download cache is not part of the distributed site.

TracePlanes applies propeller and rotor rotation at runtime through named glTF node transforms. This does not modify the distributed GLB geometry; the application-side animation mapping is in `aircraft-model-animation.ts`.

To reproduce in the TracePlanes source checkout:

1. Install workspace dependencies with `pnpm install` (Node.js 22+).
2. Run `node apps/web/scripts/import-aircraft-models.mjs` from the repository root.
3. This creates models, a manifest and the complete source/notice collection in `apps/web/public/models/aircraft/fr24/`.

Standalone: place the provided script in `apps/web/scripts/`, install `gltf-pipeline@4.3.0` and `three@0.170.0` in `apps/web`, then run the script. It downloads the pinned upstream source automatically and reuses files already present. GPLv2 source downloads are free and do not require a TracePlanes account or subscription.
