📦 gltfpack

gltfpack is a tool that can automatically optimize glTF files to reduce the download size and improve loading and rendering speed.


You can download a pre-built binary for gltfpack on Releases page, or install npm package as follows:

npm install -g gltfpack


To convert a glTF file using gltfpack, run the command-line binary like this on an input .gltf/.glb/.obj file (run it without arguments for a list of options):

gltfpack -i scene.gltf -o scene.glb

gltfpack substantially changes the glTF data by optimizing the meshes for vertex fetch and transform cache, quantizing the geometry to reduce the memory consumption and size, merging meshes to reduce the draw call count, quantizing and resampling animations to reduce animation size and simplify playback, and pruning the node tree by removing or collapsing redundant nodes. It will also simplify the meshes when requested to do so.

By default gltfpack outputs regular .glb/.gltf files that have been optimized for GPU consumption using various cache optimizers and quantization. These files can be loaded by GLTF loaders that support KHR_mesh_quantization extension such as three.js (r111+) and Babylon.js (4.1+).

When using -c option, gltfpack outputs compressed .glb/.gltf files that use meshoptimizer codecs to reduce the download size further. Loading these files requires extending GLTF loaders with support for EXT_meshopt_compression extension; three.js supports it in r122+ (requires calling GLTFLoader.setMeshoptDecoder), Babylon.js supports it in 5.0+ without further setup. Plugins for older versions of three.js and Babylon.js are provided as well.

For better compression, you can use -cc option which applies additional compression; additionally make sure that your content delivery method is configured to use deflate (gzip) - meshoptimizer codecs are designed to produce output that can be compressed further with general purpose compressors.

gltfpack can also compress textures using Basis Universal format, either storing .basis images directly (-tb flag, supported by three.js) or using KTX2 container (-tc flag, requires support for KHR_texture_basisu). Compression is performed using basisu executable that must be available in PATH; alternatively the path to the executable can be specified via BASISU_PATH environment variable. Textures can also be embedded into .bin/.glb output using -te flag.


When using compressed files, js/meshopt_decoder.js or js/meshopt_decoder.module.js needs to be loaded to provide the WebAssembly decoder module like this:

import { MeshoptDecoder } from './meshopt_decoder.module.js';


var loader = new GLTFLoader();
loader.load('pirate.glb', function (gltf) { scene.add(gltf.scene); });

Note that meshopt_decoder assumes that WebAssembly is supported. This is the case for all modern browsers; if support for legacy browsers such as Internet Explorer 11 is desired, it’s recommended to use -cf flag when creating the glTF content. This will create and load fallback uncompressed buffers, but only on browsers that don’t support WebAssembly.


By default gltfpack makes certain assumptions when optimizing the scenes, for example meshes that belong to nodes that aren’t animated can be merged together, and has some defaults that represent a tradeoff between precision and size that are picked to fit most use cases. However, in some cases the resulting .gltf file needs to retain some way for the application to manipulate individual scene elements, and in other cases precision or size are more important to optimize for. gltfpack has a rich set of command line options to control various aspects of its behavior, with the full list available via gltfpack -h.

The following settings are frequently used to reduce the resulting data size:

The following settings are frequently used to restrict some optimizations:


gltfpack is available to anybody free of charge, under the terms of MIT License (see