Physics Panel - Mustard2/MustardUI GitHub Wiki

If the author of the model provides physics support, this panel may be available. Clicking the button next to the panel name will activate or deactivate all model physics with a single click. For more fine-grained control, a list of individual physics items is available (see below).

Physics Items List

The Physics Items list shows all available physics-enabled objects. The icon next to each item indicates its type:

  • Sphere: Cage โ€“ Drives the motion of other objects through Mesh or Surface Deform modifiers.
  • Collision โ€“ An object used as a collision surface for other physics objects.
  • Cartesian axes: Single Item โ€“ Physics modifiers affect only this object.
  • Bone: Bone Driver โ€“ Physics applied to bones to drive their motion.

Item Buttons

  1. Enable physics for this specific item.
  2. Enable collisions for this object.
  3. Show/hide the physics object.

Note
Collisions are controlled by the first button.

Settings

  • Influence โ€“ For some physics types, this adjusts the strength of the simulation driven by cages.
  • Mirror โ€“ Mirrors the settings of an object if a corresponding right/left object exists in the physics list.
  • Other settings are standard Blender physics options. See Blender documentation for more details.

Cache

This panel allows you to bake the simulation for all objects in the scene (not just those listed in the UI).

  • Changing the frame range will update the start/end frames for the objects in the UI, provided Unique Frames is not enabled.

Troubleshooting

  • Collision meshes not working
    Collisions may fail if the collision mesh is hidden. Make it visible by clicking the cage button next to the collision object. After baking, the collision cage can be hidden again.

    Note: This is a known Blender bug.

  • Odd cage behavior
    Cages may behave strangely if the body or outfit mesh is modified via morphs, shape keys, or sculpting/edit mode.

    Most issues can be solved by rebinding. A Rebind button is available in the Physics Panel to rebind all Mesh/Surface Deform and Smooth Correction modifiers associated with the physics items.

  • Full body collision cage issues
    If a full-body collision cage exists and Collision Collections are not assigned to other cages, distorted or odd physics may occur.

    To fix this, create a collection and assign it as the Collision Collection in the Collision settings of the physics item (either in MustardUI or Blenderโ€™s standard Physics settings).