You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
description: 3D Importer imports third-party .fbx, .gltf, and .obj 3D model assets into Studio.
4
4
---
5
5
6
-
<iframewidth="800"height="450"src="https://www.youtube-nocookie.com/embed/4RonlfpKzHA"title="YouTube video player"frameborder="0"allow="accelerometer; clipboard-write; encrypted-media; gyroscope; picture-in-picture"allowfullscreen></iframe>
7
-
<br />
6
+
The 3D Importer allows you to import `.fbx`, `.gltf`, or `.obj` 3D models into Studio as a custom `Class.Model`. This includes meshes with PBR textures, meshes with rigging, skinning, and animation data, and meshes designed as avatar items.
Use the 3D importer to import assets with avatar item components.
46
+
</Typography>
47
+
</Grid>
48
+
</Grid>
49
+
</Grid>
50
+
51
+
To import a 3D object:
8
52
9
-
The 3D Importer allows you to import `.fbx`, `.gltf`, or `.obj` 3D models into Studio as a custom `Class.Model`.
53
+
1. In the toolbar's **Home** or **Avatar** tab, click **Import 3D**.
54
+
1. Alternatively, use **File** > **Import 3D** to open up the Import 3D tool.
55
+
2. In the file browser, select the supported `.fbx`, `.gltf` or `.obj` files you intend to import.
56
+
1. If selecting one object, the [import preview](#import-preview) window screen appears for that object.
57
+
2. If selecting multiple objects, the files are added to the [import queue](#import-queue).
58
+
3. Configure your import settings and verify any [warning or error messages](#warnings-and-errors).
59
+
4. Click **Import**.
10
60
11
-
- Meshes with basic or PBR ([surface appearance](../../art/modeling/surface-appearance.md)) textures.
12
-
- Meshes with [rigging and skinning data](../../art/modeling/rigging.md).
13
-
- Meshes with animation data.
14
-
- Specialized meshes, such as [accessories](../../art/accessories/index.md), or characters with [facial animation data](../../art/characters/facial-animation/index.md).
61
+
<Alertseverity ='info'>
62
+
To directly import 3D assets using HTTP requests, see the [Open Cloud usage guide for assets](../../cloud/guides/usage-assets.md).
63
+
</Alert>
64
+
65
+
## Supported file types
66
+
67
+
Before importing a 3D object, ensure that the `.fbx`, `.gltf` or `.obj` meets Studio's [mesh requirements](../../art/characters/specifications.md) to reduce errors or unexpected behavior.
15
68
16
-
<BaseAccordion>
17
-
<AccordionSummary>
18
-
<Typographyvariant="subtitle2">Supported file type features</Typography>
19
-
</AccordionSummary>
20
-
<AccordionDetails>
21
69
<table><thead>
22
70
<tr>
23
71
<th style={{width:"20%"}}>**File type**</th>
@@ -27,54 +75,106 @@ The 3D Importer allows you to import `.fbx`, `.gltf`, or `.obj` 3D models into S
27
75
<tbody>
28
76
<tr>
29
77
<td>OBJ (`.obj`)</td>
30
-
<td>Supports:<br/><br/>— Basic single mesh objects</td>
78
+
<td>— Basic single mesh objects</td>
31
79
<td>Simple mesh geometry use-cases.</td>
32
80
</tr>
33
81
<tr>
34
82
<td>FBX (`.fbx`)</td>
35
-
<td>Supports:<br/><br/>— Multiple mesh objects and hierarchies<br/>— Textures, including basic and [PBR textures](../../art/modeling/surface-appearance.md).<br/>— Cage mesh objects<br/>— [Rigging and armature data](../../art/modeling/rigging.md)<br/>— Additional components for [avatar](../../avatar/index.md) items.<br/>— Animation data<br/>— [Vertex colors](../blender.md#vertex-painting)</td>
83
+
<td>— Multiple mesh objects and hierarchies<br/>— Textures, including basic and [PBR textures](../../art/modeling/surface-appearance.md).<br/>— Cage mesh objects<br/>— [Rigging and armature data](../../art/modeling/rigging.md)<br/>— Additional components for [avatar](../../avatar/index.md) items<br/>— Animation data<br/>— [Vertex colors](../blender.md#vertex-painting)</td>
36
84
<td>Any type of 3D import, including but not limited to [game assets](../../assets.md) or [avatar items](../../avatar).</td>
37
85
</tr>
38
86
<tr>
39
87
<td>gLTF (`.gltf`)</td>
40
-
<td>Supports:<br/><br/>— Multiple mesh objects and hierarchies<br/>— Textures, including basic and [PBR textures](../../art/modeling/surface-appearance.md).<br/>— Cage mesh objects<br/>— [Rigging and armature data](../../art/modeling/rigging.md)<br/>— Additional components for [avatar](../../avatar/index.md) items.<br/>— Animation data<br/>— [Vertex colors](../blender.md#vertex-painting)</td>
88
+
<td>— Multiple mesh objects and hierarchies<br/>— Textures, including basic and [PBR textures](../../art/modeling/surface-appearance.md).<br/>— Cage mesh objects<br/>— [Rigging and armature data](../../art/modeling/rigging.md)<br/>— Additional components for [avatar](../../avatar/index.md) items<br/>— Animation data<br/>— [Vertex colors](../blender.md#vertex-painting)</td>
41
89
<td>Any type of 3D import, including but not limited to [game assets](../../assets.md) or [avatar items](../../avatar).</td>
42
90
</tr>
43
91
</tbody></table>
44
-
</AccordionDetails>
45
-
</BaseAccordion>
46
92
47
-
<Alertseverity ='info'>
48
-
To directly import 3D assets using HTTP requests, see the [Open Cloud usage guide for assets](../../cloud/guides/usage-assets.md).
49
-
</Alert>
93
+
## Import queue
50
94
51
-
The 3D Importer is divided into three sections:
95
+
If you selected multiple files with the 3D Importer, you can use the import queue to bulk manage your various imports.
52
96
53
-
<imgsrc="../../assets/modeling/meshes/3d-Importer-Panels.png"width="80%"alt="The 3D importer interface, showing a preview of the mesh in the top left, a list of 3D objects on the bottom left, and a list of toggle-able properties on the right side."/>
97
+
<imgsrc="../../assets/modeling/meshes/3d-Import-Queue.png"width="80%"alt="The 3D importer interface, showing a preview of the mesh in the top left, a list of 3D objects on the bottom left, and a list of toggle-able properties on the right side."/>
54
98
55
-
A. The **preview panel**, located in the top left, allows you to rotate and examine 3D objects before importing into your workspace or Toolbox.
The **import queue** lists all added files, with quick access dropdowns to change creator, presets, and file paths.
109
+
</Grid>
110
+
</Grid>
56
111
57
-
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.
112
+
### Add files to queue
58
113
59
-
C. The **inspector panel**, located on the right, allows you to apply various settings to the imported object.
114
+
To open a file browser and add additional files to the import queue, you can:
60
115
61
-
## Import 3D objects
116
+
- Click the **Add file** button in the top bar of the Import queue window.
117
+
- In the Studio's **Home** or **Avatar** tab, click **Import 3D**.
118
+
- Navigate to **File** > **Import 3D**.
62
119
63
-
<iframewidth="560"height="315"src="https://www.youtube-nocookie.com/embed/ikYZloBgqtE"title="YouTube video player"frameborder="0"allow="accelerometer; clipboard-write; encrypted-media; gyroscope; picture-in-picture"allowfullscreen></iframe>
64
-
<br />
120
+
### Remove files from queue
65
121
66
-
<iframewidth="560"height="315"src="https://www.youtube-nocookie.com/embed/RCsYZe3LoDM"title="YouTube video player"frameborder="0"allow="accelerometer; clipboard-write; encrypted-media; gyroscope; picture-in-picture"allowfullscreen></iframe>
67
-
<br />
122
+
To remove all files from the queue, click the **Clear queue** button with the broom icon. To remove an individual file from the queue, right-click an item in the queue and select **Delete from queue**.
68
123
69
-
Before importing a 3D object, ensure that the `.fbx`, `.gltf` or `.obj` meets Studio's [mesh requirements](../../art/characters/specifications.md) to reduce errors or unexpected behavior.
124
+
### Apply preset settings
70
125
71
-
To import a 3D object:
126
+
Use the **Import Preset** column to select a preset configuration to apply to your model. For more information, see [Presets](#presets).
72
127
73
-
1. In the toolbar's **Home** or **Avatar** tab, click **Import 3D**. A file browser displays.
74
-
2. Select the `.fbx`, `.gltf` or `.obj` you intend to import. The Importer window displays.
75
-
3. Verify the object preview and check that the [import settings](#import-settings) are correct for your object.
76
-
4. Verify any [warning or error messages](#warnings-and-errors).
77
-
5. Click **Import**.
128
+
You can also apply the settings of one item to all items by right-clicking an item with the desired settings and selecting **Apply settings to all**.
129
+
130
+
### Access individual preview and settings
131
+
132
+
Click the individual **Asset** name of an unimported model to access the import preview for that item. Use the import preview to view and check your model, as well as set any individual [import settings](#import-settings).
133
+
134
+
### Import files
135
+
136
+
Ensure that each item you want to import has a checkbox enabled in the first column. By default, all items are selected if they are importable.
137
+
138
+
Press the **Import** button to start the import process.
139
+
140
+
## Import preview
141
+
142
+
The import preview window appears if you are importing a single file, or if you selected an individual item from the import queue. This preview window provides individual controls for the various objects in your model.
143
+
144
+
The preview window is divided into multiple sections:
145
+
146
+
<imgsrc="../../assets/modeling/meshes/3d-Importer-Panels.png"width="80%"alt="The 3D importer interface, showing a preview of the mesh in the top left, a list of 3D objects on the bottom left, and a list of toggle-able properties on the right side."/>
![rbx-open-source-docs[bot]](https://avatars.githubusercontent.com/in/357490?v=4&size=40){kind=avatar}
0 commit comments