Body - Mustard2/MustardUI GitHub Wiki
The panel is divided in following sections.
Global Properties
The properties in this section enables some buttons in the UI that can automatically switch on/off the selected properties.
Note: The modifiers and the Auto-Normals are switched off only for the current model.
Note: The Eevee Optimized Normals tool changes the Normal nodes of all materials in the scene. It should be switched off when using Cycles, otherwise artifacts might appear in the scene.
Custom properties
You can also add Custom Properties to the Body panel. To do so, remember to go in Configuration mode, and then right click on any Blender property and a menu like the following will appear.
There are a couple of functions:
- Add to MustardUI (Un-sorted): adds the custom property to the body properties, but do not add it to any section
- Add to outfits name: the custom property will be added to the specific outfit instead. This button has been added to simplify the addition of new properties to the single outfit pieces, and it will be available only when you select in Viewport an outfit piece that has been added to MustardUI (see below how to add outfits). More about outfits custom properties below
- Add to MustardUI (Section): similar to Add to MustardUI (Un-sorted), but you will be asked to specify the section where to add the custom property. This button has been added to simplify the addition of custom properties to specific sections, and will appear only if a section has been already created. Note that you can always change the section of any property (see below)
- Add to MustardUI Outfit/Hair: these two buttons are similar to the previous one, and you will be asked to specify the Hair or Outfit where to add the custom property
- Link to Property: with this button you can link the selected property to a property that has already been added to MustardUI. This is useful to create only one button/slider in the UI which will be modify the custom property and all its linked properties. Obviously, you can link only properties with the same data type (e.g. you can not link COLOR properties with BOOLEAN properties)
Custom properties panel
After you add the custom property to the UI, you can modify their settings in the Configuration menu. The panel will look like
From this panel you can:
- use the operator Custom Properties Smart Check (see next paragraph), which is the one with the looking glass icon
- modify the order of the custom properties
- delete custom properties
- change its settings. Depending on the data type of the property, you can change min/max value, default value, description. Moreover, you can force the type of FLOAT properties to be INT or BOOLEAN. This might be useful for instance if you have a material node value (which is always FLOAT in Blender), but you want it to be a switcher of some effects (BOOLEAN), or the index for choosing a particular texture (INT), instead of a continous value slider. At the bottom you can also see the list of linked properties, which you can remove if needed.
Finally, you can enable:
- show the icons in the UI (not advised if you use sections, because it can clutter the UI)
- sort the properties by name instead of the order in the custom properties list
Custom Properties Smart Check
If you already set up your materials in 0.20, or you simply don't want to manually re-add each time all properties to the UI, you can use this operator to add in one click all properties you want from your materials/shape keys. In order for the operator to find the correct values to add to the UI, you should follow this convention in naming the nodes/shape keys:
- if you want to add a shape key, rename it as "MustardUI Float - " + name of the property you want to show in the UI, if the property is float, or "MustardUI Bool - " + name of the property you want to show in the UI, if you want the property to be a Boolean value (a check in the UI).
- if you want to add a slider or a check from any of the Body materials, add a Value node in the Node Editor of the material and rename it as "MustardUI Float - " + name of the property you want to show in the UI, if the property is float, or "MustardUI Bool - " + name of the property you want to show in the UI, if you want the property to be a Boolean value (a check in the UI).
- if you want to add a color from any of the Body materials, you can also add a RGB node. In this case, rename it as "MustardUI - " + name of the property you want to show in the UI (therefore without any Bool/Float).
Sections
You can assign the additional properties loaded above with sections.
Once created, you can sort them, modify their settings and assign the properties as in the figures below. Note that the section box will appear only if the number of additional body properties is > 0.
Each option can be assigned to only one section. If a property is not assigned to any section, they will be automatically listed as material or body (shape key) properties.
Additional Options:
- Add Geometry Nodes: Enabling this option, the Geometry nodes of the Body object are added to the Body as sections with hide/show buttons. Moreover, the Geometry Node attributes are listed