Importing Clothing Accessories

Use the following instructions to import your .fbx or .gltf third-party model into Studio and convert the asset to a clothing Accessory object that you can save to use in your experience, share with others, or upload to the Marketplace.

Importing 3D Assets

Studio's 3D Importer provides a quick and easy way to import third-party 3D assets into your projects. The importer provides object previews and error-checking to ensure that your asset meets Roblox's general 3D requirements.

Keep in mind, your 3D layered accessory must also follow Roblox's Clothing Specifications to eventually use this asset as a layered Accessory, or you may experience errors later in the workflow.

To import your asset:

  1. In Studio, navigate to the Avatar tab and select the 3D Importer.

  2. In the file browser, select the .fbx or .gltf file saved locally. The 3D Importer loads a preview of the object.

    • If textures don't load for your asset, you can manually import your textures later.
    • See 3D Importer for additional information on import settings and troubleshooting.

  3. Select Import. The asset populates in your workspace as a Model with the appropriate textures applied as a SurfaceAppearance or MeshPart.TextureID.

If textures didn't load correctly, add them manually. You may need to save and publish your experience in order to access the Asset Manager.

  1. Open the Asset Manager. You may need to save and publish your experience before accessing your assets.

  2. In the Asset Manager, select the Bulk Import button.

  3. Upload your image files.

  4. After moderation clears for your image, select the MeshPart parented within your imported Model.

  5. If you are using a single basic texture, set the MeshPart.TextureID property to your uploaded texture image.

  6. If you are using PBR Textures:

    1. Add a SurfaceAppearance child to your MeshPart.

    2. In the SurfaceAppearance properties, click each property value and assign the appropriate texture image from the asset dropdown:

      1. Set the ColorMap to the _ALB texture image.
      2. Set the MetalnessMap to the _MTL texture image.
      3. Set the NormalMap to the _NOR texture image.
      4. Set the RoughnessMap to the _RGH texture image.

Converting Layered Accessories

With the Model in your project, the last step in the process of clothing creation requires you to use the Accessory Fitting Tool to convert this object to a standard Accessory that avatar characters can equip.

To generate the accessory object:

  1. In the Avatar tab, select the Accessory Fitting Tool. The Accessory Fitting Tool panel displays on the left side of the workspace.

  2. Select the Model of the clothing item in the viewport. The tool's text field populates with the name of the object selected. Alternatively, you can select the object within the Explorer window.

  3. Test out various sample characters, clothing, and animations. See Testing Accessories for additional information.

    • If required, make minor cage adjustments using the editing features. Larger cage changes may require returning to your third-party modeling software and re-exporting the asset.

  4. When ready to generate your accessory, click Generate MeshPart Accessory. The Accessory object with your model populates in your workspace. For additional information and documentation on the tool, see Accessory Fitting Tool.

    Clothing accessory in Workspace
    Clothing accessory in Explorer

After successful fitting and converting, your 3D model should populate in your project as an Accessory. With this Accessory you can perform any of the following:

  • Begin the process of uploading and publishing the clothing accessory to the Marketplace.

  • Use the accessory in your current experience by equipping it to character models with HumanoidDescription, or by dragging and dropping the accessory under the appropriate character Model object.

  • Save the accessory to your Toolbox or make it public on the Creator Store to share or use within any of your experiences.