ComfyUI Node

Load3DFile

Load3DFile is a path that cosplays as a loader

By nsdtcloud3d·Created 2 years ago·Updated 2 years ago· 21
Load3DFile
    • file_path
    file_path

    Let's not bury the lede: Load3DFile doesn't load anything. Open the source and the whole node is one return (file_path,). It takes a path string, prints it to the console, and hands it back unchanged. There's no file browser, no mesh parsing, no 3D preview - the code literally has a TODO check file type comment where the validation would go.

    So why does it exist? It's a pass-through that gives your workflow a clean, labeled input port. When you wire up the ConvertTo3DFormat node (the pack's real workhorse), you need a file_path string, and you have two options: hardcode the path into a primitive, or route it through this node so someone reading the graph can see "here's where the 3D file goes in." For a node graph, that's a genuinely useful bit of organization even if the node itself is a no-op. It also fits the pack's pattern of small, single-purpose nodes - the sibling Load3DConvertAPIKEY does exactly the same trick for your API key.

    What you set

    One required input:

    • file_path - the absolute path to your 3D file, pasted in as a multiline string. Something like C:\Users\you\ComfyUI\output\tripo_pbr_model_1234.glb on Windows or /home/you/ComfyUI/output/model.glb on Linux.

    The output, also called file_path, is that same string, ready to plug into ConvertTo3DFormat's file_path input.

    The honest advice

    If you just want to convert a file, you can skip this node entirely and feed ConvertTo3DFormat directly from a string primitive or a Save-node output. Reach for Load3DFile when you want the workflow to look deliberate - and be aware it won't stop you from typing a path that doesn't exist. It won't validate anything; the failure just shows up later in the convert node.

    This pack is a light install (its entire requirements.txt is Requests), so you can grab it either from ComfyUI Manager by searching "ComfyUI-3D-Convert" or manually:

    cd ComfyUI/custom_nodes
    git clone https://github.com/nsdtcloud3d/ComfyUI-3D-Convert
    

    Then restart ComfyUI. If you actually want a file picker UI for choosing 3D models - a real loader with a browser and preview - you're better off with ComfyUI-3D-Pack's input nodes. This one is for the purists who like their paths explicit.

    Category3DConvert

    Inputs (1)

    NameTypeDefaultDescription
    file_pathSTRING

    Outputs (1)

    NameTypeDescription
    file_pathSTRING