Object Particle System Add
Add a particle system to an object (hair, if you must)
- BPY_OBJ
- BPY_OBJ
Object_ParticleSystemAdd adds a particle system slot to a Blender object - the wrapper for bpy.ops.object.particle_system_add(). It's about as thin as a node gets: one BPY_OBJ in, same BPY_OBJ out, nothing to configure. The new particle system is the object's active one, ready for whatever settings come next.
What it's actually for
Particles in Blender are how you do hair, fur, and scattering. If you're going to give an avatar character actual hair strands (not a flat mesh layer), a particle system is one way to generate them. In the Avatar Graph context that's a stretch goal - the pack is built around flat image meshes and shape keys, and particle hair is a whole separate rabbit hole.
The honest framing: this node exists because Avatar Graph auto-generates wrappers for the entire bpy.ops.object surface. particle_system_add was on the list. For most avatar work you will not need it, and knowing that is half the battle - don't go hunting for hair settings here.
How it works
Standard Object_* plumbing. The node sets your BPY_OBJ active in the shared headless Blender scene, runs the operator, and returns the same object. Output is the same BPY_OBJ. Since there are no parameters, there's nothing to misconfigure - either the object gets a particle slot or (if the operator refuses) nothing happens.
Installing it
It ships inside 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 requirement to remember: bpy==3.6.0 only supports Python 3.10. On newer Python you get "no module named bpy" and the pack won't load at all. Windows: the README's bundled ComfyUI_3.10.7z + run_nvidia_gpu_3.10.bat. Elsewhere: conda with python=3.10.
Gotchas
- Adding a particle system is easy; making it look like hair is the hard part. This node only adds the slot - all the settings live elsewhere, and the generated node surface doesn't expose much of them.
- The scene resets each graph run, so the object must be built upstream in the same run.
- If you added one by accident,
Object_ParticleSystemRemoveis its counterpart.
Inputs (1)
| Name | Type | Default | Description |
|---|---|---|---|
| BPY_OBJopt | BPY_OBJ | — |
Outputs (1)
| Name | Type | Description |
|---|---|---|
| BPY_OBJ | BPY_OBJ | — |