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 them 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 PC, 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:

Tool Checkpoint Description Troubleshooting Steps
Layers check Checks for extra layers in your project. Clicking the button automatically removes non-active layers.

If automatic fix fails:
  • Manually remove unused layers.
Transform check Checks clothing geometries transform values. Clothing transform values should be zero.
Clicking the button attempts to automatically freeze the transform values. In most cases, you should resolve this manually as transforms may freeze in incorrect positions.
Unused Materials check Checks for unused data, such as Orphan Data (Blender) or Construction History (Maya). Clicking the button automatically clears unused data, such as data-blocks.

If automatic fix fails:
  • Manually remove unused project data.
Keyframe check Checks for any animation keyframes in the project. Clicking the button automatically clears keyframes.

If automatic fix fails:
  • Manually remove keyframe and animation data.
Attachment position and name check If an attachment is present, the tool checks if the appropriate Parent Bone is associated with it.

Attachments are optional and do not need to be included with your clothing model on export. The correct attachment point is automatically generated when converting the model into an accessory in Studio.
Clicking the button automatically parents the bone to the correct joint, based on attachment name.

If automatic fix fails:
  • Check that attachment objects are properly named and include the _Att suffix.
  • Double check parenting and armature naming conventions.
Cloth intersections check Checks that the Inner and Outer Mesh are not intersecting with the accessory mesh.

This check is meant to suggest points of the asset that may intersect with the cage objects and cause issues in final rendering in Studio. You should always test assets in Studio to ensure final accessory appearance.
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.
Image format Checks for appropriate texture file structure. This tool checks:
  • Texture file is a .png.
  • Color depth is 24-bit for albedo and normal textures.
  • Color depth is 8-bit for grayscale, metalness, and roughness textures.
  • Resolution of texture must be between a square between 256-1024 pixels.



This check also verifies proper file naming convention (for use in automated texture importing in Studio):
  • Project Files must include LCL_ as a prefix.
  • Texture Files in the directory must start with TXT_LCL prefix and end with an appropriate PBR texture suffix, such as _ALB, _MTL, _RGH.
This issue must be resolved manually by the user.
To resolve this issue, ensure that the texture image format meets Roblox's texture requirements.

See Texture Requirements for additional details.