Softbody skinning

Softbody simulation and rendering are taken care of by two separate components: ObiSoftbody (simulation) and ObiSoftbodySkinner(rendering). The former generates a particle-based representation of a mesh. The latter skins an arbitrary mesh to that particle-based representation, so that they move and deform together.

Using two separate components lets you decouple simulation and rendering, which is oftentimes very useful. Also please note that you're not forced to have a single ObiSoftbody skinner for each ObiSoftbody. You can skin multiple meshes to a single softbody, using multiple ObiSoftbodySkinners.

Obi Softbody Skinner

This component performs automatic skinning of a target SkinnedMeshRenderer to the softbody particles. This is done by searching for the closest particles to each mesh vertex and assigning distance-based weights. You can control how this distance weighting is performed using the following parameters:

This is how ObiSoftbodySkinner's inspector window looks like:

Source softbody

The softbody to skin this object's SkinnerMeshRenderer component to.

Generally, you want this object's renderer to use the same mesh you provided as Input Mesh for particle generation. However this is not a must. You can use entirely different meshes for particle generation and rendering.

Softbody Influence

Global percentage of softbody influence on the skinning. A value of 0 will keep the original skinning, if any. A value of 1 will fully skin vertices to the n-closest particles within Skinning Max Distance of them. Intermediate values allow you to blend between fully animated and fully simulated skinning.

You can paint influence per-vertex using the "Paint Influence" button. In this case, the global softbody influence parameter will act as a multiplier of the per-vertex influence you paint.

Max Bones per Vertex

Maximum amount of bones that can influence a single vertex.

Note that by default, Unity supports only up to 4 bones per vertex. You need to configure your settings to allow for more than 4 bones, otherwise Unity will throw an error at runtime when this property is set higher than 4.

Skinning Falloff

Intensity of the skinning falloff. A value of 1 means linear falloff, larger values increase falloff exponent, thus giving more weight to particles closer to the vertex.

Skinning Max Distance

Maximum distance to consider when skinning each vertex. Particles further away than this distance will not be considered, so usually it's a good idea to use a value large enough for all vertices in the mesh to be within this distance from their nearest particle.

Once you click "Bind Skin", Obi will skin the mesh to the softbody particles.

If you re-generate the softbody blueprint but do not re-bind the skin, skinning will look incorrect. You want to Generate the blueprint first, then Bind the skinner, in that order.