Avatar

3D Importer


The 3D Importer allows you to import .fbx, .gltf, or .obj 3D models into Studio as a custom Model. This tool supports a wide variety of 3D models, including:

The 3D Importer is divided into three sections:

3D Importer Panels

A. The preview panel, located in the top left, allows you to rotate and examine 3D objects before importing into your workspace or Toolbox.

B. The hierarchy panel, located in the bottom left, allows you to select specific parts of your model to import or apply specific settings to, including textures, child objects, animations, or rig data.

C. The inspector panel, located on the right, allows you to apply various settings to the imported object.

Importing 3D Objects



Before importing a 3D object, ensure that the .fbx, .gltf or .obj meets Studio's Mesh Requirements to reduce errors or unexpected behavior.

To import a 3D object:

  1. In the Home or Avatar tab, click Import 3D. A file browser displays.

    Import 3D button indicated in Avatar tab
  2. Select the .fbx, .gltf or .obj you intend to import. The importer window displays.

  3. Verify the object preview and check that the import settings are correct for your object.

  4. Click Import.

Import Settings

Depending on the object selected in the hierarchy panel, the inspector panel displays the following groups of settings:

  • File General: Affects the entire imported file.
  • Rig General: Affects the selected mesh object if rigging data is present.
  • File Transform: Affects the transform properties of the imported file.
  • File Geometry: Affects the geometry properties of the imported file.
  • Object General: Affects the selected child object.
  • Object Geometry: Affects the geometry of the selected child object.

File General

The 3D Importer provides the following settings for all meshes:

SettingDescription
NameSets the name of the imported asset as it will appear in your project.
Import Only As ModelIf enabled, the 3D Importer imports the model as a single asset even if the model contains multiple children. By default, this is enabled.

If disabled, the 3D Importer imports the model and all descendants, such as the multiple meshes, as individual assets.
Add Model To InventoryIf enabled, the 3D Importer adds the model to your Toolbox / Asset Manager inventory as a new asset. By default, this is enabled.

If disabled, the 3D Importer does not add the asset to your inventory.
Insert In WorkspaceIf enabled, inserts the model into the Workspace and Toolbox/Asset Manager. By default, this is enabled.

If disabled, only adds the model to the Toolbox/Asset Manager.
Insert Using Scene PositionIf enabled, uses the current scene position when inserting the model into the workspace. By default, this is disabled.
Set Pivot to Scene OriginIf enabled, sets the pivot point of the entire model to the scene origin. By default, this is enabled.
AnchoredIf enabled, sets the Anchored property to True on all the imported MeshParts. This is disabled for meshes with rig data / avatars. By default, this is disabled.
Uses CageIf enabled, the 3D Importer finds cage meshes in the model and converts them to WrapInstance objects, such as WrapLayer or WrapTarget. If disabled, the importer treats them as regular meshes. If the 3D Importer initially detects cage meshes in the model, this is enabled by default.

Rig General

The 3D Importer provides the following settings for meshes with rigging data:

SettingDescription
Rig TypeSets the type of rig the mesh should be associated with. The options are:
- R15
- Custom
- No Rig

By default, the 3D Importer attempts to select the most appropriate setting based on the detected rigging and skinning data of the mesh.
Validate UGC BodyAfter importing, Studio opens the assets in the Avatar Setup tool, allowing you to quickly begin testing and uploading avatar assets to the Marketplace.
Rig ScaleIf Rig Type is set to R15, the importer provides further options to specify body type scaling. The options are:
- Default
- Rthro
- Rthro Narrow

File Transform

The 3D Importer provides the following settings for all meshes:

SettingDescription
World ForwardSets the forward facing axis of the object. By default, this is set to Front.
World UpSets the upward facing axis of the object. By default, this is set to Top.

File Geometry

File geometry includes information on the file dimensions and polycount of the entire model. You can edit the following settings for all meshes:

SettingDescription
Scale UnitSets what units the file was modeled in so that it's sized appropriately when imported. By default, this is set to Studs.
Merge MeshesIf enabled, merges all MeshParts in the model into a single MeshPart and creates one MeshPart rather than a Model. By default, this is disabled.
Invert Negative FacesInverts the orientation of negative faces in the mesh. By default, this is disabled.

Object General

When selecting a specific child object of your mesh, the 3D Importer populates Object General settings. You can edit the following settings for the selected child objects:

SettingDescription
NameSets the name of the selected child object within the model.
AnchoredIf enabled, sets the Anchored property to True on the selected child object. By default, this is disabled.
Use Imported PivotIf enabled, imports the object using the pivot point set within the child object. By default, this is enabled.

Object Geometry

Object Geometry includes information on the dimensions and polycount of the selected child object of the model. You can edit the following settings for the selected child objects:

SettingDescription
Make Double SidedIf disabled, sets the vertices as one-sided. One-sided vertices means that you can see through them from one side.

If enabled, sets the vertices as double-sided. Vertices that are double sided visually render on both sides. Double-sided is more performance intensive.

By default, this is disabled.
Ignore Vertex ColorsIf enabled, ignores the vertex color data in the child object. By default, this is disabled.

Warnings and Errors


If Studio detects any issues with your model, a small indicator displays in the hierarchy panel or the settings panel.

If you see a warning icon in the hierarchy, expand the hierarchy until you reach the specific child object to see more information about the issue. Warning and error messages display in the settings panel or as a tooltip.

Warning and error messages display in the appropriate section in the inspector panel.
Some errors display a tooltip when hovering over the error icon.