Blender's built-in cloth solver falls apart under close contact and layered fabric. It self-intersects, glitches through itself, and explodes stacked cloth. ZOZO's contact solver is an open-source engine with a permissive license that handles tight contact and multiple fabrics with zero self-intersection. This guide covers two things: how to install it, and how to set up a basic working sim. Nothing else.


Before you start

Blender 5.0 or newer. The extension pins a 5.0 minimum. Older builds will refuse to enable it.

The solver needs an NVIDIA GPU with CUDA 12.x. The add-on is only a client and runs on any machine, including macOS. The actual simulation runs on the solver engine, and that part requires an NVIDIA GPU. Plan for this before you start.

Links


Step 1: Install the add-on

Two ways. The remote repository is recommended because Blender keeps it updated for you. The manual script is for offline or development use. Pick one.


Step 2: Deploy the solver

The solver binary is not bundled with the add-on. You build or deploy it separately from the repo, then point the add-on at it. The add-on looks for ppf-cts-server (ppf-cts-server.exe on Windows Native) at the connection path you set. Choose the connection type that matches your hardware: Windows Native if you have a local NVIDIA card, otherwise Docker or SSH to an NVIDIA machine. The connections page covers each option in full.