Object Set Use Empty Image Alpha

Avatar Graph loads your character reference image onto a Blender Empty object (that's what Object Load Reference Image does), and Blender's Empty-image display has its own separate setting for whether it respects that image's alpha channel or just renders it as opaque. Object Set Use Empty Image Alpha is the toggle for that setting - small, specific, and exactly the kind of thing that's easy to miss if you don't know it exists, because it's not part of the image itself, it's part of how the object displaying the image chooses to draw it.

How it works

This wraps a Blender Empty-object display property, not an image-processing operation - nothing about the underlying image changes when you flip this. If your reference or texture PNG has a transparent background but the Empty showing it in the Blender scene is set to ignore alpha, it'll render as a solid rectangle with the transparent areas filled in (usually as a flat color) instead of showing through to whatever's behind it. That's a common trap specifically because the fix isn't in the image node at all - it's this separate object-level toggle.

The inputs and outputs that matter

• BPY_OBJ - the Empty object whose alpha display setting you're changing.
• value - boolean, defaults false. Set it true to make the object respect the image's alpha channel and actually render transparency; leave it false if you want the image treated as fully opaque regardless of what its alpha channel says.

Output is a single BPY_OBJ, the object with the setting applied, ready to continue the chain.

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

then pip install -r requirements.txt and restart. Needs Blender's bpy module, pinned to Python 3.10.x - a dedicated conda environment on macOS/Linux, or Avatech's prebuilt Python-3.10 ComfyUI zip on Windows with the pack installed through Manager afterward.

Common issues & troubleshooting

If the node won't load, it's the usual pack-wide culprit: wrong Python version for bpy. Check ComfyUI's startup console for an import error and confirm you're on Python 3.10.x with requirements.txt installed cleanly.

If you're chasing a transparency bug - a reference image or texture that has a proper alpha channel but keeps showing up as an opaque block in your Blender scene - this is the node to reach for before assuming the problem is in the image file or in whichever node produced it (like Image Alpha Mask Merge). Confirm the source image actually has real alpha first, then set value to true here on the object displaying it.