Nodes/Avatar Graph/Object Multires Subdivide
ComfyUI Node

Object Multires Subdivide

Add detail with a Multires level, Catmull-Clark and all

By avatechai·Created 3 years ago·Updated 2 years ago· 264
Object Multires Subdivide
  • BPY_OBJ
  • BPY_OBJ
modifier
mode

Object_MultiresSubdivide bumps the subdivision level of a Multires modifier - Blender's "add a level" button as a node. If you want a mesh layer to carry more geometry for detail work or displacement, this is how you get it, without leaving the graph.

Why you'd use it

Multires is a non-destructive way to add resolution: your base mesh stays light and every level on top adds real geometry you can sculpt or displace into. In the avatar pipeline you'd subdivide a face or body layer up before applying detail - then, once you've got the level you need, trim the stack with Object_MultiresHigherLevelsDelete or commit it with Object_MultiresBaseApply.

The one input worth caring about beyond BPY_OBJ and modifier is mode:

  • CATMULL_CLARK - smooth subdivision, the default. Rounds the mesh and adds geometry evenly. What you want for organic shapes like faces.
  • SIMPLE - adds geometry without smoothing the silhouette. Great before a displacement texture, because it boosts density without changing the shape.
  • LINEAR - straight linear interpolation. Niche, mostly for technical cleanup.

How it works

Generated wrapper for bpy.ops.object.multires_subdivide(). Standard Object_* plumbing: pass a BPY_OBJ, the node sets it active in the shared headless Blender scene, runs the operator, returns the same object. The modifier input is a plain text field holding the exact name of the Multires modifier - Multires, Multires.001, whatever Blender created.

The inputs

  • BPY_OBJ (in/out) - the object to subdivide.
  • modifier - exact Multires modifier name.
  • mode - CATMULL_CLARK / SIMPLE / LINEAR.

Output: the same BPY_OBJ.

Installing it

Comes with Avatar Graph:

  • ComfyUI Manager: search "Avatar Graph", install, restart.
  • Or:
cd ComfyUI/custom_nodes
git clone https://github.com/avatechai/avatar-graph-comfyui
cd avatar-graph-comfyui && python -m pip install -r requirements.txt

The pack-wide wall: bpy==3.6.0 only runs on Python 3.10. On 3.11+ you get "no module named bpy" and nothing loads. Windows users get the README's bundled ComfyUI_3.10.7z + run_nvidia_gpu_3.10.bat; everyone else, conda with python=3.10. First boot also pulls the SAM and mediapipe models into models/sams.

Gotchas

  • Every subdivision multiplies vertex count - a few levels of Catmull-Clark and a small mesh becomes a big one. Watch memory if you stack many levels.
  • Wrong modifier name = silent no-op.
  • The scene resets each run, so the object has to be built upstream in the same graph.
Categoryblender

Inputs (3)

NameTypeDefaultDescription
BPY_OBJoptBPY_OBJ
modifieroptSTRING
modeoptCOMBO3 options: CATMULL_CLARK, SIMPLE, LINEAR

Outputs (1)

NameTypeDescription
BPY_OBJBPY_OBJ