NOTE: It's recommended to switch to Unity glTFast, a fork of this package that is developed and supported by Unity. Consult the upgrade guide for details.
glTFast enables use of glTF™ (GL Transmission Format) asset files in Unity®.
It focuses on speed, memory efficiency and a small build footprint while also providing:
- 100% glTF 2.0 specification compliance
- Ease of use
- Robustness and Stability
- Customization and extensibility for advanced users
glTFast supports the full glTF 2.0 specification and many extensions. It works with Universal, High Definition and the Built-In Render Pipelines on all platforms.
See the comprehensive list of supported features and extensions.
There are four use-cases for glTF within Unity
- Import
- Runtime Import/Loading in games/applications
- Editor Import (i.e. import assets at design-time)
- Export
- Runtime Export (save and share dynamic, user-generated 3D content)
- Editor Export (Unity as glTF authoring tool)
Read more about the workflows in the documentation.
NOTE: Consider switching to Unity glTFast, a fork of this package that is developed and supported by Unity. Consult the upgrade guide for details.
Installation instruction for the original glTFast.
You can load a glTF asset from an URL or a file path.
Add a GltfAsset component to a GameObject.
var gltf = gameObject.AddComponent<GLTFast.GltfAsset>();
gltf.url = "https://raw.githubusercontent.com/KhronosGroup/glTF-Sample-Models/master/2.0/Duck/glTF/Duck.gltf";See Runtime Loading via Script in the documentation for more details and instructions how to customize the loading behavior via script.
Move or copy glTF files into your project's Assets folder, similar to other 3D formats:
Unity glTFast will import them to native Unity prefabs and add them to the asset database.
See Editor Import in the documentation for details.
The main menu has a couple of entries for glTF export under File > Export and glTFs can also be
created via script.
❗ IMPORTANT ❗
Unity glTFast uses custom shader graphs that you have to include in builds in order to make materials work. If materials are fine in the Unity Editor but not in builds, chances are some shaders (or variants) are missing.
Read the section Materials and Shader Variants in the Documentation for details.
See CONTRIBUTING.md.
Copyright 2023 Unity Technologies and the Unity glTFast authors
Licensed under the Apache License, Version 2.0 (the "License"); you may not use files in this repository except in compliance with the License. You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
Unity® is a registered trademark of Unity Technologies.
Khronos® is a registered trademark and glTF™ is a trademark of The Khronos Group Inc.
