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
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.