blender-syntax-animation

Quick Reference

Critical Warnings

ALWAYS set the property value BEFORE calling keyframe_insert() — keyframes record the current value at call time.

ALWAYS call fcurve.update() after manually adding or modifying keyframe points via keyframe_points.add() or direct .co assignment.

NEVER access edit_bones outside of Edit Mode — the collection is empty/inaccessible in Object or Pose Mode.

NEVER use bone.layers or pose.bone_groups in Blender 4.0+ — these are removed. Use BoneCollection instead.

NEVER use driver.expression referencing self without enabling driver.use_self = True.

ALWAYS create animation_data before accessing .action or .nla_tracks — call obj.animation_data_create() if obj.animation_data is None.

Decision Tree: Animation Approach