From BlenderWiki

Jump to: navigation, search

If you want to document Blender 2.5 features please edit pages under Doc:2.5/Manual.

If a "2.5" page doesn't exist please copy the text from 2.4x Manual and edit the new page (i.e. you should paste the wikitext from this 2.4x page to this new 2.5x page and then update the latter with 2.5 features)

There are two different collision types that you may use: collision between different objects and internal collision. We should set one thing straight from the start: the primary targets of the collision calculation are the vertices of a Soft Body. So if you have too few vertices too few collision takes place. Secondarily, you can use edges and faces to improve the collision calculation.

[edit] Collisions with other objects

Image 1: Settings for a collision object.

For a Soft Body to collide with another object there are a few prerequisites:

  1. Both objects have to share a layer, but the layer does not necessarily have to be visible.
  2. The collision object has to be a mesh object.
  3. You have to activate the option Collision in the Collision panel of the Physics sub-context (Image 1) for the collision object. The collision object may also be a Soft Body.
  4. If you use modifiers such as Array and Mirror you have to activate EV.M.Stack to ensure that collision calculation is based on the modified object. The sequence of Modifiers is not important.


[edit] Motivating examples

Image 2a: A Soft Body cube colliding with a plane.
Image 2b: A Soft Body plane colliding with a cube - no interaction at all.
Image 2c: Collision with CFace activated.

A cube colliding with a plane works pretty well (Image 2a), but a plane falls right through a cube that it is supposed to collide with (Image 2b). Why is that? Because the default method of calculation only checks to see if the four vertices of the plane collides with the cube as the plane is pulled down by gravity. You can activate CFace to enable collision between the face of the plane and the object instead (Image 2c), but this type of calculation takes much longer.

Let’s have a closer look at the collision calculation, so you can get an idea of how we might optimize it.

[edit] Calculating the collisions

Image 3a: Visualization of the collision of a Soft Body vertex with a plane.
Image 3b: Six Soft Body vertices with different speed.
Blend file

Soft Body simulation is by default done on a per vertex basis. If the vertices of the Soft Body do not collide with the collision object there will be no interaction between the two objects.

In (Image 3a), you can see a vertex colliding with a plane. If a vertex penetrates the zone between Outer and Inner, it is repulsed by a force in the direction of the face normal. The position that a vertex finally ends up in is dependent on the forces that act upon it. In the example gravity and the repulsion force of the face balance out. The speed at which the vertex is pulled out of the collision zone is influenced by the Choke parameter (Image 4).

Now lets see what happens if we make vertices heavier and let them travel at a faster speed. In (Image 3b), you can see vertices traveling at different speeds. The two on the far right (5 and 6) are traveling so fast that they pass right through the collision zone (this is because of the default solver precision - which we can fix later). You will notice that the fourth vertex also travels quite fast and because it is heavier it breaches the inner zone. The first three vertices collide OK.

Image 3d: Also Edges and Faces can be used for the collision calculation.

You can set up your collision so that edges and even faces are included in the collision calculation (Image 3d). The collision is then calculated differently. It is checked whether the edge or face intersects with the collision object, the collision zones are not used.

[edit] Good collisions

Image 4: Parameters for Soft Body calculation.

If the collision you have set up is not behaving properly, you can try the following:

The best way:
Add Loop Cuts to your Soft Body object in strategic areas that you know are most likely to be involved in a collision.


  • The Soft Body object must have more subdivisions than the collision object.
  • Check the direction of the face normals.
  • If the collision object has sharp spikes they might penetrate the Soft Body.
  • The resolution of the solver must match the speed at which Soft Body vertices are traveling. Lower the parameter Error Lim and carefully increase Min S.
  • Outer and Inner should be large enough, but zones of opposite faces should not overlap, or you have forces in opposite directions.
  • If you use strong forces you should use large zones.
  • Set Choke to a high enough value (all the way up if necessary) if you have difficulties with repelled vertices.
  • Colliding faces are difficult to control and need long calculation times. Try not to use them.

Often it is better to create a simplified mesh to use as your collision object, however this may be difficult if you are using an animated mesh.

[edit] Self Collision

Well, this works pretty well if you simply turn it on. See the Reference page for a detailed explanation of the parameters.