Object Set Lock Rotations4D

ObjectSet Lock Rotations4D toggles a Blender object's lock_rotations_4d flag, which locks the fourth axis of a rotation. If your eyes just glazed over, that's the right response - this is one of the most obscure properties Blender exposes on an object, and it's almost certainly irrelevant to your avatar.

Here's the context it lives in. Blender normally represents rotations as Euler angles or quaternions. There's a legacy axis-angle flavor where rotation is expressed as a rotation about an axis plus a fourth "W" component, and lock_rotations_4d guards that extra axis so it can't be changed by accident when you're animating. It's a transform-lock feature for people hand-animating with axis-angle rotation mode. Avatar Graph doesn't animate objects by rotating them in Blender - the pack exports meshes and shape keys and hands animation off to the Avatech editor / Shape Flow runtime. You will not need this lock.

So consider this node filed under "the pack auto-generates a setter for every Blender object property, and some of them are strange." The default is false, which is unambiguously what you want - locks exist to prevent edits, and you're not making these edits. Setting it to true won't break your workflow, but it also won't do anything you'll notice.

How it works

Mechanically it's a clone of every ObjectSet_* sibling: BPY_OBJ in, a boolean value (default false), a setattr on the underlying Blender object, and the same BPY_OBJ passed out so the chain continues.

Inputs that matter:

• BPY_OBJ - the object whose rotation lock you're toggling
• 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. Usual pack notes: bpy==3.6.0 requires Python 3.10 (bundled 3.10 environment on Windows; conda on macOS/Linux), and the first launch downloads the SAM ViT-H model into ComfyUI/models/sams plus the mediapipe face/pose landmarkers.

Common issues

The only way to hit a real problem here is to set the lock on and then wonder why a rotation won't change - which, given the pack resets its Blender scene to factory settings every run, would only last as long as the current execution anyway. Leave it at false, or just don't include the node at all. This is one of the safest nodes in the pack to skip.