Mesh Polybuild Face At Cursor Move

This is the macro version of Mesh_PolybuildFaceAtCursor: in Blender, it adds a new face where your mouse is, then immediately lets you drag that face's new vertex into position before you release the click. The "Move" suffix on a Blender operator name is a reliable tell that two actions got chained into one interactive gesture.

What it is and why you'd reach for it

It's not part of Avatar Graph's documented rigging pipeline (Create Mesh Layer → Modify Shape Key → Create Shape Flow → Avatar Main Output) - it belongs to the long tail this pack generates by auto-wrapping essentially every operator under Blender's bpy.ops.mesh namespace, which the README's generate_blender_types.py script keeps in sync. The interactive version needs your mouse position twice - once to place the new face, once to drag it - and this node's schema exposes neither. It's just BPY_OBJ in, BPY_OBJ out, no cursor, no move delta, nothing else. Worth knowing before you wire this into a graph expecting a specific, controllable result.

How it works

It's Mesh_PolybuildFaceAtCursor's face-add step immediately followed by a translate on the new geometry - the same "create, then adjust" pattern you see across all the *Move-suffixed Polybuild nodes in this pack.

The inputs and outputs that matter

Nothing beyond the mesh itself. No create_quads, no proportional editing options, no mirror flag - this node has the barest schema of the whole Polybuild family, which tracks with it being purely a macro wrapper with no independently exposed settings.

How to install it

ComfyUI Manager: search Avatar Graph, install, restart. Or manually:

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

This pack depends on bpy, Blender shipped as a pip package, and bpy only publishes wheels for specific Python minor versions - the README is direct about it, you need Python 3.10.x. Windows users get a bundled embedded-Python-3.10 zip built for exactly this reason; macOS/Linux users should pin a conda create --name comfyui python=3.10 environment before installing anything. Launch with --enable-cors-header (--force-fp16 on Mac too) if you want the live avatar preview panel; without it, the graph still works, you just lose the real-time viewer.

Common issues

Don't expect this node to place a face somewhere specific and then move it to somewhere else specific - with no cursor or move-delta input, both halves of the macro fall back to whatever default the underlying Blender operator resolves to, which won't be repeatable in any meaningful sense. If your graph genuinely needs "add a face, then position it," build that from two separate, explicit steps instead of this cursor-driven combo. As with every node in this pack: a bpy install failure is nearly always a Python-version mismatch, not a broken dependency - check python --version first.