Thank you for helping us improve the quality of Unity Documentation. Although we cannot accept all submissions, we do read each suggested change from our users and will make updates where applicable.Close
For some reason your suggested change could not be submitted. Please try again in a few minutes. And thank you for taking the time to help us improve the quality of Unity Documentation.Close
Model files that are placed in the Assets folder in your Unity project are automatically imported and stored as Unity assets.
A model file may contain a 3D model, such as a character, a building, or a piece of furniture. The model is imported as multiple assets. In the Project view the main imported object is a Model Prefab. Usually there are also up to several Mesh objects that are referenced by the Model Prefab.
A model file may also contain animation data which can be used to animate this model or other models. The animation data is imported as one or more Animation Clips.
The Import Settings for a model file will be displayed in the Model tab of the FBX importer inspector when the model is selected. These affect the mesh, it’s normals and imported materials. Settings are applied per asset on disk so if you need assets with different settings make (and rename accordingly) a duplicate file.
Although defaults can suffice initially, it is worth studying the settings glossary below, as they can determine what you wish to do with the game object.
Some general adjustments to be made for example might be:
|Scale Factor||Unity’s physics system expects 1 meter in the game world to be 1 unit in the imported file. If you prefer to model at a different scale then you can compensate for it here. By default, .fbx, .max, .jas and .c4d files have a scale of 0.01, .mb, .ma, .lxo, .dxf, .blend and .dae files have a scale of 1.0 and .3ds files have a scale of 0.1.|
|Mesh Compression||Increasing this value will reduce the file size of the mesh, but might introduce irregularities. It’s best to turn it up as high as possible without the mesh looking too different from the uncompressed version. This is useful for optimizing game size.|
|Read/Write Enabled||Enables the mesh to be written at runtime so you can modify the data; it makes a copy in memory. When this option is turned off, it saves memory since Unity can unload a copy of mesh data in the game. However, if you are scaling or instantiating meshes at runtime with a non-uniform scale, you may have to enable “Read/Write Enabled” in their import settings. The reason is that non-uniform scaling requires the mesh data to be kept in memory. Normally this is detected at build time, but when meshes are scaled or instantiated at runtime you need to set this manually. Otherwise they might not be rendered in game builds correctly.|
|Optimize Mesh||This option determines the order in which triangles will be listed in the mesh.|
|Import BlendShapes||If this is enabled, Unity will import the BlendShapes for the model.|
|Generate Colliders||If this is enabled, your meshes will be imported with Mesh Colliders automatically attached. This is useful for quickly generating a collision mesh for environment geometry, but should be avoided for geometry you will be moving.|
|Swap UVs||Use this if lightmapped objects pick up the wrong UV channels. This will swap your primary and secondary UV channels.|
|Generate Lightmap||Use this to create the second UV channel to be used for Lightmapping.|
|Advanced Options||See Lightmapping UVs document.|
|Normals & Tangents|
|Normals||Defines if and how normals should be calculated. This is useful for optimizing game size.|
|Import||Default option. Imports normals from the file.|
|Calculate||Calculates normals based on Smoothing angle. If selected, the Smoothing Angle becomes enabled.|
|None||Disables normals. Use this option if the mesh is neither normal mapped nor affected by realtime lighting.|
|Tangents||Defines if and how tangents and binormals should be calculated. This is useful for optimizing game size.|
|Import||Imports tangents and binormals from the file. This option is available only for FBX, Maya and 3dsMax files and only when normals are imported from the file.|
|Calculate||Default option. Calculates tangents and binormals. This option is available only when normals are either imported or calculated.|
|None||Disables tangents and binormals. The mesh will have no Tangents, so won’t work with normal-mapped shaders.|
|Smoothing Angle||Sets how sharp an edge has to be in order to be treated as a hard edge. It is also used to split normal map tangents.|
|Split Tangents||Enable this if normal map lighting is broken by seams on your mesh. This usually only applies to characters.|
|Import Materials||Disable this if you don’t want materials to be generated. Default-Diffuse material will be used instead.|
|Material Naming||Controls how Unity materials are named:|
|By Base Texture Name||The name of the diffuse texture of the imported material that will be used to name the material in Unity. When a diffuse texture is not assigned to the material, Unity will use the name of the imported material.|
|From Model’s Material||The name of the imported material will be used for naming the Unity material.|
|Model Name + Model’s Material||The name of the model file in combination with the name of the imported material will be used for naming the Unity material.|
|Texture Name or Model Name + Model’s Material (Obsolete)||The name of the diffuse texture of the imported material will be used for naming the Unity material. When a diffuse texture is not assigned or it cannot be located in one of the Textures folders, then the material will be named by Model Name + Model’s Material instead. This option is backwards compatible with the behavior of Unity 3.4 (and earlier versions). We recommend using By Base texture Name, because it is less complicated and has more consistent behavior.|
|Material Search||Controls where Unity will try to locate existing materials using the name defined by the Material Naming option:|
|Local||Unity will try to find existing materials only in the “local” Materials folder, ie, the Materials subfolder which is the same folder as the model file.|
|Recursive-Up||Unity will try to find existing materials in all Materials subfolders in all parent folders up to the Assets folder.|
|Everywhere||Unity will try to find existing materials in all Unity project folders.|