Ragdoll

This component allows to turn your character with humanoid skeleton to ragdoll mode.

You should not add this component manually, use Tools/Heroic Engine/Components/Add Ragdoll option in Editor menu as shown below

How to add ragdoll to your character

How to add ragdoll to your character

After this, Ragdoll component will appear on your character gameobject.

Ragdoll component

This component will be added only in case if gameobject with Animator and Humanoid rig was selected in scene hierarchy!

Parameters in inspector

Animator – animator of humanoid character; this field will be automatically assigned by RagdollAdder utility

Hips – hips rigidbody of humanoid character; this field will be also automatically assigned by RagdollAdder utility

Ragdoll Mode At Start – if enabled, ragdoll mode will be activated automatically when character gameobject becomes active on scene

---

Available methods

public void SetRagdollMode(bool enable)

This method sets ragdoll mode. If enabled, character Animator will be disabled and skeleton will become completely physical. Otherwise, Animator will be active and bones will be moved by animations.

Example:

void Die()
{
    // If character dies, enable ragdoll so it falls to the ground
    if (ragdoll != null)
    {
        ragdoll.SetRagdollMode(true);
    }
}

---

public void Push(Vector3 direction, float force, ForceMode forceMode = ForceMode.Impulse)

Hehe, what can be more funny than pushing ragdoll? This method applies certain force to the character body with certain direction and automatically activates ragdoll mode on it.

Example:

// Push first found ragdoll on scene by F button push
if (Input.GetKeyDown(KeyCode.F))
{
    Ragdoll ragdoll = FindObjectOfType<Ragdoll>();
    if (ragdoll != null)
    {
        ragdoll.Push(ragdoll.transform.position - transform.position, 150f);
    }
}

---

public void AddTorque(Vector3 direction, float torque, ForceMode forceMode = ForceMode.Impulse)

This method applies certain rotation force to the character body and automatically activates its ragdoll mode.

---

Btw, you can see how it works on example scene which can be launched by the most top button in main menu.

Here you can start example scene with ragdoll interaction