Object Set Instance Faces Scale

ObjectSet Instance Faces Scale is the node that sizes the copies when you instance one mesh onto the faces of another. If that sentence made sense to you, you probably know where this fits. If it didn't, this node is safely ignorable - but here's the half of the story that's worth having.

Blender has a feature where an object can duplicate itself automatically at every vertex or face of a parent object - think hair, fur, scales, or a field of identical props. When you use the face flavor of that (via ObjectSet Instance Type set to FACES), each duplicate appears centered on a face of the parent mesh, and instance_faces_scale controls how big those duplicates are. Default 1.0 means full size; crank it down to 0.2 for tiny studs, or up if your duplicated mesh needs to sit larger relative to the parent.

In the avatar world this is niche - you're not usually furring your character with instanced copies. Where it does show up is decorative: a repeated accessory, jewelry-like elements, or any geometry you want scattered across a mesh without actually building it out. It's one of those Blender features the pack exposes because the ObjectSet_* family is auto-generated from every property on Blender's object type, and it's cheap for them to include even if the demo templates don't use it.

How it works

Like every ObjectSet_* node: one property, one setattr, object passes through unchanged. Feed it a BPY_OBJ and a value float, and it sets instance_faces_scale on that object. Output is the same BPY_OBJ for the next node.

The two inputs that matter:

• BPY_OBJ - the object whose face-instances you're sizing
• value - float, default 1.0

Installing Avatar Graph

The node ships with the full pack:

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

Or ComfyUI Manager → Install Custom Nodes → search Avatar Graph → restart. Reminder that the pack is picky: it pins bpy==3.6.0 and therefore requires Python 3.10 (bundled 3.10 environment on Windows; conda env on macOS/Linux). First launch downloads the SAM ViT-H segmentation model and mediapipe face/pose landmarkers.

Common issues

This value does absolutely nothing unless instance_type is set to FACES (or VERTS - the scale is shared there too). Setting a scale on an object with default instancing is a silent no-op, so if you're tweaking it and seeing no change, check the ObjectSet Instance Type node upstream in your chain. And since the pack rebuilds its Blender scene from scratch on every run, instancing state has to come from the graph every time - there's no persistent Blender scene to forget to save.