Nodes/Avatar Graph/Object Set Use Mesh Mirror X
ComfyUI Node

Object Set Use Mesh Mirror X

Symmetric editing for symmetrical avatars

By avatechai·Created 3 years ago·Updated 2 years ago· 264
Object Set Use Mesh Mirror X
  • BPY_OBJ
  • BPY_OBJ
valuefalse

Faces are basically symmetric, and Object Set Use Mesh Mirror X is the Avatar Graph node that lets you exploit that. Avatech's pack rigs 2D character images into animatable avatars through an embedded Blender, and its ObjectSet_ family wraps every simple Blender object attribute as a property setter. This one maps to Blender's "mirror editing" flag for the X axis - the edit-mode helper that mirrors whatever you do to one side of a mesh across the other.

What it actually does

In Blender's edit mode, mesh mirroring (the X/Y/Z toggle in the 3D viewport header) makes every edit apply symmetrically: grab a vertex on the left side of the face and the matching vertex on the right moves too. It's the standard workflow for anything character-shaped, because you model one half and the other half follows for free. The use_mesh_mirror_x property is that toggle on the object - with it on, edits to the mesh are mirrored across the X axis (left/right, the symmetry plane a face naturally has).

Where this matters for Avatar Graph: your character mesh is built from a segmented image and then edited - shape keys for blinks and mouth movement, vertex groups for the rig. If you're adjusting one eye or one side of the mouth and want the other side to track it, this is the switch. It's a workflow convenience, not a modifier - it doesn't bake anything or change the mesh by itself, it just makes your subsequent edits symmetric. Default is false, because most avatar meshes are generated as complete (if slightly imperfect) shapes rather than half-models.

The inputs and outputs that matter

  • BPY_OBJ - the mesh you want to edit symmetrically.
  • value - boolean, default false. true turns on X-axis mirror editing.

Output is the same BPY_OBJ, passed on to the next node.

How to install it

Ships with the full Avatar Graph pack - ComfyUI Manager, search "Avatar Graph", or:

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

restart ComfyUI. Pack-wide snag: bpy==3.6.0 only has wheels for Python 3.10.x, so install fails on modern Python. python=3.10 conda env, or Avatech's prebuilt Python-3.10 ComfyUI zip on Windows.

Gotchas

Don't confuse this with the Mirror modifier - this flag makes your edits symmetric; it doesn't create a mirrored copy of the mesh. And it only affects edit-mode operations, so if your workflow is purely "segment image → generate mesh → shape keys," it may never visibly do anything. If your left/right edits stop matching and you were relying on this, the flag is the first thing to check - it's easy to toggle on and forget, and easy to toggle off and not notice until asymmetry sneaks back in.

Categoryblender

Inputs (2)

NameTypeDefaultDescription
BPY_OBJoptBPY_OBJ
valueoptBOOLEANfalse

Outputs (1)

NameTypeDescription
BPY_OBJBPY_OBJ