Object Effector Add

Worth saying up front, same as with this pack's armature and remesh nodes: this isn't part of Avatar Graph's documented pipeline. Object Effector Add creates a Blender force field - a physics-simulation tool, not something the README's blink-and-lipsync workflow touches.

What it is

It wraps bpy.ops.object.effector_add(), adding a new Empty object tagged with Force Field physics settings, which Blender's simulation systems (particles, cloth, soft body) read to push, pull, or otherwise influence anything set up to respond to it. It's a general Blender scene-building operator that exists here because this pack auto-generates a node for a wide swath of Blender's object.* namespace, not because force fields are part of the avatar-rigging story this pack ships templates for.

If you're doing your own physics-driven secondary motion on top of the platform - jiggle, cloth sway, that kind of thing, beyond the documented shape-key rig - this is where you'd start.

The inputs and outputs that matter

• type (enum) - which kind of field: FORCE (pulls/pushes along a line to the object), WIND (directional push), VORTEX (swirling pull), TURBULENCE (randomized noisy motion), MAGNET, HARMONIC, and several more specialized types beyond those.
• radius (float, default 1) - the field's effective influence distance/falloff.
• enter_editmode (bool, default false) - whether the new object opens directly in Edit Mode; largely inherited boilerplate for an Empty, since there isn't much to edit on one.
• align (enum: WORLD, VIEW, CURSOR) - orientation on creation.
• location / rotation / scale - starting transform.

Output: a single BPY_OBJ, the new force-field object.

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

bpy needs Python 3.10.x, exactly. Windows gets a prebuilt Python-3.10 ComfyUI zip from the README; macOS/Linux wants a dedicated conda create --name comfyui python=3.10 rather than an existing newer-Python setup. Add --enable-cors-header on restart (--force-fp16 too on Mac) for the live avatar preview to reach editor.avatech.ai; skip it and you still get full functionality via .glb/.gltf export.

Common issues & troubleshooting

Node not loading is the Python-version pin - check ComfyUI's startup console for a bpy import error before suspecting this node.

Force field has no visible effect - that's expected on its own. A force field only does anything to objects and systems set up to respond to physics forces (particles, cloth, soft-body simulations); it doesn't push or move ordinary mesh objects by itself. If you added one expecting immediate visible motion, you're missing the simulation side that actually reacts to it.

Not sure whether this belongs in your rig - if your goal is the documented Avatar Graph output (blink and lipsync driven by shape keys through Shape Flow), it doesn't. Reach for this only if you're deliberately layering custom physics on top of what the pack ships out of the box.