Before you start
This guide uses Unity 6.3 LTS, the current long-term support release (supported until December 2027), and works the same on Unity 6.6, the newest release as of November 2026. You need Unity glTFast, Unity’s own glTF package. Version 6.20.0 came out on 25 August 2026 and needs Unity 6.0 or newer.
No scale conversion is needed. glTF stores distances in metres, and Unity’s own manual says its physics system expects 1 unit to be 1 metre. If GLB is new to you, read what a GLB file is.
The examples use models from the public prop library made with Propsmith, an AI 3D prop generator. Its GLBs have separate named meshes for each part, flat-colour materials with roughness and metalness (no image textures), and real sizes in metres. The office desk is 2,952 triangles over 48 meshes, so it arrives as a parent object with 48 children.
Cardboard box1,912 triangles
Wooden chair2,952 triangles
Office desk2,952 triangles
Laptop2,970 triangles
Park bench5,972 triangles
Street lamp13,448 triangles
Step 1: install glTFast
- Open Window › Package Management › Package Manager.
- Click the + (install) button in the toolbar and choose Install package by name. Newer editors label it Install package by technical name….
- Enter
com.unity.cloud.gltfastas the name. Leave the version empty to get the latest compatible release, or type6.20.0to pin it. - Click Install. Burst, Collections and Mathematics come with it as dependencies.
Step 2: import the GLB
- Drag the .glb into the Project window (or copy it into the
Assetsfolder on disk). glTFast turns it into a prefab-like asset. Expand it to see its Scenes, Meshes, Materials and AnimationClips. - Select it to see its import settings in the Inspector: Animation (None, Legacy or Mecanim), Generate Lightmap UVs, and advanced options for node names, textures and which components to create. Any warnings from the import show here too. Click Apply after a change.
- Drag the asset into the Scene view or Hierarchy. Each part becomes a child GameObject with a MeshFilter and MeshRenderer, named as in the file.
Materials in URP, HDRP and Built-in
glTFast supports all three render pipelines. It makes materials with its own shaders: Shader Graphs for URP and HDRP, and shaders for the Built-in pipeline, chosen by the pipeline active when the file is imported. If you switch pipelines later, right-click the .glb and choose Reimport so the materials are rebuilt. Flat-colour models need nothing else: base colour, metallic and roughness come straight from the file.
Imported materials are read-only parts of the .glb. To change one, select it inside the asset, press Ctrl+D (Cmd+D on a Mac) to make an editable copy, and assign the copy in the MeshRenderer of your prefab. You can also drop in your own URP Lit material.
All of this applies to editor import. If you load GLBs at runtime instead, the glTFast shaders have to be in the build: missing ones render solid magenta. The glTFast Project Setup page explains how to include them.
Step 3: add colliders
glTFast doesn’t create colliders. Add them to your scene instance (later saved as a prefab):
| Collider | How | Use it for |
|---|---|---|
| Box Collider on the root | On a root with no mesh of its own the box starts at 1 × 1 × 1. Set Size from the model page and adjust Center | Crates, desks, boxes: the fastest and most stable |
| Several primitives | Child objects with Box, Sphere or Capsule Colliders | Chairs, benches, lamps: a rough outline in a few shapes |
| Mesh Collider, Convex on | On a part’s GameObject; Unity builds one hull of up to 255 triangles | Moving props with irregular outlines |
| Mesh Collider, Convex off | On a part’s GameObject; uses the full mesh | Static floors and stairs. Concave colliders can only be static or kinematic |
Every library model page lists the real size in metres, width × height × depth, which maps straight onto a Box Collider’s X, Y and Z. The cardboard box is 0.4 × 0.3 × 0.3. Click Edit Collider to drag the box faces until the green outline meets the mesh. For a prop that falls and gets pushed, add a Rigidbody to the root as well.
Step 4: save it as a prefab
Drag the finished object from the Hierarchy into a folder in the Project window. Unity asks what to create:
- Prefab Variant keeps the link to the .glb. Your colliders and material swaps are stored as overrides, and a reimported model still flows through. Pick this for models you might update.
- Original Prefab makes a standalone prefab with no link back to the file.
Place the prefab, not the .glb, from then on. For props that never move, tick Static on the prefab so Unity can batch their many small meshes.
Step 5: animation, Mecanim or Legacy
Propsmith’s animated downloads carry one clip, named loop or once, that moves whole parts rather than bones. Library models list a suggested animation (the desk’s top drawer sliding open, for example) that you can build for 3 credits; the animated GLB appears once it exists.
For files dragged into the editor, glTFast sets the Animation setting to Mecanim and marks every clip Loop Time. It adds an Animator to the root but no controller. glTFast’s docs put it plainly: the clips “won’t be assigned and cannot be played back without further work”. You have two ways forward.
Mecanim (Animator)
- Choose Assets › Create › Animation › Animator Controller.
- Open it in the Animator window and drag the clip from inside the .glb onto the graph.
- Assign the controller to the Animator on your prefab’s root.
- For a
onceclip, select it inside the .glb, press Ctrl+D to copy it, untick Loop Time on the copy, and use the copy in the controller.
Legacy (Animation component)
Set Animation to Legacy and click Apply. The root gets an Animation component with the clip assigned and Play Automatically on, so it plays once when the scene starts. For a looping clip, set its wrap mode in a script: GetComponent<Animation>()["loop"].wrapMode = WrapMode.Loop;. For a prop with one clip, Legacy is less setup.
Troubleshooting
- Magenta materials. The shader is missing: reimport after a pipeline change, or for runtime loading add the glTFast shaders to the build.
- Wrong size. Check the root’s Transform scale is 1. Compare with the size on the model page; the street lamp should stand 5.01 units tall.
- Convex collider looks rough. Convex Mesh Colliders are capped at 255 triangles. Use a few primitives instead.
- Too many objects. Mark static props Static, or join the parts in Blender before import (see how to edit a GLB in Blender).
More test props: the furniture and street and city props hubs, or the modern genre. The same GLBs work in Godot 4, Unreal Engine 5 and, with the Roblox download, Roblox Studio.