Before you start
This guide uses Godot 4.7, the current stable release as of November 2026 (4.7.2, released 18 August 2026). Menu names are from 4.7; recent 4.x releases are close. Godot reads glTF 2.0 natively and its docs list it as the recommended 3D format, so there’s nothing to install.
Godot and glTF agree on the basics: Y is up, and 1 unit is 1 metre. A file made at real size comes in at real size with no conversion. If you’re not sure what a GLB holds, read what a GLB file is first.
The examples use models from the public prop library made with Propsmith, an AI 3D prop generator. Its GLBs are typical of hand-built game props: each part is a separate named mesh, materials are flat colours with roughness and metalness (no image textures), and sizes are in metres. That means more nodes than you might expect: the wooden crate is 4,052 triangles spread over 129 meshes.
Wooden crate4,052 triangles
Wooden barrel8,664 triangles
Traffic cone2,028 triangles
Staircase12,684 triangles
Wooden door5,584 triangles
Treasure chest11,852 triangles
Step 1: import the GLB
- Copy the file into the project. Drag the .glb from your file manager onto the FileSystem dock, or save it anywhere under the project folder (for example
res://models/). Godot imports it at once and writes a.importfile next to it. Commit both to version control. - Select it in the FileSystem dock. The Import dock (a tab next to Scene) shows the scene import options. The defaults suit most props; the ones worth knowing are in the table below.
- Click Reimport after changing anything. Settings are saved in the
.importfile, so they survive when you replace the .glb with a new version.
| Import dock setting | Default | For a prop |
|---|---|---|
| Root Type | Node3D | Set to StaticBody3D or RigidBody3D if the whole prop should be one physics body (see below) |
| Root Scale | 1.0 | Leave at 1.0. Change it only to resize on purpose; Apply Root Scale (on) bakes it into the meshes |
| Meshes › Generate LODs | On | Leave on: Godot builds lower-detail versions for distance rendering |
| Meshes › Light Baking | Static | Static Lightmaps if you bake with LightmapGI (it also generates the second UV set) |
| Animation › Import | On | Leave on for animated files. FPS defaults to 30 |
Step 2: add collisions in Advanced Import Settings
Collision shapes can be generated at import time, so they come back every time you reimport. Open the Advanced Import Settings window by double-clicking the .glb in the FileSystem dock, or with the Advanced… button at the bottom of the Import dock.
- In the Scene tab on the left, expand the tree and click a mesh node.
- Tick Generate › Physics. On import, Godot puts a physics body above the mesh and adds the collision shape beside it. The 3D preview draws the shape over the model.
- Set Physics › Body Type: StaticBody3D for things that never move, RigidBody3D for things that fall and get pushed, Area3D for triggers.
- Pick a Shape Type (table below), then click Reimport.
| Shape Type | What it makes | Use it for |
|---|---|---|
| Automatic (default) | Trimesh on a static body, Decompose Convex on a rigid body | A quick start; check the result in the preview |
| Trimesh | Exact, triangle-for-triangle shape. Static bodies only | Floors, stairs, bridges: the staircase (12,684 triangles) |
| Single Convex | One hull wrapped around the mesh like shrink film | Barrels, rocks, cones, anything that moves |
| Decompose Convex | Several convex hulls. Precision 1–10 (default 5) | Concave props that must move; keep Precision low |
| Box, Sphere, Cylinder, Capsule | A primitive you size yourself (Box starts at 2 × 2 × 2 m) | The cheapest option for boxy or round props |
One collider for the whole prop
For a crate or a barrel, one box or cylinder around everything is often best. Set Root Type to StaticBody3D (or RigidBody3D) in the Import dock and reimport. Then right-click the .glb and choose New Inherited Scene, add a CollisionShape3D under the root, give it a BoxShape3D sized from the model page, and save the scene as a .tscn. Instance that scene in your levels. In an inherited scene you can also select any mesh and use the viewport’s Mesh › Create Collision Shape… menu, which offers Trimesh, Single Convex, Simplified Convex, Multiple Convex, Bounding Box and primitive shapes.
The -col and -colonly suffixes
If you edit the model before export, you can name meshes so Godot builds collision by itself. Suffixes are not case-sensitive and can follow a -, _ or $:
- -col keeps the mesh and adds a static trimesh collider (ConcavePolygonShape3D). Godot’s docs call it accurate but slow, meant for level geometry.
- -convcol does the same with a convex shape, for simple or moving objects.
- -colonly removes the mesh and keeps only a StaticBody3D collider. Model a rough box, name it
collider-colonly, and it becomes an invisible custom collider. - -convcolonly is the convex version of -colonly.
- -rigid imports the mesh as a RigidBody3D, and -noimp skips the node.
Renaming takes a trip through Blender: see how to edit a GLB in Blender.
Step 3: check the materials
Each glTF material becomes a StandardMaterial3D with the file’s base colour, metallic and roughness values. Flat-colour models come through as they are, with no textures to relink. To change a material, open Advanced Import Settings, choose Actions… › Extract Materials and pick a folder. Godot saves each material as a .tres file and the scene uses those from then on; reimporting doesn’t overwrite your edits.
If the model looks dark in a running game but fine in the editor, the scene has no light of its own. The editor’s preview sun and environment don’t ship with the game, so add a DirectionalLight3D and a WorldEnvironment.
Step 4: animations
An animated GLB imports with an AnimationPlayer node holding its clips. Propsmith’s animated downloads carry one clip named loop or once, baked at 30 frames per second, which matches Godot’s default import FPS. Godot’s glTF importer turns looping on for any animation whose name starts or ends with “loop” (or “cycle”), so a loop clip repeats with no setup and a once clip plays once and stops.
To change that, select the animation in Advanced Import Settings and set Settings › Loop Mode to None, Linear or Pingpong. To play it, toggle Autoplay on Load in the Animation panel, or call it from a script on the root of your inherited scene: $AnimationPlayer.play("once").
Library models list a suggested animation, such as the crate’s lid lifting and tipping aside. Building it costs 3 credits; the animated GLB download appears once it exists.
Step 5: instance it in a scene
Drag the .glb (or your inherited .tscn) from the FileSystem dock into the 3D viewport or onto a node in the Scene tree. Godot adds it as an instance, so every copy updates when you reimport. You can’t change the nodes inside an instanced import directly: to add scripts, colliders or extra nodes, work in an inherited scene. Godot’s docs list its two limits: you can’t delete nodes that come from the file, and you can’t edit its sub-resources unless you save them externally.
Troubleshooting
- Objects fall through the prop. Turn on Debug › Visible Collision Shapes and run the scene. Often the collider was generated on a small part instead of the body.
- The import fails on a compressed file. Godot 4.7’s glTF importer doesn’t support Draco mesh compression. Re-export from Blender with Draco turned off.
- Dozens of nodes in the tree. That’s one node per mesh in the file. Leave it, or join the parts in Blender if you don’t need them separate (keep moving parts separate if the model is animated).
- Physics is slow. Swap Decompose Convex at high precision for a primitive or Single Convex, and keep Trimesh for static geometry.
More props to test with: the containers and storage and building parts hubs, or the whole public prop library. The same files go into Unity, Unreal Engine 5 and Roblox Studio.