Object Ocean Bake
Bake an ocean simulation, or just skip this node
- BPY_OBJ
- BPY_OBJ
Object_OceanBake bakes Blender's Ocean modifier - the one that simulates animated waves - to a cache so it doesn't have to re-simulate every frame. It's a wrapper for bpy.ops.object.ocean_bake(), and I'll save you some scrolling: for an avatar rigging pack, this node exists because Avatar Graph generated the whole Blender object-operator surface, not because your character needs ocean waves.
What it does
If an object has an Ocean modifier, the ocean sim is expensive to compute. Baking precomputes the displacement data so playback and export can just read the cache. The node's inputs:
- BPY_OBJ (in/out) - the object with the Ocean modifier.
- modifier - the exact name of the Ocean modifier (usually
Ocean). - free - if true, frees the simulation data after baking, keeping just the baked cache. Saves memory at the cost of flexibility.
When you'd actually use it
Basically never in a normal avatar workflow. Your eye-blink, lipsync character does not have an Ocean modifier. This node is here because the pack auto-generates wrappers for every bpy.ops.object.* operator, and ocean_bake is on that list. If a workflow template you imported has one, you can almost always delete it.
If you ever do have a legit ocean object (say you're baking a water background plate to go behind your avatar), it works exactly as advertised: set the modifier name, optionally enable free, and the baked cache lands on the modifier.
How it works
Standard Object_* plumbing - the node sets your BPY_OBJ active in the shared headless Blender scene, runs the operator, returns the same object. Output is the same BPY_OBJ.
Installing it
It ships inside Avatar Graph; one install covers every node:
- 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
Pack-wide requirement: bpy==3.6.0 needs Python 3.10. Newer Python means "no module named bpy" and the whole pack fails to load. Windows: use the README's bundled ComfyUI_3.10.7z + run_nvidia_gpu_3.10.bat. Elsewhere: conda, python=3.10.
The honest take
Treat Object_OceanBake like the pack's easter egg rather than a tool in your daily kit. It's a faithful wrapper and it works, but if you're building avatars you'll never touch it - and that's completely fine. The same goes for most of the Object_* multires and simulation nodes: they're the byproduct of generating an API surface, not the pack's core value. Your actual rigging work lives in the mesh, shape-key, and shape-flow nodes.
Inputs (3)
| Name | Type | Default | Description |
|---|---|---|---|
| BPY_OBJopt | BPY_OBJ | — | |
| modifieropt | STRING | — | |
| freeopt | BOOLEAN | false | — |
Outputs (1)
| Name | Type | Description |
|---|---|---|
| BPY_OBJ | BPY_OBJ | — |