Nodes/Avatar Graph/Mesh Polybuild Transform At Cursor Move
ComfyUI Node

Mesh Polybuild Transform At Cursor Move

Grab-and-drag, minus the drag

By avatechai·Created 3 years ago·Updated 2 years ago· 264
Mesh Polybuild Transform At Cursor Move
  • BPY_OBJ
  • BPY_OBJ

This is the full interactive gesture behind Blender's Poly Build tool: click near a vertex or edge to grab whichever one is closest, then drag it wherever you want before releasing. It's the macro version of Mesh_PolybuildTransformAtCursor - grab plus move, fused into one click-and-drag.

What it is and why you'd reach for it

Like the rest of the Polybuild family in this pack, it's not part of Avatar Graph's documented rigging pipeline (Create Mesh Layer → Modify Shape Key → Create Shape Flow → Avatar Main Output). It's one of the nodes this pack auto-generates by wrapping essentially every operator in Blender's bpy.ops.mesh namespace, a mapping the README's generate_blender_types.py script keeps in sync. The interactive tool needs your mouse position twice - once to pick the nearest element, once to define where it moves to - and this node's schema has neither. It's just BPY_OBJ in, BPY_OBJ out, nothing to target and nothing to steer where it ends up.

How it works

It combines proximity-based element selection with an immediate translate on whatever it grabbed - the same "pick, then adjust" shape that runs through every *Move-suffixed node in this pack's Polybuild set.

The inputs and outputs that matter

Nothing beyond the mesh itself - no mirror flag, no proportional editing controls exposed. Of the Polybuild variants, the *Move macros consistently ship the barest schemas, since they're compound operators with no independently surfaced settings of their own.

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

The pack depends on bpy, Blender shipped as a pip module, and bpy only publishes wheels for specific Python minor versions - the README states it directly: Python 3.10.x, no substitutes. 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 first. Add --enable-cors-header (--force-fp16 on Mac too) to your launch command if you want the live avatar preview panel - skip it and the graph still executes, minus the real-time viewer.

Common issues

Don't expect this node to grab a specific piece of geometry and move it somewhere specific - with no cursor or move-delta exposed, both halves of the macro fall back to internal defaults that aren't something you can reliably control from a graph. If a scripted pipeline genuinely needs "select this, then move it there," build it from an explicit selection plus a standard transform operator instead. As with every node in this pack: a bpy install failure is almost always a Python-version mismatch, not a broken package - confirm python --version says 3.10.x before troubleshooting anything else.

Categoryblender

Inputs (1)

NameTypeDefaultDescription
BPY_OBJoptBPY_OBJ

Outputs (1)

NameTypeDescription
BPY_OBJBPY_OBJ