Outfits - Mustard2/MustardUI GitHub Wiki

The panel is divided into the following sections:

• General Settings
• Optimization Settings
• Outfits List (How to add Outfits)
• Global Properties
• Custom Properties
• Extras

Additional features:

• Mask Support

General Settings

In this section, you can configure some general outfit settings:

• Nude Outfit
  Enable or disable the Nude "outfit" in the Outfits list. Useful for SFW models.

• Physics Support
  Adds a physics button near all outfit pieces with Cloth, Soft Body, or Collision modifiers. The physics frames of outfits are affected by changes in the Cache panel (if enabled).

• Add Objects in Sub-collections
  Includes sub-collections of the main outfit collection when creating the list of outfit pieces.

Optimization Settings

These options allow MustardUI to optimize outfit performance when outfits are switched on/off. Tested to improve performance, especially with many outfits:

• Disable Armature Modifiers on Switch
  Disables Armature modifiers when the outfit is not in use.

• Disable Heavy Modifiers on Switch
  Disables heavy modifiers (Smooth Correction, Subdivision Surface, Shrinkwrap) on switch.

• Disable Shape Keys (and Drivers) on Switch
  Disables shape keys and their drivers when the outfit is not active.

• Update Drivers on Switch
  Updates drivers on switch. Recommended to keep enabled unless switching outfits causes driver issues. This doesn’t affect viewport performance but may speed up outfit visibility operators if disabled.

Note
Some options require manually switching an outfit in the list (out of Configuration mode) to apply optimizations. For Extras outfits, you may need to make them visible and then hidden again. This procedure should be done only once after enabling optimization features.

Outfits List (How to add Outfits)

To add an outfit:

1. Right-click on a Collection containing the outfit pieces.
2. Click Add Outfit.

The outfit will then appear in the list and be visible in the UI.

Available buttons:

• Move outfits up/down in the list (affects UI order).
• Rename the outfit (see MustardUI Naming Convention at the bottom).
• X Button: Removes the outfit from the UI.
• Trash Button: Removes and deletes the outfit, including its collection and objects from the Blender file.

Global Properties

Global properties work like the Body section, allowing quick enabling/disabling of selected settings for all outfits.

Custom Properties

You can add additional properties to the outfits by right-clicking on any Blender property. Options are similar to Body Custom properties:

After adding custom properties, a panel appears with similar settings to the Body Custom properties.

As for Body Custom Properties, it is also possible to link several properties in order to control them with one unique property.

Single Custom Properties Settings

Some settings are self-explanatory for individual custom properties. Some particularly useful options are:

• Force type
  FLOAT properties to behave as INT or BOOLEAN.

• Actions on Switch
  When set to Enable/Disable, the custom property will automatically be set to its maximum value or 0, respectively, when the outfit or outfit piece is switched on or off.

Extras

Extras are collections of objects not affected by outfit selection.
The same procedure for additional properties can be applied to Extras objects.

Mask Support

Masks can be activated based on which outfit piece is visible.

To use this feature:

• Name your Mask modifiers to include the full and exact Object name of the outfit piece.
• If one Mask modifier serves different Outfits, add all the exact Object Outfit names separated by |.