The ragdoll module applies applies ragdoll physics to the agents belonging to this agent group agents.
Your agent types will have to be set up for with a ragdoll file.
...
Attributes
| Attributes | Type | Overridable | Description |
|---|---|---|---|
| mode | int | yes | The ragdoll mode. Values are: |
| ragdollSetup | string | yes | Overrides the ragdoll setup file stored in the agentType for this agent (not yet in use) |
| useDynamicModeMetadata | bool | yes | If set |
| to true the mode is driven by the "dynamicMode" metadata | |||
| partialRagdollFilter | string | yes | A comma separated string containing the joint names with partial ragdoll (wildcards are supported) |
| dynamicOnCollision | integer | yes |
| Activates dynamics on collision | ||
| dynamicOnCollisionFilter | string | yes |
If a metadata name is specified, the metadata value is used.
Depending on the metadata type a different action is performed:
- Vector3Metadata: the force direction is taken from the metadata
- DoubleMetadata: the force magnitude is taken from the metadata
- IntMetadata, BoolMetadata: the weight of the module is taken from the metadata
| A comma separated string containing the joint names that are used to trigger the dynamicOnCollision mode (wildcards are supported) | |||
| dynamicOnCollisionPool | integer | yes | Pool on which an agent is assigned after a dynamicCollision event happen.
|
| collisionForceThreshold | double | yes | The force threshold for the kinematic to dynamic conversion, if the force magnitude is lower than this value the object won't be converted. |
| motorRagdollDamping | double | yes | Motor constraint damping value, with value of -1 the operator uses the one stored inside the ragdoll setup file |
| motorRagdollStiffness | double | yes | Motor constraint stiffness value, with value of -1 the operator uses the one stored inside the ragdoll setup file |
| motorRagdollIsAcceleration | integer | yes | Motor constraint "isAcceleration" value, with value of -1 the operator uses the one stored inside the ragdoll setup file |
| motorRagdollMaxForce | double | yes | Motor constraint "max force" value, with value of -1 the operator uses the one stored inside the ragdoll setup file |
| breakable | integer | yes | Activate the constraint breakable force |
| breakableFilter | string | yes | A comma separated string containing the joint names where the operator sets the breakable option (wildcards are supported) |
| breakForce | vector2 | yes | Breakable force limit (x for linear magnitude and y for torque magnitude) |
| animationBlending | double | yes | Blend weight used on motor constraint. With a value of 1.0 the agent clip animation is applied on the motor constraint |
| stuckOnCollision | bool | yes | If set to true, rigid bodies |
| get stuck on collision | |||
| stuckOnCollisionBreakForce | vector2 | yes | Break force magnitude to break the stuck on collision constraint. Value of -1 means an infinite force |
| stuckOnCollisionImpulse | double | yes | Inpulse magnitude multiplier applied to the impulse force on a stuckOnCollision event |
| stuckOnCollisionPool | integer | yes | Pool on which an agent is assigned after the occurring of a stuckOnCollision event. Use the following values:
|
| collisionPool | integer | yes | Collision pool. Use the following values:
|
| partialRagdollSkipChildren | bool | yes | If true, the ragdoll operator won't create rigid bodies for the children of the given joints (partialRagdollFilter) when the agent is in partial ragdoll. |
| selfCollision | bool | yes | Enable the agent self collision |
| debug | bool | no | Activate the |
| debugging drawing on the selected agents. |