threejs-agents-model-optimizer

Run the gltf-transform pipeline in order: dedup, flatten, join, weld, simplify, then apply KTX2 texture compression and Draco mesh compression. A single command like npx gltf-transform optimize input.glb output.glb --compress draco --texture-compress ktx2 handles most cases.

Draco and meshopt are mutually exclusive GLTF mesh compression formats using different extensions. Draco via gltf-transform suits scripted pipelines, while gltfpack provides fast one-shot meshopt compression. Never apply both to the same file.

Use ETC1S for color, emissive, and ORM maps, especially on mobile where UASTC consumes 8-16 bytes per texel of VRAM. Always use UASTC for normal maps because ETC1S introduces block artifacts that cause visible lighting errors.

GLTFLoader does not include the Draco WASM decoder by default. You must create a DRACOLoader, call setDecoderPath with the decoder files, and attach it via gltfLoader.setDRACOLoader before loading.

Run gltf-transform simplify at decreasing ratios such as 1.0, 0.5, 0.25, and 0.10 to produce LOD0 through LOD3. Then add each mesh to a THREE.LOD object with increasing distances and call lod.update(camera) in the render loop.

Avoid the join step when meshes have independent animations or need separate interaction, because joining merges them into a single mesh and destroys per-part animation targets. Use dedup, flatten, and weld instead.