Nodes/ComfyUI_agilly1989_motorway/Load3D_motorway_edition
ComfyUI Node

Load3D_motorway_edition

Load a 3D model and render it to an image, all inside the pipe

By agilly1989Β·Created 2 years agoΒ·Updated about a year agoΒ· 7
Load3D_motorway_edition
  • MOTORWAY πŸšŒπŸ’¨
  • MOTORWAY πŸšŒπŸ’¨
β—„INPUT_image_keyimageβ–Ί
β—„model_fileβ–Ύβ–Ί
β—„width1024β–Ί
β—„height1024β–Ί
β—„materialβ–Ύβ–Ί
β—„up_directionβ–Ύβ–Ί
β—„OUTPUT_image_keyimageβ–Ί
β—„OUTPUT_mask_keymaskβ–Ί
β—„OUTPUT_mesh_path_keymesh_pathβ–Ί

ComfyUI grew real 3D support in 2025 - you can load a GLTF/GLB/OBJ/FBX/STL file and use it as a spatial reference for image or video generation. Load3D_motorway_edition is that core Load3D node, re-wrapped so it plays inside the Motorway pipe: it reads an input image from the pipe, renders the model, and stores the rendered image, a mask, and the mesh file path back into the pipe under keys.

So what does it actually give you? The render becomes an IMAGE you can feed into ControlNet or an img2img pass - which is the whole point of 3D-assisted generation: geometry as a strong pose/depth guide for the diffusion model. The mask output lets you composite the rendered subject over a background. And mesh_path is just a string pointing at the file, handy if a downstream node wants to re-reference the model. It's a niche but growing corner of ComfyUI, and this is the pipe-native way to bring a 3D model in.

The wrapper

  • MOTORWAY πŸšŒπŸ’¨ - the pipe. Required.
  • INPUT_image_key (default image) - where the input image lives in the pipe. The core node expects an image+mask bundle here; if your pipe entry is a plain image, make sure that's what the render needs.
  • model_file - dropdown of 3D files. Core looks in ComfyUI/input/3d/ (and subfolders) for .gltf, .glb, .obj, .fbx, .stl. The dropdown shows nothing until you drop a model in there.
  • width, height (INT, 1–4096, default 1024) - render resolution.
  • material - enum: original, normal, wireframe, depth. The last three render the geometry as a normal map, wireframe, or depth map - depth/normal are the ones you feed to ControlNet.
  • up_direction - enum: original, -x, +x, -y, +y, -z, +z. Sets which axis counts as "up" for the render; gets you out of trouble when a model imports sideways.
  • OUTPUT_image_key (default image), OUTPUT_mask_key (default mask), OUTPUT_mesh_path_key (default mesh_path) - where the results land.

The output port is the pipe; pull the rendered image back out with a Motorway AxB ramp when you want to hand it to a normal node.

Installing

It's part of the Motorway pack:

cd ComfyUI/custom_nodes
git clone https://github.com/agilly1989/ComfyUI_agilly1989_motorway
# restart ComfyUI

Or ComfyUI Manager β†’ search ComfyUI_agilly1989_motorway β†’ Install. No model downloads for the pack itself. You do need a 3D file in ComfyUI/input/3d/, and this only works if your ComfyUI version includes the core 3D nodes - check that first if the dropdown stays empty.

Gotchas

  • Start the graph with MotorwayStart so there's a pipe.
  • Keys are exact strings - Key: 'image' doesn't exist in motorway means nothing upstream stored that key.
  • The model_file dropdown pulls from core's 3D folder, and the node is only as capable as your ComfyUI's 3D support.
  • Beta pack: author's README says "IF THINGS BREAK ITS BECAUSE I BROKE IT," and generated clones have been toggled off in some releases. Missing node after install = beta, not you.

3D-assisted generation is one of those features people either build whole workflows around or never touch. If you're in the first camp, this is how you get your model into the pipe.

Categoryagilly1989 Nodes/Motorway-ed/3d

Inputs (10)

NameTypeDefaultDescription
MOTORWAY πŸšŒπŸ’¨MOTORWAY πŸšŒπŸ’¨β€”
INPUT_image_keySTRINGimageβ€”
model_fileCOMBO0 options:
widthINT10241–4096β€”
heightINT10241–4096β€”
materialCOMBO4 options: original, normal, wireframe, depth
up_directionCOMBO7 options: original, -x, +x, -y, +y, -z, +1
OUTPUT_image_keySTRINGimageβ€”
OUTPUT_mask_keySTRINGmaskβ€”
OUTPUT_mesh_path_keySTRINGmesh_pathβ€”

Outputs (1)

NameTypeDescription
MOTORWAY πŸšŒπŸ’¨MOTORWAY πŸšŒπŸ’¨β€”