Ragdoll Workshop requires Unity 5.2.2 or later. Unity 5.3.0 or greater is recommended.

Although alpha and beta releases of Unity are not officially supported, this package will sometimes be updated during test cycles to add support as feasible.

Patch releases are not officially supported! Use them at your own risk.

• Only Mecanim is supported for animated ragdolls.
• Optimized GameObject rigs are not supported for animated ragdolls.
• Animating scale is not supported.
• Parts that are partially ragdoll via a RagdollAnimator currently only try to match rotation of their animation input.
• RagdollAnimator and components that inherit from it will not work when added at run-time. They also do not support swapping the animator's controller at run-time unless it is an AnimatorOverrideController. Make sure you watch the console for warning messages to flush cached layer mask data to your prefabs.
• Default characterization settings for non-humanoid tetrapods (e.g., large, non-avian theropods and equids) are not currently validated against research data.
• The included RagdollAnimatorFinalIKSync component requires Final IK 1.1 or newer.

• IL2CPP builds currently only work with Unity 5.1.3p3 and newer.
• Unity 5.2.0 introduced some bugs with StateMachineBehaviours that make RagdollAnimator not work at run-time. 5.2.1 and newer is fine.
• Setting center of mass for neck and spine in characterization template currently has no effect.
• Animator Controllers on objects with a RagdollAnimator type component do not work with the Auto Live Link setting in the Animator Controller editor window when using Animate Physics update mode. Consequently, editing any parameter values in this window will affect the controller asset in the project, instead of only the currently selected instance. To work around this problem, retain the renderer components on your animated hierarchy. When you need to debug your Animator controller, switch the Animator to Normal update mode and enable the renderers in the animated hierarchy.
• When undoing and then redoing Prepare for Physical Animation, the ragdoll object will not be properly re-parented in the hierarchy.
• Re-characterizing a ragdoll prefab will break its prefab connection.
• Baking a ragdoll will not retain edits to center of mass.
• Reverting a prefab with a TetrapodRagdoll or inherited component sometimes crashes the editor.
• Undoing and redoing the Clear button next to a PhysicalBody field sometimes crashes the editor.
• Due to a bug in Unity, destroying the Animator or Character Controller on a ragdoll, when it is on the same GameObject as the ragdoll, will result in a harmless MissingReferenceException.
• Automatic strength reduction due to environmental impacts will still be transmitted across a broken joint.