Model 3D
Load 3D model files: OBJ, GLTF, FBX, STL, or PLY.
What it does
Model 3D loads a 3D model file from disk (OBJ, glTF/GLB, FBX, STL, or PLY) as geometry that transforms, shades and renders like any other shape. Point-cloud files, a PLY without faces, come in as points instead, each carrying its own colour, and the node reports which kind it loaded.
It also reports mesh and vertex/triangle counts, mesh names and bounding-box size, and pulls out the first albedo texture as an image for reuse in a 2D compositing chain.
When to use it
A model made elsewhere (a scanned asset, an exported character, a CAD part, a point-cloud scan) rather than one built from primitives
One specific sub-mesh out of a multi-mesh file, by name or by index
A point cloud (PLY), with control over how many points come in and how they are drawn
The model's albedo texture as a standalone image, separate from the 3D surface
| Parameter | Type | Default |
|---|---|---|
file_path | String | "String::new()" |
position | Vec3 | (0, 0, 0) |
rotation | Vec3 | (0, 0, 0) |
scale | Number | 1 |
up_axis | String | "Auto" |
unit_scale | String | "Auto" |
recompute_normals | Boolean | true |
flip_faces | Boolean | false |
weld_vertices | Boolean | true |
weld_epsilon | Number | 0.000 |
preserve_hierarchy | Boolean | false |
clip | String | "" |
time_mode | String | "Scene Time" |
time | Number | 0 |
loop_mode | String | "Loop" |
mesh_selection | String | "All" |
mesh_name | String | "" |
mesh_index | Number | 0 |
point_size | Number | 2 |
point_shape | String | "Disc" |
max_points | Number | 0 |
subsample | Number | 1 |
opacity | Number | 1 |
Gotchas
Mesh Name only takes effect when Mesh Selection is "By Name", and Mesh Index only when it is "By Index". The other field stays visible and is ignored.
The Point Cloud group (Point Size, Point Shape, Max Points, Subsample) only applies to files that load as point clouds, a PLY with no faces. On a mesh file these controls have nothing to affect.
For an imported mesh showing back faces or lit wrong, try Flip Faces, which reverses the winding order some exporters get backwards.
Weld Vertices merges duplicate vertices within Weld Epsilon of each other. Turn it off if a model relies on genuinely separate coincident vertices, such as hard edges and UV seams, which welding can smooth away.
Worked example
Add a Model 3D node and pick your file (OBJ, glTF/GLB, FBX, STL, or PLY).
Leave Up Axis and Unit Scale on Auto first; override them only if the model comes in rotated or at the wrong scale.
If the file has more than one mesh, set Mesh Selection to By Name or By Index and pick the one you want.
Check the Bounds and Vertex/Triangle Count outputs to confirm what loaded, then wire Geometry onward into the rest of your scene.