Object Quick Liquid
Make your avatar cry actual liquid with Blender's one-click fluid sim
- BPY_OBJ
- BPY_OBJ
Object Quick Liquid is the VFX version of the pack's one-click generators: it wraps bpy.ops.object.quick_liquid, which takes your active mesh, turns it into a fluid simulation domain, and sets up the flow objects that feed it. In real Blender it's the "Quick Liquid" button that gets you a splashy fluid sim in seconds. Inside Avatar Graph it does exactly that inside the headless Blender scene - which is a lot more fun than it is practical.
What it does
The operator converts the active object into a fluid domain and adds inflow/outflow objects around it. The only real input beyond BPY_OBJ is show_flows, a boolean that's off by default - flip it on if you want to see the flow source objects in the viewport preview. That's the whole surface area: no viscosity, no gravity, no resolution dials. Blender's quick presets hide all of that from you, and so does this node.
The single output is BPY_OBJ, the same object now carrying fluid simulation data.
The honest take
Fluid sims need baking - frames of simulation work that happen over time - and the Avatar Graph runtime resets the Blender scene to factory settings between runs. So a liquid that's mid-bake doesn't persist anywhere you can grab it the way mesh layers do. In the demo-era avatar workflow (blink, lipsync, posing), quick liquid is closer to a party trick than a pipeline tool. If you're building a character that's literally crying or a creature dripping goo, expect to fight the baking step hard.
It's also worth knowing why this node exists: like most of the Object_* family, it's auto-generated from the pack's list of Blender operators - object_api in ops_mesh.py literally includes 'quick_liquid'. The pack wraps every operator it can, curated or not. Quick Liquid is one of the less-curated corners.
Installing it
Part of the Avatar Graph pack. 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
Same pack-wide caveats as the others: bpy==3.6.0 requires Python 3.10 (conda env or the README's bundled Windows runtime), and first import auto-downloads the SAM checkpoint and mediapipe models. If you pulled this pack for the rigging nodes and just tripped over Quick Liquid in the search results, you haven't missed anything - the shape key and mesh layer nodes are where the actual magic lives.
Inputs (2)
| Name | Type | Default | Description |
|---|---|---|---|
| BPY_OBJopt | BPY_OBJ | — | |
| show_flowsopt | BOOLEAN | false | — |
Outputs (1)
| Name | Type | Description |
|---|---|---|
| BPY_OBJ | BPY_OBJ | — |