Nodes/Avatar Graph/Object Set Is Instancer
ComfyUI Node

Object Set Is Instancer

Marking the object that makes the copies

By avatechai·Created 3 years ago·Updated 2 years ago· 264
Object Set Is Instancer
  • BPY_OBJ
  • BPY_OBJ
valuefalse

ObjectSet Is Instancer sets Blender's is_instancer flag, which marks an object as one that spawns copies of other objects - the parent in an instancing relationship. It's the bookkeeping twin of is_from_instancer (which marks the copies). And like its twin, it's mostly read-only state that the engine manages, not a switch you throw.

The honest version: this is one of the least useful nodes in the Avatar Graph pack, and you can safely ignore it. Blender's Python API treats is_instancer as read-only - it's a fact the engine records when an object is set up to instance others, not a property you set by hand to make instancing happen. The ObjectSet_* family is auto-generated from a dump of every property on Blender's object type, and the generator doesn't discriminate between real setters (hide_render, is_shadow_catcher) and read-mostly metadata flags like this one. This node is the latter.

It's doubly a no-op in Avatar Graph's world because the pack boots a headless Blender and resets the scene to factory settings at the start of every graph run. Nothing in that fresh scene is an instancer unless your nodes build one via ObjectSet Instance Type - and if they do, Blender sets is_instancer itself. The node exists to let you assert the flag in the graph, not to cause it.

How it works

Same mechanics as every sibling: BPY_OBJ in, boolean value (default false), a setattr on the underlying Blender object, same object out for the next node in the chain.

Inputs that matter:

  • BPY_OBJ - the object whose instancer flag you're asserting
  • value - boolean, default false

Installing Avatar Graph

This 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. Pack notes as always: bpy==3.6.0 requires Python 3.10 (bundled environment on Windows via the README; conda on macOS/Linux), and first launch downloads the SAM ViT-H model plus the mediapipe face/pose landmarkers.

Common issues

The direction of causality matters: setting is_instancer doesn't make an object instance anything. If you want copies, configure instancing properly with ObjectSet Instance Type (VERTS, FACES, or COLLECTION) and let Blender mark the instancer itself. Wiring this node into a chain is at most a readability gesture - skip it and your avatar still exports fine.

Categoryblender

Inputs (2)

NameTypeDefaultDescription
BPY_OBJoptBPY_OBJ
valueoptBOOLEANfalse

Outputs (1)

NameTypeDescription
BPY_OBJBPY_OBJ