Nodes/Avatar Graph/Object Set Name Full
ComfyUI Node

Object Set Name Full

Object Set Name Full — the setter for Blender's de-duplicated name

By avatechai·Created 3 years ago·Updated 2 years ago· 264
Object Set Name Full
  • BPY_OBJ
  • BPY_OBJ
valueCube

Blender has two names for every object: name, which you type in and read, and name_full, which is the actual unique name in the database. The moment a second "Cube" shows up, Blender silently renames the new one Cube.001 and stores that in name_full while keeping name as the friendly label. Object Set Name Full is the auto-generated setter for that second property - you're reaching for it when a node downstream needs to address an object by its true, collision-proof name rather than its display name.

How it works

Like every ObjectSet_* node in the Avatar Graph pack, this one is generated from Blender's bpy.types.Object property list rather than hand-coded. The mechanism is dead simple: it takes a BPY_OBJ, runs setattr(object, "name_full", value) inside the embedded bpy instance, and returns the same object so you can keep chaining setters. The value input is a plain STRING defaulting to "Cube", same as its sibling Object Set Name.

The practical difference is subtle. If your graph creates two mesh layers and both are named "Cube", Blender assigns the second name_full of Cube.001. Renaming via name fixes the label; renaming via name_full forces the raw unique identifier - which is what Object Set Parent Bone, parenting ops, and glTF export actually look up. If you're wiring a rig where one object must reference another by exact name, this is the node that makes that unambiguous.

The inputs

  • BPY_OBJ - the object reference from Create Mesh Layer, a Mesh_ primitive, or an Object_ op.
  • value - the full name string, default "Cube".

Output is the same BPY_OBJ. There's nothing else on the node.

Install & gotchas

It's part of the Avatar Graph pack, so install that once and every ObjectSet_* node comes with it:

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

Or use ComfyUI Manager and search "Avatar Graph". The big requirement: the pack pins bpy==3.6.0, which needs Python 3.10 - 3.11+ and bpy won't install, so the whole pack fails to load. Use a conda env with python=3.10 (the README's own recommendation). First launch downloads a ~2.5 GB SAM model plus mediapipe landmarker files, so give it time.

Two real-world traps: names only matter if the object survives - the bpy scene is reset per queue run, so put the setter after the object's creation node in the same graph. And on ComfyUI Desktop, the pack's embedded editor overlay has been reported to render broken/oversized after install; browser build or a Manager reinstall fixes it. Also, most people can use Object Set Name and never touch this one - reach for name_full only when a downstream node is genuinely failing to find the object by its display name.

Categoryblender

Inputs (2)

NameTypeDefaultDescription
BPY_OBJoptBPY_OBJ
valueoptSTRINGCube

Outputs (1)

NameTypeDescription
BPY_OBJBPY_OBJ