Creator Tools Physics - Mustard2/MustardUI GitHub Wiki

Physics tools for creators are available.

Hair Cage tool

Create a cage around a very dense mesh, in order to get cheaper physics simulations. One notable example is the hair, from which the name of the tool.

Example video.

Jiggle Cage tool (Quick)

Tool to quickly create a jiggle cage from the selection of vertices on edit mode. This cage might be good if no collision with the body mesh is expected, otherwise more precise solution than this tool might be preferred.

[!TIP] If the direction of the pin group is inverted, try to use the opposite sign, e.g. "-Y" if you tried "+Y". If needed, you can also change the axis, e.g. "+Z" if you need the pin group to increase from up up to down.

[!WARNING] Sometime the cage generation might fail to bind, and it happens if the model body has dependency cycles. This is not a bug of the tool, but a Blender constraint to avoid the Surface Deform modifiers to create further dependency cycles. In order to solve the issue, the dependency cycles must be fixed, and then the cage generation can be re-attempted.

Jiggle Cage tool (Accurate)

Similar to the tool above, a jiggle cage is created, with more accuracy than the previous tool. This can be used if advanced collisions are needed, at the cost of a bigger viewport overhead.

This tool can also be used to quickly add accurate physics to any outfit.

Bone Physics tool

Tool to assign cloth physics simulation to a chain of bones. There is also an option to create bone physics for several disconnected bone chains.

[!WARNING] Do NOT parent the armature to the model armature by Child Of constraints: this will break the Bone Physics tool! Use the correct Parent option in Blender. For instance, in the video above, select the Hair Armature in Object mode (not in Pose mode!), select the head bone, press Ctrl + P and select Bone.

Collision Cage tool

Tool to create a cage collision from the selected object in Object mode, or from part of a body using the vertices selected in Edit mode.

[!WARNING] Adding a whole body collision cage might create issues with the jiggle and other body cages, especially if those collides at frame 0 by default. It is highly suggested to create a Collection and assign it to all cages that collides with the body collision cage, as the Collision Collection in the Physics settings. In this way only the object within this collection will act as colliders. For instance, cages for thighs collides with full body collision cages, and should have a Collision Collection assigned; but a hair cage might not need a Collision Cage as in general it does not collide with the body (and if it does, it can be quickly solved with a bit of sculpting).