Auto-Rig Pro Documentation

Frequently Asked Questions

Click a question to show the answer.

General Information

  • Will the addon be compatible with Blender 2.8?

  • Definitely, it will be ported to 2.8. Currently Blender 2.8 is still in an alpha stage, very unstable, but as soon as it enters in a beta or similar stage it will be time to work on it.
  • What can I rig with it?

  • It’s meant to rig any stylized or realistic character, based on bipeds/m-peds bone structure with spine bones, arms and legs : humans, cats, dogs, centaurs, spiders... On the contrary, rigging a snake is not supported yet.
    Bird feathers are not yet included, however you can add your custom bones over it if you know the principles of rigging. Or use the included hand fingers bones to this aim.
  • How does the auto-detection (Smart) work, what limitations?:

  • It works for biped characters only, the model must be in T-Pose or A-Pose. It detects the feet, legs, spine, arms, fingers position and optionally the facial bones. Depending on the character, some manual correction may be required.
    The algortihm finds the vertices in the markers neighbourhood, compute the volume, position of each part, then analyze the datas to place the bone according to the standard biped proportions.
    If the model is too special and does not meet these requirement, you can skip the auto-detection feature and simply place the reference bone manually.

  • Are asymmetrical models supported?

  • Asymmetrical models are supported by both the smart feature and manual bones edition. By turning off Mirror when placing the markers and X-Mirror Axis when editing the reference bones:

    xmirror xmirror
  • Does it include bendy bones?

  • They're currently used to handle the neck twist deformation, and for the leg and arms secondary deformers in option, since they're not exportable to game engines. To export the secondary bones to Fbx, it's best to stick to the original Additive mode.
  • Is it possible to add new, custom bones?

  • Sure, new bones can be added after generating the final rig (Match to Rig). No reference bones can be created for the custom bones, they will remain in the final rig.

  • Is it possible to delete bones?

  • If disabling a full limb doesn't give you enough precision to disable a specific bone, hide the bones you don't need (H key) but don't delete them, it would lead to the addon malfunction. Then just delete the vertex groups of the hidden bones to make them ineffective.

    To hide the IK and FK bones, delete the driver from the checkbox first:


Technical Problems


  • Clicking Match to Rig leads to an error / The mesh blowns up after clicking Bind

  • Make sure auto-run python scripts is enabled in the preferences (Ctrl-Alt-U > File) or 'Trusted Source' when loading the file. Some dependencies such as drivers and scripts execution rely on it.

    autorun autorun2

  • The Bind button doesn't work, the model does not follow the controllers motions

  • Unfortunately, there are a few cases where the binding may fail. This is due to the current limitation of the Blender automatic weight solver. Hopefully there are workarounds to get it work perfectly. Unbind the character, try one of the following, and bind again.

    • Enable Split Parts: Meshes made of multiple non-connected pieces (clothes, teeth, eyes...) may skin poorly/not at all if Split Parts is not enabled.


    • Unit scale: If the mesh is too small with a high number of vertices, binding may fail. Try to scale up the character and armature (S key, then type numpad 10 to scale ten time bigger), bind the mesh, then scale it down (S key, type numpad 0.1) to reset to the inital scale.

    • Coordinates are not initialized: Make sure you initialized the mesh rotation and position by pressing Ctrl-A

    • Non-manifold vertices : Make sure the mesh has no serious deficient topology by pressing Shift-Ctrl-Alt-M to select the non-manifold vertices. If you can see a lot of vertices selected all around the mesh (excluding boundaries), perform a 'Remove Double' by pressing W > Remove Double.

    • The mesh contains custom normals: Imported files (.obj, .fbx) may contain complex/dirty normal datas that the binding solver does not appreciate. Delete them and select all vertices, Ctrl-N to recalculate the normals.


    • Others : If it still doesn't work, as weird as it may sound, the mesh is likely subject to an unindentified internal Blender bug that can be strangely fixed by adding a subsurf modifier. Add the subsurf modifier (level 1 is fastest), bind the mesh then delete the modifier.

  • Something went wrong when binding, it's not really smooth

  • When using very high poly meshes (~80.000 faces) the Blender automatic weight solver may become slightly buggy on the edges...
    A simple way to fix this is switching to Weight Paint mode, and add a little negative level offset to the weight groups. And if more accuracy is needed, just paint over the automatic weights.


Smart feature

  • The markers are invisible?

  • Make sure the scene units are set to 1.0 scale. You'll be able to change it later (e.g. Unreal export) but the smart feature only works with 1.0 scale units.

Game Engine Export

  • When exporting with x100 Units, the legs are broken?

  • unit_bug

    Due to the an imprecision of the IK stretch calculation, Blender does not handle well big models, whose scale are multiplied by 100 when switching to Unreal Engine units. Unfortunately, after many trials, there's nothing I can do on my side (addon code) to prevent it. The bug has been reported and hopefully and will be fixed someday.
    As a workaround, before clicking UE Units just make sure to scale the armature and mesh objects together so that they're not bigger than the standard grid floor, in Blender units.


Renderfarm/Sheep It Rendering

  • How to render my file with a render farm/ Sheep It?

  • If the render farm, such as Sheep It, does not support bones drivers and python scripts, the rig will be broken and won't render correctly. The solution is to bake the drivers and save it as a new file for rendering.

    • Space bar > type "bake" > choose NLA Bake


    • If some meshes have driven shape keys, run this script after selecting a mesh to bake the shape keys driver values as keyframe:

      import bpy
      context = bpy.context
      scene = context.scene
      object = context.object

      frame = scene.frame_start
      while frame < scene.frame_end:
          for fcurve in
          frame = frame + 1

    • Delete all armature drivers from the graph editor:




  • Is it possible to mirror a full animation? Flipping the right controllers keyframes to the left?

  • Yes! Blender supports that natively.


Auto-Rig Pro addon for Blender.
Documentation template provided by Frittt Templates