Importing Custom Rigs
Importing Custom Rigs
This article outlines the Roblox import process of custom rigs from Autodesk Maya or Blender — including those with animations — for use as non-player characters, mechanical objects, etc.
When building a character model in Maya or Blender, follow these general guidelines:
- Make sure your units are set to Centimeters.
- Geo meshes should have translate values only. These values should be relative to their parent joint — for instance, if you unparent the mesh from its joint, the translate values should be zeroed out (0, 0, 0).
- All joints should be placed correctly and have no rotation on any axis — they should all be (0, 0, 0). Similarly, the scale for every joint should remain at the default and be set to (1, 1, 1).
For the overall model hierarchy, ensure that:
- There’s a top-level joint named Root (case-sensitive).
- Each descendant joint of Root has a matching geometry of either the same name or the name with a _Geo suffix. For instance, if the joint name is Torso, the geometry name should be Torso or Torso_Geo.
Exporting the Model
Please review the following guidelines depending on whether you’re exporting from Maya or Blender.
Exporting From Maya »
Before exporting a character from Maya, make sure to set the units to Centimeters. Then, use File → Export All with the following changes to the default settings:
|Referenced Assets Content||enabled|
|FBX File Format|
Exporting From Blender »
Before exporting a character from Blender, make sure to set the units to Centimeters. Then, make the following changes to the default settings in the Export FBX panel:
Importing to Roblox Studio
To understand the process of importing a custom rig, please download the sample (SimpleDog.fbx).
Once you’ve downloaded the FBX file, proceed as follows:
- From the Plugins tab in Studio, click the Avatar Importer button.
- Click Custom from the four options.
- Browse to the downloaded file (SimpleDog.fbx). In Studio, it should import as this rig.
If you animated your model directly within Maya or Blender, you can import and upload the animation through Roblox’s built-in
/articles/using animation editor|Animation Editor.
To import animations from the FBX file:
- From the Plugins tab, click Animation Editor.
- Select the model (ImportedCustomRig) and click Create if prompted. Ignore any warnings about an invalid R15 avatar.
- From the File menu in the animation editor (not Studio’s main File menu), select Import FBX Animation.
- Browse to and select the same FBX file (SimpleDog.fbx).
Once you have animations successfully imported, you must upload them to Roblox.
- From the File menu in the animation editor (not Studio’s main File menu), select Export.
- Choose a new or existing slot.
- When the upload is complete, copy or record the animation ID which will be needed for testing the custom rig.
- Exit out of the dialog window; you may also close the animation editor window at this point.
Testing in Studio
As a final step, the rig can be tested as follows:
- In the Explorer window, move the ImportedCustomRig into ServerStorage.
- Hover over ServerScriptService, click the button, and insert a new Script.
- Rename the new script CreateObjectFromRig.
- Copy and paste the following code into the script.
- On line 3, change the
animationIDvalue to the ID you gathered in the Exporting Animations process earlier.
- On line 10, change the
humanoidObject.HipHeightvalue to the number you calculated in the Hip Height notes earlier.
- Play the game and you should see the dog in the game, moving with the simple animation that was configured in the FBX file.