GLTFUtility

Allows you to import and export glTF files during runtime and in editor. glTF is a new opensource 3d model transmission format which supports everything you'll ever need from a format in Unity. Read more about glTF here

What makes GLTFUtility different?

Focusing on simplicity and ease of use, GLTFUtility aims to be an import-and-forget solution, keeping consistency with built-in functionality.

Installation

Important notice

Features

System

• [x] Editor import
• [ ] Editor export
• [x] Runtime import API
• [ ] Runtime export API
• [x] GLTF format
• [x] GLB format
• [x] Multithreading
• [x] URP #75
• [ ] HDRP #73
• [ ] LWRP

Spec

• [x] Static mesh (with submeshes)
• [x] UVs (up to 8 channels)
• [x] Normals
• [x] Tangents
• [x] Vertex colors
• [x] Materials (metallic/specular, opaque/mask/blend)
• [x] Textures (embedded/external)
• [x] Remote textures (during async only)
• [x] Rig
• [ ] Avatar/Mask #70
• [x] Animations (multiple)
• [x] Morph targets (with experimental names)
• [x] Cameras

Extensions

• [x] KHR_texture_transform (partial support)
• [x] KHR_materials_pbrSpecularGlossiness
• [ ] KHR_lights_punctual #25
• [x] KHR_draco_mesh_compression #27 WARNING: Said to cause issues on WebGL.
• [x] KHR_mesh_quantization

Known issues

• ArgumentNullException: Value cannot be null in build but not in editor.
  • This is most likely due to shaders being stripped from the build. To fix this, add the GLTFUtility shaders to the Always Included Shaders list in Graphic Settings.
• Draco compression does not work on iOS and UWP
  • More info on #133

Runtime import API

// Single thread
using Siccity.GLTFUtility;

void ImportGLTF(string filepath) {
   GameObject result = Importer.LoadFromFile(filepath);
}

// Multithreaded
using Siccity.GLTFUtility;

void ImportGLTFAsync(string filepath) {
   Importer.ImportGLTFAsync(filepath, new ImportSettings(), OnFinishAsync);
}

void OnFinishAsync(GameObject result, AnimationClip[] animations) {
   Debug.Log("Finished importing " + result.name);
}

Important shader note

To ensure that Unity includes the GLTFUtility shaders in builds, you must add these shaders to the 'Always Included Shaders' list.

1. Open Edit -> Project Settings
2. Open Graphics
3. Scroll to Always Included Shaders
4. Under Size, increase the value by 4 and hit Enter.
5. In the Project panel, navigate to Packages/GLTFUtility/Materials/Built-in.
6. In this directory are 4 .shader files.
7. Drag and drop each of the 4 files into one of the 4 newly created rows in Always Included Shaders.