Get3DComponents - ComfyUI Built-in Node Documentation

Get3DComponents parses a 3D model file (GLB, GLTF, OBJ, or STL) into an editable mesh that can be used by mesh-processing nodes such as decimate, remesh, UV unwrap, and bake.

Get3DComponents parses a 3D model file (GLB, GLTF, OBJ, or STL) into an editable mesh that can be used by mesh-processing nodes such as decimate, remesh, UV unwrap, and bake. All scene nodes and primitives are merged into one mesh with their transforms applied, and textures and material settings come from the first material. It is the counterpart of the MeshToFile3D node.

Inputs

Parameter	Description	Data Type	Required	Range
model_3d	3D model file from Load 3D or another 3D node. FBX/USDZ are not supported - convert to GLB first.	File3DGLB File3DGLTF File3DOBJ File3DSTL File3DAny	Yes	GLB GLTF OBJ STL

Note: FBX and USDZ files are not supported and cause an error; convert them to GLB or GLTF first. If the file format cannot be recognized as GLB, GLTF, OBJ, or STL, the node raises an error listing the supported formats. If the glTF scene contains no triangle geometry, or if the file contains face indices that point outside the vertex list (a sign of a corrupt file), the node raises an error. If the 3D file contains multiple materials, only the first material’s textures and material factors are kept (a warning is logged). All scene primitives are merged into a single mesh with their transforms applied. This node is experimental.

Outputs

Output Name	Description	Data Type
mesh	Editable mesh containing vertices, faces, UVs, vertex colors, normals, and tangents, plus material information taken from the file (texture, metallic-roughness, normal map, emissive color, unlit flag, occlusion-in-metallic-roughness flag, and material data).	MESH

This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! Edit on GitHub

---

Source fingerprint (SHA-256): f2cdc9767a50503988484f09d2b3d110caf086b8cd84f65034a4a1e17a94405e