FAQs - Mustard2/MustardUI GitHub Wiki

Do I have to install something to use the UI?

To use the UI, you need to install the MustardUI addon from the Blender Extensions website.

After appending the model, I can’t see the UI

Check if Viewport Model Selection is enabled. Click on the Armature of the appended object and look for the Model Selection panel in MustardUI.

If MustardUI still does not appear, try saving the model and restarting Blender. Sometimes creators forget to disable Configuration Mode, and this procedure should fix it.

Morphs are not preserved when I disable them

By default, disabling Morphs also disables shape keys to increase performance.

Tip: You can change this behavior by disabling the Mute Shape Keys setting. See the Morphs Panel for details.

My shape key drivers are not working when I disable the Morphs

By default, all drivers are disabled when Morphs are turned off to improve performance. To keep specific drivers active, add the string MustardUINotDisable to their names.

For example, if a shape key named Hand has a driver, rename it to MustardUINotDisable Hand to ensure the driver continues working even when Morphs are disabled.

Armature Modifiers are turned off when switching Outfits / Outfits are not following the Armature

Armature modifiers impact performance even if the linked object is hidden. MustardUI automatically disables the Armature modifiers of unused outfits when switching outfits.

If you manually enable/disable collections in the Outliner, those outfits will not follow the Armature because the modifier is disabled.

To fix this:

  • Manually enable the Armature modifier; or
  • Switch to another outfit in MustardUI and back. This will restore the correct modifier status.

Tip: To disable this automatic feature, enable Advanced Options (Settings panel) and turn off the option in the Outfit panel.

Can I modify MustardUI myself? Even if the model has been created by someone else?

Yes! The Configuration panel is available in Settings (if Maintenance Tools is enabled). Click the UI Configuration button to start modifying the UI.

More information is available in the GitHub Configuration Guide.