Creating Ragdolls

BipedRagdollCreator
PuppetMaster contains a very easy to use visual ragdoll creation tool for biped characters (can actually be used on any character with at least 4 limbs) called BipedRagdollCreator. When the BipedRagdollCreator.cs component is enabled on a character, the ragdoll components will be destroyed and recreated each time you change the references or options. This enables for fast and intuitive live editing.

Getting started

• Drag a character model to the scene and attach the BipedRagdollCreator.cs component. Biped bone references will be filled in automatically if it is a Humanoid character. In other cases, they can be filled in manually.
• Click on "Create a Ragdoll" to start live-updating and editing the ragdoll. You should then see the Rigidbody, Collider and Joint components added to the character.
• Note that with all adjustments to the parameters of BipedRagdollCreator the ragdoll components will be deleted and recreated, so do not make any references to them until the BipedRagdollCreator has been removed.
• Only ConfigurableJoints are supported by the PuppetMaster at this time so use "Configurable" as "Joints".
• Once you are happy with the basic Collider and Joint types and other settings in the "Options", click on "Start Editing Manually" to make final manual adjustments using the RagdollEditor. This will remove the BipedRagdollCreator component.

Component variables:

• references - references to the biped bones.
• weight - the total weight of the character. Will be distributed biometrically between the ragdoll Rigidbodies.
• spine - toggle the spine bone included in the ragdoll.
• chest - toggle the chest bone included in the ragdoll.
• hands - toggle the hand bones included in the ragdoll.
• feet - toggle the foot bones included in the ragdoll.
• joints - build the ragdoll with ConfigurableJoints or CharacterJoints? NB! PuppetMaster can use only ConfigurableJoints.
• jointRange - multiplies joint limit ranges.
• colliderLengthOverlap - determines how much the colliders overlap each other, supports also negative values.
• torsoColliders - use BoxColliders or CapsuleColliders for the body part.
• headCollider - use BoxCollider or CapsuleCollider for the body part.
• armColliders - use BoxColliders or CapsuleColliders for the body part.
• handColliders - use BoxColliders or CapsuleColliders for the body part.
• legColliders - use BoxColliders or CapsuleColliders for the body part.
• footColliders - use BoxColliders or CapsuleColliders for the body part.

Creating ragdolls in runtime:

[Tooltip("The character prefab/FBX.")]
public GameObject prefab;

void Start() {
    // Instantiate the character
    GameObject instance = GameObject.Instantiate(prefab);

    // Find bones (Humanoids)
    BipedRagdollReferences r = BipedRagdollReferences.FromAvatar(instance.GetComponent<Animator>());

    // How would you like your ragdoll?
    BipedRagdollCreator.Options options = BipedRagdollCreator.AutodetectOptions(r);

    // Edit options here if you need to
    //options.headCollider = RagdollCreator.ColliderType.Box;
    //options.weight *= 2f;
    //options.joints = RagdollCreator.JointType.Character;

    // Create the ragdoll
    BipedRagdollCreator.Create(r, options);

    Debug.Log("A ragdoll was successfully created.");
}

void Update() {
    // If bone proportions have changed, just clear and recreate:
    //BipedRagdollCreator.ClearBipedRagdoll(r); //ClearAll if you have changed references
    //BipedRagdollCreator.Create(r, options);
}