Nodes/ComfyUI_agilly1989_motorway/Load3DAnimation_motorway_edition
ComfyUI Node

Load3DAnimation_motorway_edition

Load a 3D animation and render it frame-ready in the pipe

By agilly1989Β·Created 2 years agoΒ·Updated about a year agoΒ· 7
Load3DAnimation_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β–Ί

Load3DAnimation_motorway_edition is the animated sibling of Load3D. Where the plain node loads a static 3D model and renders it to a single image, this one targets animated GLTF/GLB files - the ones with keyframed motion built in - so you can turn a rigged scene into a sequence of rendered frames for your video-generation pipeline.

If you're doing video work in ComfyUI, the appeal is immediate: a real 3D scene gives you camera movement and object motion that's perfectly consistent frame to frame, and you feed those rendered frames to your img2vid or ControlNet setup instead of hoping the video model invents coherent motion. That's the whole modern "3D as a video scaffold" workflow, and this node is the pipe-native on-ramp for it. It has the same rendering controls as the static version, because a frame render is a frame render whether there's one or a hundred.

The wrapper

Same shape as Load3D_motorway_edition:

  • MOTORWAY πŸšŒπŸ’¨ - the pipe. Required.
  • INPUT_image_key (default image) - the input image for the render, pulled from the pipe.
  • model_file - dropdown of 3D files from ComfyUI/input/3d/ (.gltf, .glb, .obj, .fbx, .stl). Empty until you drop an animated model in there.
  • width, height (INT, 1–4096, default 1024) - render resolution.
  • material - enum: original, normal, wireframe, depth. normal/depth renders are the ones ControlNet actually likes.
  • up_direction - enum: original, -x, +x, -y, +y, -z, +z - rescues sideways-imported models.
  • OUTPUT_image_key (default image), OUTPUT_mask_key (default mask), OUTPUT_mesh_path_key (default mesh_path) - where the results land in the pipe.

The output port is the pipe itself; pull the rendered frames out with a Motorway AxB ramp when you want to feed a normal node.

Installing

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 pack-specific model downloads, but you need an animated 3D file in ComfyUI/input/3d/ and a ComfyUI version with the core 3D nodes - without those, the dropdown stays empty and the node has nothing to do.

Gotchas

  • Start the graph with MotorwayStart so there's a pipe.
  • Keys are exact strings; Key: 'image' doesn't exist in motorway means an upstream node stored the image under a different key.
  • Your ComfyUI build determines what this node can do - 3D support is newer core, and animated formats are the most demanding part of it.
  • Beta pack: "IF THINGS BREAK ITS BECAUSE I BROKE IT," per the author's README, and the clone set has been toggled off in some releases. If the node isn't in the menu after install, check the pack's current version.

Want camera motion that doesn't drift? Let the 3D file do the moving. This node is how that motion gets into your workflow without leaving the Motorway.

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 πŸšŒπŸ’¨β€”