UnityGLTF

Unity3D library for importing and exporting glTF 2.0 assets.

	Editor	Runtime
Import	✅	✅
Export	✅	✅

UnityGLTF doesn't have any native dependencies (pure C#) and thus works on all platforms that Unity supports. This includes WebGL import and export.

The library is designed to be easy to extend with additional extensions to the glTF specification. Both import and export allow attaching custom plugins and callbacks and can be heavily modified to fit into specific pipelines. Many glTF extensions are supported.

Contents

• Installation
• Unity Version and Render Pipeline Compatibility
• UnityGLTF and glTFast
• Supported Features and Extensions
  • Import and Export
  • Import only
  • Export only
• glTF Interactivity
  • Visual Scripting Graph Exporter
  • Features
  • Unsupported
  • Viewer support
• glTF Materials
  • Material Conversions
  • Material and Shader Export Compatibility
  • Configure for Refractive Materials (Transmission and Volume)
    • Material Setup
    • URP
    • Built-In
    • HDRP
• Exporting glTF Files
  • Testing, debugging, compatibility
• Animation Export
  • Animator Controller
  • GLTFRecorder API
  • Timeline Recorder
  • Legacy Animation Component
  • KHR_animation_pointer support
• Blend Shape Export
• Importing glTF files
  • Runtime Import
    • Load via Gltf Component
    • Load via code example:
  • Ensure shaders are available in your build
  • Editor Import
  • Default Importer Selection
• Animation Import
• Extensibility
  • Example for custom export plugin
  • Example for custom import plugin
• Known Issues
• Contributing
  • Unity Package
  • GLTFSerializer
  • Tests

Installation

You can install this package from the Needle Package Registry with a one-click installer:

1. Download UnityGLTF Package Installer
2. Drop the downloaded .unitypackage into Unity and follow the steps.

You can also install this package from git, compatible with UPM (Unity Package Manager).

1. Open Window > Package Manager
2. Click +
3. Select Add Package from git URL
4. Paste

   https://github.com/KhronosGroup/UnityGLTF.git
   

5. Click Add.

Note: If you want to target a specific version, append #release/<some-tag> or a specific commit to the URL above. Example: https://github.com/KhronosGroup/UnityGLTF.git#release/2.14.1.

Unity Version and Render Pipeline Compatibility

Please use Long-Term Support versions of Unity (2021.3+, 2022.3+, 6000.0+).

Recommended:

• Unity 2021.3+, Unity 2022.3+, Unity 6+
• Linear colorspace
• Universal Render Pipeline (URP) and Built-In Render Pipeline (BiRP)

HDRP:

• Currently limited functionality.

Legacy:

• When using Unity 2020.3, please use an older version of UnityGLTF, like 2.9.1-rc and before.

Note: Issues on non-LTS Unity versions (not on 2021.3, 2022.3, 6000.0...) will most likely not be addressed. Please use LTS (Long-Term Support) versions where possible.

UnityGLTF and glTFast

A separate glTF implementation for Unity, glTFast, is available from the Unity Registry.
glTFast being supported by Unity means, in a nutshell, that it sticks to standards pretty strictly and can't easily ship non-ratified extensions or experimental features that work for the majority, but not all, of users.

• UnityGLTF aims to be the more flexible framework, with extensive import/export plugin support and useful plugins out of the box.
• glTFast aims to be the more performant framework, with a focus on leveraging Unity-specific features such as Burst and Jobs.
• UnityGLTF has a versatile plugin/extension infrastructure. This allows for a lot of flexibility during import/export.
• UnityGLTF enables the use of and ships with non-ratified extensions such as KHR_animation_pointer, KHR_audio, and KHR_materials_variants.
• glTFast leverages Unity-specific features such as Burst and Jobs and thus can have better performance in some cases.
• glTFast has better HDRP support.

This is the beginning of the README. Read the rest at the original. Read the full README ↗