Outfits - Mustard2/MustardUI GitHub Wiki

The panel is divided in following sections.

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

Additional features:

• Mask Support

General Settings

In this section we have some General Settings:

• Nude outfit: turn on/off the Nude "outfit" in the Outfits list, which can be useful for SFW models
• Physics Support: if enabled, a physics button is added near all outfit pieces with a cloth, soft body or collision modifier. Moreover, the physics frames of the outfits are affected by changes in the Cache panel in the Physics panel (if enabled)
• Add Objects in sub-collections: if enabled, also sub-collections of the main outfit collection are considered to create the list of outfit pieces
• Additional Outfit Options: as for the Body additional options, you can name shape-keys and specif nodes to make some options appear in the UI. This is a global switcher for Oufit additional options: if disabled no additional option will be shown in the UI.

Optimization Settings

In this section some options can be enabled to let MustardUI optimize some features of the Outfits while they're switched on/off. All these settings has been tested and they can improve the performance of the model, especially if there are a lot of outfits.

• Disable Armature Modifiers on Switch: disables the Armature modifiers when the Outfit is not in use
• Disable Heavy Modifiers on Switch: disables some heavy modifiers on switch (Smooth Correction, Subdivision Surface and Shirnkwrap only)
• Disable Shape Keys (and their drivers) on Switch: disables the shape keys and their drivers when the outfits are not in use
• Update Drivers on Switch: updates drivers on switch. It is adviced to left this on, unless there are some problems with the drivers when switching on/off the outfits. This does not change the viewport performance, but might speed up the outfit visibility operators if switched off

Note: Some options require to manually switch any Outfit in the Outfit list (out of Configuration mode). This is because the optimizations are enabled only on the Outfit switch. The same for the Extras outfits, to enable the optimizations you might need to make them visibile and back to hidden. This procedure should be done only once after enabling the Optimization features.

Outfits List (How to add Outfits)

The next part is the Outfit List. To add some outfits, just click on a Collection containing the outfit pieces and click on Add outfit.

The Outfit then appears in the list and is shown in the UI.

There are several buttons:

• the first two buttons can be used to move the Outfits in the list (the order in this list is used as the order in the UI)
• a button to rename the outfit (see the bottom part of MustardUI Naming Convention
• the X button removes the Outfit from the UI
• the trash button removes and delete the Outfit from the UI. This means that the collection and the Objects are completely deleted from the Blender file

Global Properties

Similarly to Body, the Global properties add some options in the UI to quickly enable/disable the selected settings on the Outfits

Additional properties

Analogously to the Body section, you can add additional properties right-clicking on any Blender property. See Body custom properties for the options in the menu that appears when right clicking.

Note that you can add custom properties to the single outfit pieces, but also as global options of the outfit. For the latter, the custom property will appear on top of all outfit pieces in the Outfit panel of the UI.

After adding the custom properties, a panel will appear.

The options are similar to the body panel (see above), with the exception of the possibility to select the outfit in the settings, if needed.

Extras

Finally, you can specify an Extras collection, which will be a collection of objects in the UI not affected by the choice of the Outfit.

Note: the same procedure for additional options can be applied also to the Extras objects.

Mask Support

With this feature, masks on the body can be activated depending on which Outfit piece is visible.

In order to use this feature, name your Mask modifiers with something that contain the outfit full object name.