Blender Python Automation & Animation Toolkit

A multi-module 3D production pipeline and animation suite developed entirely within Blender using the bpy (Blender Python) API. This toolkit features three distinct animation subsystems managed through a dedicated controller framework (bco602tk). It demonstrates procedural keyframing, soft-body/cloth mesh simulations, and custom GUI execution tools designed to streamline technical animation workflows.

---

🚀 Features & Modules

The repository is divided into three production-ready animation concepts:

1. Beach Ball Simulation (beachBall): Implements physics-based dynamics, surface collisions, and rolling mechanics tailored for spherical rigid structures interacting with environmental friction.
2. Procedural Cubes Keyframing (cubesKeyFraming): Demonstrates pure mathematical coordinate translation, scaling, and rotation transformations keyframed over time across a multi-object mesh grid.
3. Jelly Ball Soft-Body Dynamics (jellyBall): Focuses on continuous deformation physics, squash-and-stretch behaviors, and pressure solvers mimicking organic/elastic soft-body objects impacting static colliders.

---

🛠️ Project Structure

The codebase is organized into modular directories under the source control layout to isolate specific algorithmic workflows:

Blender-Animation-Toolkit/
├── assets/
│   ├── Animation1.mp4       # Video capture of the beach ball setup
│   ├── Animation3.mp4           # Video capture of the procedural keyframing run
│   └── Animation2.mp4       # Video capture of the soft-body deformation sequence
├── src/
│   ├── beachBall/
│   │   ├── bco602tk.py          # Toolkit
│   │   └── beachBallAnimation.py# Core script
│   ├── cubesKeyFraming/
│   │   ├── bco602tk.py          # Toolkit
│   │   └── cubesKeyFraming.py   # Core script
│   └── jellyBall/
│       ├── bco602tk.py          # Toolkit
│       └── jellyBallAnimation.py# Core script
├── .gitignore
└── README.md                    # Main landing page documentation