Nodes/Avatar Graph/Object Quick Liquid
ComfyUI Node

Object Quick Liquid

Make your avatar cry actual liquid with Blender's one-click fluid sim

By avatechai·Created 3 years ago·Updated 2 years ago· 264
Object Quick Liquid
  • BPY_OBJ
  • BPY_OBJ
show_flowsfalse

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.

Categoryblender

Inputs (2)

NameTypeDefaultDescription
BPY_OBJoptBPY_OBJ
show_flowsoptBOOLEANfalse

Outputs (1)

NameTypeDescription
BPY_OBJBPY_OBJ