Avatar

Clothing Validation Tool

The Layered Clothing Validation Tool is a supplemental tool you can install in either Blender or Maya to help quickly identify and fix common issues with layered clothing assets before you export them.

Blender Validation Tool
Maya Validation Tool

While this tool can save you time in the typical iteration process between your 3D modeling program and Studio, the tool doesn't provide comprehensive verification of all aspects of layered clothing assets. You must ensure your layered clothing model meets both the general mesh requirements and Roblox-specific layered clothing requirements prior to importing it into Studio.

Installing the Validation Tool

There are two separate installation files and instructions for Blender and Maya.

Blender

To install the Clothing Validation Tool in Blender:

  1. Download ValidationTool_Blender.zip and save the .zip file locally.

  2. In Blender, navigate to Edit > Preferences.

  3. In Preferences, go to the Add-Ons section on the left side-bar.

  4. Click the Install... button. A file browser displays.

  5. Select the downloaded .zip file and click Install Add-On.

  6. In the Add-Ons section, find the Validation Tool and enable the add-on.

  7. Return to your workspace and expand the side toolbar in the Viewport to access the add-on.

    Sidebar indicator
    Expanded sidebar

Maya

Before you begin the process of installing the Validation Tool in Maya, you must install Python 3.0 or higher. If you already have Python installed, you can proceed to installing the Validation Tool.

To install Python 3.0+ on your device:

  1. Download the appropriate installer from the official Python website.

  2. Open the installer and follow the installation instructions.

    • Enable Add Python ### to PATH before selecting Install Now.

To install the Clothing Validation Tool in Maya:

  1. Download ValidationTool_Maya.zip and unzip the content in a local directory.

  2. Open the contents of the .zip file in a file browser.

    • If on Windows, double-click install.bat. This runs a batch script that enables you to quickly run the Validation Tool in Maya.

    • If on Mac, right-click the install.command file and select Open With > Terminal. This runs a terminal script that enables you to quickly run the Validation Tool in Maya.

  3. When prompted, type your Maya version and press Enter. For example, if using Maya 2020, input 2020 as your version.

  4. When installation is successful, the following message displays:

  5. Open Maya and navigate to Windows > General Editors > Script Editor.

  6. When using the plugin for the first time, in the Script Editor, type import ValidationTool then press the Play button in the top bar of the Script Editor. The plugin UI displays.

    • When using the plugin after the initial launch, launch the plugin by typing ValidationTool.validationTool() and clicking the Play button.

    • Alternatively, you can set up a shortcut from the plugin UI after initial launch by clicking the Create shortcut button on Maya shelf button.

Validating Assets

With the plugin active and a layered asset in your workspace, you can begin validating content. After the check, results with issues change to red (Blender) or yellow (Maya). You can resolve some failed checks by clicking the check button. See Checks and Troubleshooting Steps for details on each validation check.

Checks without issues display as grey (Blender) or green (Maya).
In this example, potential intersection issues are highlighted in the Viewport.

To use the Validation Tool on your asset:

  1. Select the object in your scene.
  2. Open the Validation Tool and click Check Assets. After a few moments, the UI updates and produces an output message.
  3. Results with issues are highlighted with red or yellow. Some issues can be automatically corrected by clicking the highlighted button.

Checks and Troubleshooting Steps

Refer to the table below for details on the specific checks and troubleshooting steps:

Layers
Checks for extra layers in the scene. Automatic fix attempts to remove extra layers.

If the automatic fix fails, manually remove extra layers.

Transforms
Checks that geometry location, rotation, and scale are frozen (0,0,0). Automatic fix attempts to freeze the transforms. This may cause changes to your rig.

If the automatic fix fails, manually freeze your geometry.

Unused Material
Checks for any unused data in the scene, such as orphan data (Blender) or construction history (Maya), or unused materials. Automatic fix attempts to remove extra data.

If automatic fix fails, manually remove unnecessary data and objects.

Keyframes
Checks for any unnecessary keyframes. Automatic fix attempts to remove keyframes.

If automatic fix fails, manually remove keyframe data.

Attachment Points
Checks that attachment points are present and use the correct naming convention. Automatic fix attempts to parent any unexpected attachment points.

Intersection
Checks for any intersection between character geometry and the inner/outer cage mesh geometry. In Blender, clicking the button switches to Edit Mode and highlights vertices that are intersecting the inner or outer mesh.

Some edges, such as edges of the holes for the sleeves, neck and torso edges, may be highlighted by default behavior and can be ignored.

Texture Format
Checks that textures match texture requirements, such as resolution size. Users can also select an external image file. Refer to the output messages to manually resolve any texture related issues.