Object Pointcloud Add

Object Pointcloud Add is what you get when a pack wraps every Blender operator instead of just the useful ones. It calls bpy.ops.object.pointcloud_add, which drops a new empty point cloud object into the headless Blender scene. Point clouds were still an experimental data type in Blender 3.6, and honestly, in the avatar rig pipeline you'll almost never need one.

So when would you reach for it? Mostly as a placeholder or an anchor. If you're building a graph that scatters instances or needs a dedicated empty to parent things to, a point cloud object works as well as an empty for that. Otherwise it's a curiosity - the pack generated a node for it because the operator exists, not because the avatar workflow needs it.

What it actually does

It creates a new point cloud object in the scene at a transform you specify. The inputs:

• BPY_OBJ - an optional object to chain from (the new object becomes active).
• align - how the new object orients itself: WORLD, VIEW, or CURSOR. In a headless run there's no real viewport, so WORLD is the sane default.
• location, rotation, scale - the usual B_VECTOR3 triplets (X/Y/Z) for where and how big the new object is.

Output is a single BPY_OBJ, the freshly created point cloud, so you can wire it into whatever comes next.

The pack context

Like the rest of the Object_* family here, this is a thin auto-generated wrapper. The pack's ops_mesh.py walks Blender's operator lists and builds a node class per operator, and the input schema is generated from the operator's own signature (stored in input_types.txt). That's why the node names read like Blender menu items. It's clever, but it means a lot of these nodes are "free" surface area rather than curated tools.

Installing it

Same pack as everything else: ComfyUI Manager → search "Avatar Graph" → install, or:

cd ComfyUI/custom_nodes
git clone https://github.com/avatechai/avatar-graph-comfyui
cd avatar-graph-comfyui
python -m pip install -r requirements.txt

Restart after. Note the stack is heavy: bpy==3.6.0 pins you to Python 3.10, and the pack auto-downloads a big SAM checkpoint plus mediapipe models on first import. If you only want to poke at the object utilities and skip the avatar export, you still get the downloads - the pack's __init__.py fires them at import time.

Honest verdict: skip this one unless you specifically need a throwaway point cloud object. In a graph full of genuinely useful selection and transform nodes, this is the one that exists for completeness.