Body - Mustard2/MustardUI GitHub Wiki

The Body panel contains all the properties related to the main character mesh. You can organize them into Global Properties, Custom Properties, and Sections.

Global Properties

Global Properties control buttons in the UI that automatically switch on/off certain model settings.

Note: Modifiers and Auto-Normals are switched off only for the current model.

Note: The Eevee Optimized Normals tool modifies the Normal nodes of all materials in the scene. It should be disabled when using Cycles to avoid rendering artifacts.

Custom Properties

You can add Custom Properties to the Body panel. To do this:

  1. Enable Configuration Mode.
  2. Right-click any Blender property. A menu like in the picture will appear.

Available options:

  • Add to MustardUI (Un-sorted)
    Adds the property to Body properties without assigning it to a section.

  • Add to Outfit Name
    Adds the property to a specific outfit. This is only available when selecting an outfit piece already added to MustardUI.

  • Add to MustardUI (Section)
    Adds the property to a section. You will be prompted to select the section. Only available if a section already exists.

  • Add to MustardUI Outfit/Hair
    Similar to the previous option, but assigns the property to a specific outfit or hair.

  • Link to Property
    Links the selected property to an existing MustardUI property.
    Useful to create one UI control that modifies multiple linked properties. Only properties of the same type can be linked (e.g., BOOLEAN → BOOLEAN).

Custom Properties Panel

After adding properties to MustardUI, you can modify them in the Configuration menu.

From this panel you can:

  • Use Custom Properties Smart Check (magnifying glass icon)
  • Modify the order of properties
  • Delete properties
  • Change settings based on property type, see panel below

Additional options:

  • Show icons in the UI (not recommended if using sections)
  • Sort properties by name instead of list order

Custom Properties Single Property Settings

In this panel several settings related to single custom properties can be modified.

At the bottom, it is also possible to manually modify the path of the custom property.

Note To apply the changes to the custom property path, rebuild the custom properties.

Custom Properties Smart Check

This operator automatically adds properties from your materials or shape keys to the UI.

Requirements: Follow the MustardUI naming convention for nodes/shape keys:

  • Shape Keys:
    • "MustardUI Float - PropertyName" for float properties
    • "MustardUI Bool - PropertyName" for Boolean properties
  • Material Values:
    • Value node: "MustardUI Float - PropertyName" or "MustardUI Bool - PropertyName"
    • RGB node: "MustardUI - PropertyName" (for color)

Sections

Sections allow you to organize custom properties in the Body panel.

It is also possible to flag a Section as Sub-Section, which will be shown in the UI accordingly. This can be done only if there is a Section above the current in the Sections list. Moving any Sub-Section above the parent Section will disable its status of Sub-Section.

Note
The section box appears only if at least one additional property has been added.

Assign Custom Properties

With the Assign button as in the image, Custom properties can be assigned to Sections.

  • Each property can belong to only one section.
  • Properties not assigned to a section will appear in the default material/shape key list.

Additional Options

  • Add Geometry Nodes: Adds the body’s Geometry Nodes as sections with hide/show buttons.
    Node attributes will also be listed as controllable properties.