Automatic Optimizations

MustardUI performs a number of optimizations to keep the Viewport responsive, especially with heavy models that have many outfits, morphs and modifiers. Most of these run automatically when the user interacts with the UI (e.g. switching an outfit) or with a single click through the Simplify panel.

The tables below list all the automatic optimizations, what they do, where the creator enables them in the Configuration panel, and where the user controls them. The user column can be:

• a link to where the user toggles it;
• Automatic (creator) — it happens on its own, based on what the creator enabled in the Configuration panel;
• Automatic (UI) — it is decided and applied by MustardUI itself.

Note

Optimizations are conservative by default: an optimization is only applied if the related feature is actually present on the model (e.g. a modifier type exists) and, in many cases, only if the corresponding Global Property is enabled.

On Outfit Switch

These optimizations run automatically every time an outfit piece is shown or hidden, so that hidden outfits stop costing performance.

Optimization	What it does	Creator setup	User control
Object visibility	Hides the piece in both Viewport and Render (hide_viewport / hide_render).	Always on	Outfits panel
Disable Shape Keys (and Drivers) on Switch	Mutes all shape keys of the hidden piece and their drivers; unmutes them when shown.	Outfits → Optimization Settings	Automatic (creator)
Disable Armature Modifiers on Switch	Disables the Armature modifier of hidden pieces in the Viewport.	Outfits → Optimization Settings	Automatic (creator)
Disable Heavy Modifiers on Switch	Disables Subdivision Surface, Smooth Correction and Shrinkwrap modifiers of hidden pieces (only those whose Global Property is enabled).	Outfits → Optimization Settings	Automatic (creator)
Update Drivers on Switch	Refreshes drivers and object tags after a switch so dependent values recompute correctly.	Outfits → Optimization Settings	Automatic (creator)
Body Mask modifiers	Enables/disables the body Mask modifiers tied to the outfit, so the body is masked only where needed.	Outfits → Global Properties / Mask Support	Outfits panel (Mask global)
Custom properties on Switch	Sets outfit custom properties flagged Enable/Disable on Switch to their max/default value when the piece is shown/hidden.	Outfits → Custom Properties	Automatic (creator)
Armature layers	Shows/hides the armature collections (bone layers) associated with the outfit.	Armature	Automatic (creator)

Collection Exclusion

To remove hidden content from dependency-graph evaluation entirely (not just hide it), MustardUI excludes whole collections from the View Layer when they are not in use.

Optimization	What it does	Creator setup	User control
Outfit collection exclusion	When an Outfit is changed, its collection is hidden and excluded from the View Layer.	Always on	Automatic (UI)
Extras collection exclusion	When all Extras are hidden, the Extras collection is hidden and excluded from the View Layer; re-included when an Extra is shown.	Always on	Automatic (UI)
Hair collection exclusion	When disabling the Hair panel or using Simplify, the Hair collection is hidden and excluded from the View Layer.	Always on or Simplify	Automatic (UI)
Hair switcher	Showing a hair-switcher outfit piece hides the main hair; hiding it restores the hair selection (only if no other switcher piece is still active), avoiding duplicate hair meshes.	Always on	Automatic (UI)

Eevee Viewport

Eevee Viewport performance can be improved by enabling some options.

Optimization	What it does	Creator setup	User control
Eevee Optimized Normals	Switches materials to the optimized normals nodes.	Body → Global Properties	Body panel

Simplify

The Simplify panel applies many optimizations at once with a single toggle. When disabled, the previous state can be restored automatically (Revert Settings on Disable), since the pre-Simplify settings are cached on the model. The Simplify tool must first be enabled by the creator in Tools Options.

Optimization	What it does	Creator setup	User control
Blender Simplify	Toggles Blender's native Simplify render setting.	Tools Options	Simplify panel
Eevee Optimized Normals	Switches materials to the optimized normals nodes.	Tools Options	Simplify panel
Body	Disables Subdivision Surface (Viewport), Smooth Correction, Geometry Nodes and Solidify on the body.	Tools Options	Simplify panel
Outfits	Disables the global Subdivision Surface, Mask, Smooth Correction, Shrinkwrap, Solidify and Triangulate properties; optionally switches to the Nude outfit.	Tools Options	Simplify panel
Extras	Hides all Extras.	Tools Options	Simplify panel
Hair	Hides the Hair collection (and excludes it) and disables the global Subdivision Surface, Smooth Correction, Solidify and Particles properties.	Tools Options	Simplify panel
Particle Systems	Disables particle system modifiers on the body and hair.	Tools Options	Simplify panel
Armature children	Hides objects parented to the Armature (except the Body and objects already handled as outfits/hair/extras/physics) and disables their heavy modifiers (Subdivision Surface, Shrinkwrap, Smooth Correction, Solidify, Particle System, Cloth).	Tools Options	Simplify panel
Morphs	Freezes Morphs (see below) or disables Diffeomorphic evaluation for Genesis models.	Tools Options	Simplify panel
Physics	Disables the model's physics.	Tools Options	Simplify panel
Globally Disable Physics	Disables Soft Body, Cloth and Collision modifiers on all scene objects.	Tools Options	Simplify panel
Globally Disable Particles	Disables particle systems on all scene objects.	Tools Options	Simplify panel

Morphs

Optimization	What it does	Creator setup	User control
Freeze Morphs	Mutes shape keys and drivers of frozen Morph sections. Frozen Morphs cannot be changed until unfrozen.	Morphs → Freeze Morphs	Morphs → Freeze Morphs
Automatically mute null Shape Keys	Adds drivers to the shape key mute buttons so Morphs with a null value are not evaluated in the Viewport.	Morphs → Automatically mute null Shape Keys	Automatic (creator)
Disable Morphs	Disables all Morphs and their drivers (Diffeomorphic models only).	Morphs → Disable Morphs	Morphs Main Switcher

Related manual tools

Some optimizations are not automatic but can be applied on demand by the model creator. See:

• Optimization Tools — Optimize Modifiers, Optimize Shaders, Optimize Shape Keys, Texture Solid Mode.
• Clean Model tool — permanently removes unused data to make the model lighter.