Log inGet started
World

Builtin Library

Branchmain
Branchesmainpublish
Commit44fd9e59bd

README.md

Model Animation Importer

Handles animation-only model files (.glb / .gltf / .fbx that carry no mesh geometry). Extracts each animation clip to its own <base>.animation/<clip>.anim and removes the mesh-free source.

Defer-or-claim contract

A single model extension is claimed by both this importer and the model importer. The importer system runs claimants in registration order and stops at the first to return a non-nil result, so:

  • Mesh-bearing file → this importer return nil (defers) → the model importer builds the .bundle/.
  • Mesh-free file → this importer extracts clips, removes the source, and returns a result table (claims it).

A deferring importer must not move or remove the source, so the next claimant sees the same input.

Output

<base>.animation/
  <clip>.anim                      AnimAsset-format clip (one per animation)

Dispatch, origin-gating, content-gating, and re-entrancy live in the importer type's shared module (importer.assetType/shared.module).