Importing humanoid animations
Model import workflows
Note: This workflow assumes you already have a Model file to import. If you don’t have a file already, you can read the guidelines on how to export an FBX file before exporting it from your 3D modeling software. For guidelines on how to export Humanoid animation from your 3D modeling software, see Humanoid Asset preparation.
Model files can contain a variety of data, such as character Meshes, Animation Rigs and Clips, as well as Materials and Textures. Most likely, your file does not contain all of these elements at once, but you can follow any portion of the workflow that you need to.
Accessing the Import Settings window
No matter what kind of data you want to extract from the Model file, you always start the same way:
1. Open the Project window and the Inspector so that you can see both at once.
2. Select the Model file you want to import from the Asset folder in the Project window. The Import Settings window opens in the Inspector showing the Model tab by default.
Setting Model-specific and general importer options
Then you can set any of these options on the Model tab:
- Use the Scale Factor, Use File Scale, or File Scale properties to adjust how Unity interprets units. For example, 3ds Max uses 1 unit to represent 10 centimeters, whereas Unity uses 1 unit to represent 1 meter.
- Use the Mesh Compression, Read/Write Enabled, Optimize Mesh, Keep Quads, Index Format, or Weld Vertices properties to reduce resources and save memory.
- You can enable the Import BlendShapes option if the Model file came from Maya or 3ds Max, or any other 3d modeling application that supports morph target animation.
- You can enable the Generate Colliders option for environment geometry.
- You can enable specific FBX settings, such as Import Visibility, or Import Cameras and Import Lights.
- For Model files that contain only Animation, you can enable the Preserve Hierarchy option to prevent hierarchy mismatch in your skeleton.
- You can set the Swap UVs and Generate Lightmap UVs if you are using a Lightmap.
- You can exercise control over how Unity handles the Normals and Tangents in your Model with the Normals, Normals Mode, Tangents, or Smoothing Angle options.
Setting options for importing Rigs and Animation
If your file contains Animation data, you can follow the guidelines for setting up the Rig using the Rig tab and then extracting or defining Animation Clips using the Animation tab. The workflow differs between Humanoid and Generic (non-Humanoid) animation types because Unity needs the Humanoid’s bone structure to be very specific, but only needs to know which bone is the root node for the Generic type:
Dealing with Materials and Textures
If your file contains Material or Texture, you can define how you want to deal with them:
- Click the Materials tab in the Import Settings window.
- Enable the Import Materials option. Several options appear in the Materials tab, including the Location option, whose value determines what the other options are.
- Choose the Use Embedded Materials option to keep the imported Materials inside the imported Asset.
When you have finished setting the options, click the Apply button at the bottom of the Import Settings window to save them or click the Revert button to cancel.
Finally, you can import the file into your scene:
- If it contains a Mesh, drag the file into the Scene view to instantiate it as a Prefab for a GameObject.
- If it contains Animation Clips, you can drag the file into the Animator window to use in the State Machine or onto an Animation track on the Timeline window. You can also drag the Animation take directly onto an instantiated Prefab in the Scene view. This automatically creates an Animation Controller and connects the animation to the Model.
Did you find this page useful? Please give it a rating:
Thanks for rating this page!
What kind of problem would you like to report?
Is something described here not working as you expect it to? It might be a Known Issue. Please check with the Issue Tracker at issuetracker.unity3d.com.
Thanks for letting us know! This page has been marked for review based on your feedback.
If you have time, you can provide more information to help us fix the problem faster.
Provide more information
You've told us this page needs code samples. If you'd like to help us further, you could provide a code sample, or tell us about what kind of code sample you'd like to see:
You've told us there are code samples on this page which don't work. If you know how to fix it, or have something better we could use instead, please let us know:
You've told us there is information missing from this page. Please tell us more about what's missing:
You've told us there is incorrect information on this page. If you know what we should change to make it correct, please tell us:
You've told us this page has unclear or confusing information. Please tell us more about what you found unclear or confusing, or let us know how we could make it clearer:
You've told us there is a spelling or grammar error on this page. Please tell us what's wrong:
You've told us this page has a problem. Please tell us more about what's wrong:
Thanks for helping to make the Unity documentation better!
Importing humanoid animations