Siccity / Gltfutility

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

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

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.

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) {
   Debug.Log("Finished importing " + result.name);
}