Mesh Mark Freestyle Face

Same story as its edge-level sibling Mesh Mark Freestyle Edge, just applied per-face instead of per-edge: this flags selected faces for Blender's Freestyle line-rendering system, and it's not something Avatar Graph's own avatar rigging workflow calls for. It's one of the pack's auto-generated wrappers around Blender's full mesh operator set, not a hand-picked part of the README's documented node list.

How it works

It wraps Blender's mesh.mark_freestyle_face operator. Freestyle can be configured to use face marks to control which faces get excluded from (or included in) line-art rendering - a way of scoping stylized outline strokes to specific parts of a mesh rather than the whole thing. This node sets that per-face flag on the current selection. Like its edge counterpart, it does nothing to Avatech's own live avatar viewer or a GLB/GLTF export; it only matters if the mesh is later rendered through Blender's own Freestyle system.

The inputs and outputs that matter

• BPY_OBJ (optional) - the mesh, with the faces to flag already selected.
• clear (default false) - removes the Freestyle face mark from the selection instead of adding it.

Output is a single BPY_OBJ, geometrically unchanged - only the per-face flag differs.

How to install it

ComfyUI Manager: search "Avatar Graph" and install. 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

No visible effect after running it. Expected in nearly every Avatar Graph use case - this flag only matters to Blender's Freestyle renderer, which isn't part of this pack's avatar viewer or its glTF export path. If your goal is anything about how the exported avatar looks, this node isn't the lever for it.

You want stylized/toon outlines on your exported character. That's not something this flag controls downstream in Avatar Graph - the pack's rendering is its own real-time Shape Flow system, entirely separate from Blender's Freestyle pipeline, so marking faces here won't produce outlines in the avatar viewer or in a GLB/GLTF file.

A bpy import failure at ComfyUI startup is the pack's Python-version pin, not this operator - confirm a clean Python 3.10.x environment with requirements.txt installed without errors.