Ragdoll

Ragdoll

The ragdoll module applies ragdoll physics to the agents belonging to this agent group.

Your agent types will have to be set up for with a ragdoll file.

 


Attributes

Attributes

Type

Overridable

Description

Attributes

Type

Overridable

Description

mode

int

yes

The ragdoll mode. Values are:
0 - none
1 - static
2 - kinematic
3 - ragdoll
4 - partial ragdoll
3 - motor ragdoll
4 - partial motor ragdoll

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

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.
Use the following values:

  • -1 for making the agent collide with everything

  • -2 to disable collision

  • any positive integer for setting a specific pool

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.
As soon as the force magnitude is higher than this value the dynamicOnCollision mode will be triggered.

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:

  • -1 for making the agent collide with everything

  • -2 to disable collision

  • any positive integer for setting a specific pool

collisionPool

integer

yes

Collision pool. 

Use the following values:

  • -1 for making the agent collide with everything

  • -2 to disable collision

  • any positive integer for setting a specific pool

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.

Copyright © 2017, Toolchefs LTD.