Mesh Primitive Cylinder Add

Most of Avatar Graph's Blender nodes process a mesh you already generated from a segmented image. Mesh Primitive Cylinder Add is one of the small set that build geometry from scratch: it spawns a cylinder into the scene, ready to feed into the rest of the pipeline. In an avatar-rigging context that's a fast base shape for anything roughly tube- or disc-like - a pupil, a simple prop, a placeholder you'll reshape with the pack's other Blender nodes.

How it works

This is close to a direct wrap of Blender's own mesh.primitive_cylinder_add operator - if you've used Blender's Add Mesh menu, the parameters here will look familiar, since the pack generates its Blender-facing node definitions straight from Blender's own operator metadata rather than a hand-simplified version.

The inputs and outputs that matter

• vertices (default 32) - how many sides the cylinder's circular cross-section has. Lower it for a chunky, faceted look; raise it for a smoother circle.
• radius (default 1) and depth (default 2) - how wide and how tall the cylinder comes out.
• end_fill_type - how the two flat ends get capped: NOTHING leaves them open (a hollow tube), NGON fills each with a single flat n-gon face, TRIFAN fills with a fan of triangles instead. NGON is the usual default and the lightest on face count.
• location, rotation, scale - where and how it lands in the scene (all B_VECTOR3 types).
• align - WORLD, VIEW, or CURSOR, controlling what the initial orientation is measured against.
• calc_uvs (default true) - whether it comes out with generated UV coordinates, worth leaving on if you're going to texture it.
• enter_editmode (default false) - whether Blender drops straight into edit mode on the new object afterward; leave off unless a downstream node specifically expects edit-mode state.
• seed - present in the schema, but there's no tooltip and Blender's own cylinder-add operator has no randomized element to seed by default. Safest bet is to leave it at 0 unless you've confirmed a specific effect for your version of the pack.

Output is a single BPY_OBJ - the new cylinder, ready to chain into any other Blender node in the pack.

How to install it

ComfyUI Manager, search "Avatar Graph" and install, or manually:

cd ComfyUI/custom_nodes
git clone https://github.com/avatechai/avatar-graph-comfyui

then pip install -r requirements.txt and restart. This is a bpy-backed node, so the pack's core requirement applies: Blender's bpy package only ships for Python 3.10.x. On macOS/Linux, build a dedicated conda environment; on Windows, Avatech's prebuilt Python-3.10 ComfyUI zip plus the pack installed through Manager is the easier path.

Common issues & troubleshooting

If the node won't load at all, that's the bpy Python-version mismatch, not this specific operator - confirm you're on a clean Python 3.10.x environment with requirements.txt installed without errors.

If the cylinder shows up at an unexpected size or in the wrong spot, double-check location/scale weren't left at defaults you weren't expecting, and that align is set to what you actually want - VIEW and CURSOR orient the shape relative to state that isn't always obvious from inside a headless ComfyUI graph the way it would be in Blender's own viewport.