Object Multires Subdivide
Add detail with a Multires level, Catmull-Clark and all
- BPY_OBJ
- BPY_OBJ
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.
Inputs (3)
| Name | Type | Default | Description |
|---|---|---|---|
| BPY_OBJopt | BPY_OBJ | — | |
| modifieropt | STRING | — | |
| modeopt | COMBO | 3 options: CATMULL_CLARK, SIMPLE, LINEAR |
Outputs (1)
| Name | Type | Description |
|---|---|---|
| BPY_OBJ | BPY_OBJ | — |