Nodes/Avatar Graph/Object Paths Clear
ComfyUI Node

Object Paths Clear

Clear cached animation motion paths off your objects

By avatechai·Created 3 years ago·Updated 2 years ago· 264
Object Paths Clear
  • BPY_OBJ
  • BPY_OBJ
only_selectedfalse

Object_PathsClear wipes the cached motion paths Blender draws for animated objects - the wrapper for bpy.ops.object.paths_clear(). In Blender's viewport, animated objects can show their trajectory as a "motion path" line. This node clears that cached path data. For most of the history of this pack's users, that's the whole story.

What it's really for

Motion paths are a Blender animation-display feature: you calculate paths to preview how an object moves over its keyframes. If you've calculated paths (via Object_PathsCalculate or Object_PathsUpdate), they sit in memory and render in the viewport. PathsClear deletes that cache, and only_selected (a boolean, false by default) scopes it to just the selected objects instead of everything.

Here's the thing: Avatar Graph's avatar rigs don't use Blender's motion-path preview. This node is part of the auto-generated bpy.ops.object surface, the same mechanical API dump that gave you Object_OceanBake and the particle nodes. If a template imported it, you can usually delete it and never look back. If you somehow do have path caches cluttering an export or a scene, this clears them.

How it works

Standard Object_* plumbing. The node sets your BPY_OBJ active in the shared headless Blender scene, runs the operator (with only_selected if you set it), and returns the same object. Output is the same BPY_OBJ. Harmless no-op if there are no paths cached.

Installing it

Ships in 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

Pack-wide: bpy==3.6.0 needs Python 3.10. Newer Python = "no module named bpy" = the pack won't load. Windows: README's bundled ComfyUI_3.10.7z + run_nvidia_gpu_3.10.bat. Elsewhere: conda, python=3.10.

Gotchas

  • You'll almost never need it. Don't go hunting for motion-path problems in an avatar workflow that doesn't have any.
  • The scene resets each graph run, so state doesn't persist between queues anyway.
  • only_selected only matters if there's something meaningful selected in the shared scene.
Categoryblender

Inputs (2)

NameTypeDefaultDescription
BPY_OBJoptBPY_OBJ
only_selectedoptBOOLEANfalse

Outputs (1)

NameTypeDescription
BPY_OBJBPY_OBJ