Physics Panel - Mustard2/MustardUI GitHub Wiki

Physics can be activated or deactivated with the main control button.

For more fine-grained control, a list of individual physics items is available (see below).

Note
The Physics panel is available if the model creator enabled the support.

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. Enable Smooth Correction modifiers for this item.
  4. Show/hide the physics object in Viewport.

Settings and Tools

  • Influence: For some physics types, this adjusts the strength of the simulation driven by cages.
  • Re-bind All Cages: Re-bind the Physics cages in case of issues. See the Troubleshooting section below for more information.
  • Mirror: Mirrors the settings of an object if a corresponding right/left object exists in the physics list.
  • Presets: Call saved settings for the specific Physics Item. See the Morphs section for more information about the Presets.
  • 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.

    Note
    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.

    Note
    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).