PROPSMITH

How to import a GLB into Godot 4 (with collisions)

Published

In short

Copy the .glb into your project folder: Godot 4 imports glTF natively, with no plugin. Double-click the file in the FileSystem dock to open Advanced Import Settings, select a mesh, tick Physics, pick a Body Type and a Shape Type (Trimesh for static level pieces, Single Convex or Box for props), click Reimport, then drag the file into your scene. Godot and glTF both use metres, so the model arrives at its real size.

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.

Free to download as GLB with a Propsmith account. A box, two round props, a staircase for trimesh collision, and a door and chest whose suggested animations you can build for 3 credits.

Step 1: import the GLB

  1. 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 .import file next to it. Commit both to version control.
  2. 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.
  3. Click Reimport after changing anything. Settings are saved in the .import file, so they survive when you replace the .glb with a new version.
Import dock settingDefaultFor a prop
Root TypeNode3DSet to StaticBody3D or RigidBody3D if the whole prop should be one physics body (see below)
Root Scale1.0Leave at 1.0. Change it only to resize on purpose; Apply Root Scale (on) bakes it into the meshes
Meshes › Generate LODsOnLeave on: Godot builds lower-detail versions for distance rendering
Meshes › Light BakingStaticStatic Lightmaps if you bake with LightmapGI (it also generates the second UV set)
Animation › ImportOnLeave 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.

  1. In the Scene tab on the left, expand the tree and click a mesh node.
  2. 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.
  3. Set Physics › Body Type: StaticBody3D for things that never move, RigidBody3D for things that fall and get pushed, Area3D for triggers.
  4. Pick a Shape Type (table below), then click Reimport.
Shape TypeWhat it makesUse it for
Automatic (default)Trimesh on a static body, Decompose Convex on a rigid bodyA quick start; check the result in the preview
TrimeshExact, triangle-for-triangle shape. Static bodies onlyFloors, stairs, bridges: the staircase (12,684 triangles)
Single ConvexOne hull wrapped around the mesh like shrink filmBarrels, rocks, cones, anything that moves
Decompose ConvexSeveral convex hulls. Precision 1–10 (default 5)Concave props that must move; keep Precision low
Box, Sphere, Cylinder, CapsuleA 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.

Questions people ask

Does Godot 4 need a plugin to import GLB files?

No. glTF 2.0 is built in and is the format Godot’s docs recommend. Both .gltf and .glb work: copy the file into the project and Godot imports it as a scene.

How do I add collision to an imported GLB in Godot?

Double-click the .glb in the FileSystem dock, select a mesh in Advanced Import Settings, tick Generate › Physics, choose a Body Type and Shape Type and click Reimport. You can also rename a mesh with a -col or -colonly suffix before export.

Should I use trimesh or convex collision in Godot?

Trimesh is exact to the triangle but works only on static bodies, so use it for floors, stairs and bridges. Use Single Convex, a primitive shape or Decompose Convex for anything that moves.

Why is my GLB the wrong size in Godot?

Godot uses 1 unit = 1 metre, the same as glTF, so a file saved at real size imports at real size. Check that Root Scale in the Import dock is 1.0 and that the tool that wrote the file used metres.

How do I make an imported animation loop in Godot?

Godot’s glTF importer loops any animation whose name starts or ends with “loop” or “cycle”. For other names, select the animation in Advanced Import Settings and set Loop Mode to Linear.

Sources

Checked 1 November 2026.