Legacy Documentation: Version 4.6.2
Language: English
Importing models
FBX Importer, Rig options

Models

Suggest a change

Success!

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

Sumbission failed

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

Cancel

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.

A Mesh Filter together with Mesh Renderer makes the model appear on screen.
A Mesh Filter together with Mesh Renderer makes the model appear on screen.

Import settings for Meshes

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 - this scale factor is used for compensating difference in units between Unity and 3d modeling tool - it rescales whole file. Normally you can simply set it to 1. Note that Unity’s Physics Engine is scaled as 1 unit equals 1 metre. It is important that if you want to have correct physical behaviour you should have the model correctly scaled in the original modeling application. If this cannot be done, or you do not have control over the modification of the mesh, the scale of the model can be adjusted here.
  • Generate colliders - this will generate a collison mesh to allow your model to collide with other objects.
  • Material Naming and Search - this will help you automatically setup your materials and locate textures
FBX Importer Inspector: Model tab
FBX Importer Inspector: Model tab
Property: Function:
Meshes
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.
Materials
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.
Importing models
FBX Importer, Rig options