Mesh Customdata Mask Clear

Of all the auto-wrapped Blender operators in Avatar Graph's Customdata family, this is probably the least likely to ever fire in a real Avatar Graph workflow. It wraps bpy.ops.mesh.customdata_mask_clear - a mesh object in, the same object out, no other configuration.

What it actually does

The "mask" here isn't a texture mask or a segmentation mask like the ones this pack's SAM-based nodes produce upstream - it's Blender Sculpt Mode's paint mask, a per-vertex float layer that protects part of a mesh from sculpt brushes when you've painted a mask over it. This operator clears that layer, un-protecting everything and letting future sculpt strokes affect the whole mesh again.

The reason this exists as a node at all is the same reason as the other Customdata* nodes: Avatar Graph auto-generates a ComfyUI wrapper for a broad slice of Blender's mesh operator surface (per the repo's generate_blender_types.py), not because someone hand-picked it as useful for character rigging. Nothing in Avatar Graph's own rigging pipeline - the segmentation → mesh layer → shape key → Shape Flow chain the README walks through - touches Sculpt Mode or its mask data.

The input and output that matter

• BPY_OBJ (optional) - the mesh to clear the sculpt mask data from.

Output is the same BPY_OBJ, mask layer removed if it existed.

How to install it

Search Avatar Graph in ComfyUI Manager, or clone 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

then restart. The pack is pinned to bpy==3.6.0, buildable only under Python 3.10.x - the README ships a prebuilt Python-3.10 zip for Windows, and a dedicated conda environment (conda create --name comfyui python=3.10) is the reliable route on Mac/Linux. opencv-python, mediapipe, and segment-anything also install, unpinned.

Common issues & troubleshooting

"I ran this expecting it to clear an image or segmentation mask, and nothing happened visually." That's a naming collision, not a bug - this clears Sculpt Mode's paint-mask data layer, which is unrelated to the segmentation masks the SAM node in this pack produces from an input image. If you're trying to manipulate the segmented regions from Segmentation (SAM), this isn't the node for that.

You're wondering whether you need this node at all. Almost certainly not, unless you're specifically hand-sculpting a mesh with Blender's Sculpt Mode masking workflow somewhere in your pipeline - something Avatar Graph's documented templates don't do. It's here because the pack wraps a lot of bpy.ops.mesh, not because it's a normal step in avatar rigging.

Import errors when ComfyUI starts. That's the Python 3.10.x requirement across the whole pack, not this node - check your interpreter before anything else.