Private accessorsPrivate Private Whether the component accessor's are built.
When colliding with back faces, the character will not be able to move through back facing triangles. Use this if you have triangles that need to collide on both sides. Following constants available:
BFM_IGNORE_BACK_FACES
BFM_COLLIDE_BACK_FACES
Constant number, representing the back face collision mode.
BFM_COLLIDE_BACK_FACES
Broadphase Filter Layer. Specifies what objects character can collide with.
BP_LAYER_MOVING (1)
Broadphase Filter Layer number.
How far we try to stay away from the geometry. This ensures that the sweep will hit as little as possible lowering the collision cost and reducing the risk of getting stuck.
Padding distance.
0.02 (meters)
How far we're willing to penetrate geometry.
Penetration distance.
0.001 (meters)
Internally the convex radius will be subtracted from the half extent, so the total size will not grow with the convex radius. You can increase this value to make the edges of the collision shape rounded.
Note:
SHAPE_BOX and SHAPE_CYLINDER.Number, representing the convex radius.
0.05 (m)
Specifies, whether to debug draw the collision shape.
Boolean, telling if the collision shape should be drawn using lines.
false
Allows to turn on/off debug draw for this body. Only works with a debug build.
Boolean to enable/disable a debug draw.
true
If debugDraw is enabled, this will specify whether to consider scene depth or not.
If set to false, the debug lines will be drawn on top of everything, through other meshes.
Boolean, telling whether to consider scene depth.
Density of the object. Affects the mass of the object, when
BodyComponent.overrideMassProperties is set to OMP_CALCULATE_MASS_AND_INERTIA
(default, which will auto-calculate the mass using the shape dimensions and this density
value).
Number, representing the density of this collision shape.
1000 (kg / m^3)
Private entityPrivate Read-only. If the character is supported, this will tell the ground entity.
Entity, representing the ground.
null
Read-only. If the character is supported, this will tell the ground normal. Otherwise, will be a zero vector.
Vector with ground normal.
Vec3(0, 0, 0)
Read-only. Tells the ground velocity the character is standing on. If the character is not supported, will be a zero vector.
Ground linear velocity
Vec3(0, 0, 0)
Collision group bit of an object layer.
Two layers can collide if object1.group and object2.mask is non-zero and object2.group
and object1.mask is non-zero. The behavior is similar to that of filtering in e.g. Bullet,
Rapier.
Unsigned integer.
0
Updates the filtering group bit. Value is ignored, if JoltInitSettings.bitFiltering is not set.
Unsigned integer.
Half extent for a SHAPE_BOX.
Vec3 with half extent of a box collision shape.
Vec3(0.5, 0.5, 0.5) (m per axis)
Half-height of radius based shapes.
Note: Only used by SHAPE_CAPSULE and SHAPE_CYLINDER.
Number, representing half of the total height of the collision shape.
0.5 (m)
Cosine of the threshold angle. If the angle between the two triangles in HeightField is
bigger than this, the edge is active. note that a concave edge is always inactive. Setting
this value too small can cause ghost collisions with edges. Setting it too big can cause
depenetration artifacts (objects not depenetrating quickly). Valid ranges are between
cos(0 degrees) and cos(90 degrees).
Number, representing radians of the threshold angle.
0.996195 (cos(5 degrees))
How many bits per sample to use to compress the HeightField. Can be in the range [1, 8].
Note that each sample is compressed relative to the min/max value of its block of
hfBlockSize * hfBlockSize pixels so the effective precision is higher. Also note that
increasing hfBlockSize saves more memory, than reducing the amount of bits per sample.
Number, representing amount of compression bits.
8
The HeightField is divided in blocks of hfBlockSize * hfBlockSize * 2 triangles and the
acceleration structure culls blocks only, bigger block sizes reduce memory consumption, but
also reduce query performance. Sensible values are [2, 8]. Does not need to be a power of
2. Note that at run-time Jolt performs one more grid subdivision, so the effective block
size is half of what is provided here.
Number, representing a block size.
2
Offsets the position of the HeightField, which is a surface defined by:
hfOffset + hfScale * (x, hfHeightSamples[y * hfSampleCount + x], y)
where x and y are integers in the range x and y e [0, hfSampleCount - 1].
Vec3 with position offset.
Vec3(0, 0, 0) (m per axis)
The maximum angle between two hits contact normals that are allowed to be merged during hit reduction. Set to -1 to turn off.
Cosine of an angle.
~cos(2.5) (radians)
Max angle.
Unique body index. This can change during entity lifecycle, e.g. every time entity is enabled, a new index is assigned and a new body is created. The index is used to map entity to body. Index can be re-used by another component if this component is disabled or destroyed (destroying related body as a result).
Integer number, representing the unique body index.
-1
Specifies if the component describes a child of a compound shape.
Boolean, telling if this component describes a child shape of a compound shape.
false
Read-only. True, if the ground the character is standing on is too steep to walk on.
Boolean, telling if the ground is to steep.
false
Read-only. True, if the character is supported by normal or steep ground.
Boolean, telling if the character is supported.
false
Character linear velocity. Must be set by user. Backend will use it to calculate next position of the character.
Vec3 with linear velocity.
Vec3(0, 0, 0)
Sets the linear velocity of the character.
Linear velocity vector to set the character to.
Collision mask bit of an object layer.
Two layers can collide if object1.group and object2.mask is non-zero and object2.group
and object1.mask is non-zero. The behavior is similar to that of filtering in e.g. Bullet,
Rapier.
Unsigned integer.
0
Updates the filtering mask bit. Value is ignored, if JoltInitSettings.bitFiltering is not set.
Unsigned integer.
Character mass. Used to push down objects with gravity when the character is standing on top.
The mass of the character.
70 (kg)
Mass (kg).
A center of mass offset in local space of the body. Does not move the shape.
Vec3 with center of mass offset.
Vec3(0, 0, 0) (m per axis)
Max amount of collision loops. The more loops, the higher the collision precision, the more expensive is the calculation.
Amount of collision loops.
5
How often constraint solver tries to step. The higher the number, the higher the precision, the more expensive it is to calculate.
Amount of constraint solving steps.
15
Max num hits to collect in order to avoid excess of contact points collection.
Number of hits.
256
Hits number.
Maximum angle of slope that character can still walk on.
Slope angle.
45 * math.DEG_TO_RAD (radians)
Maximum force with which the character can push other bodies (N).
Max strength of the character.
100 (newtons)
Maximum force with which the character can push other bodies (N).
Mesh is used when shape is SHAPE_MESH or SHAPE_CONVEX_HULL.
null, when no
mesh is used.null
PlayCanvas Mesh instance.
Early out condition: If this much time is left to simulate we are done.
Remaining time to simulate.
0.0001 (seconds)
Object Filter Layer. Defines which objects character can collide with.
OBJ_LAYER_MOVING (1)
Object Filter Layer number.
Private orderPrivate // TODO
An entity with a kinematic or dynamic body, that will be paired with this character. A virtual character doesn't exist in the physics world. Pairing an entity gives it a physical world presence (allow raycasts and collisions detection vs character).
A paired entity.
null
Pairs an Entity with a body component to a character.
An entity to pair with the character.
This value governs how fast a penetration will be resolved:
Number of updates.
1
Recovery speed factor.
How far to scan outside of the shape for predictive contacts. A value of 0 will most likely cause the character to get stuck as it cannot properly calculate a sliding direction anymore. A value that's too high will cause ghost collisions.
Predictive contact distance.
0.1 (meters)
Radius for radius based shapes, like SHAPE_CAPSULE, SHAPE_SPHERE, etc.
Number, specifying the shape radius.
0.5 (m)
This field contains the render asset ID, when a render asset is used for collision mesh or a convex hull.
Asset or its ID number. Will be null if render asset is
not used.
null
Sets render asset as a collider. Note:
SHAPE_MESH or SHAPE_CONVEX_HULL in order for the render asset
to be used.Render asset or its id number.
Returns the default collision shape type of the character (the one it was created with).
A shape type constant number.
SHAPE_CAPSULE
An extra offset applied to the shape in local space. If the shape already has a shapePosition offset, then both offsets are used.
Linear position offset of the shape.
Vec3(0, 0, 0)
Shape offset.
Local position offset of the collision shape.
Vec3 with local position offset.
Vec3(0, 0, 0) (m per axis)
Local rotation offset of the collision shape.
Quat with local rotation offset.
Quat(0, 0, 0, 1) (identity rotation)
Ground state. Following constants available:
GROUND_STATE_ON_GROUND
GROUND_STATE_ON_STEEP_GROUND
GROUND_STATE_NOT_SUPPORTED
GROUND_STATE_IN_AIR
Number, representing the ground state.
GROUND_STATE_NOT_SUPPORTED
Max amount to project the character downwards.
Vec3(0, -0.5, 0) (m)
Direction and distance for stepping down.
A plane, defined in local space relative to the character. Every contact behind this plane can support the character, every contact in front of this plane is treated as only colliding with the player.
Plane that is used to define what surfaces support and what collide with character.
Plane(Vec3.UP, -1)
Private systemPrivate Vector indicating the up direction of the character.
Vec3 with up direction.
Vec3(0, 1, 0)
Up vector.
Applies entity scale on the shape. This makes it easier to adjust the size of the collision shape by simply scaling the entity.
Note: Some shapes do not support non-uniformed scales, like SHAPE_SPHERE. Works best with
SHAPE_BOX which you can scale on any axis. Others, like capsule and cone, can't have a
different radius on X and Z axis, but allow scaling Y for their height.
Boolean, telling if the entity scale is applied on this collision shape.
true
Enables/disables the use of motion state for the character. Refer to BodyComponent.useMotionState for details.
Boolean, telling whether character controller will use a motion state.
true
Enables/Disables a motion state for this character.
Boolean to enable/disable the motion state.
User data to be associated with this character.
Number if user data is set. Otherwise null;
null
Sets a number on the character shape.
Sometimes, it is useful to change a behavior of the character inside the collision callback. The callbacks lose the current scope they are executed in, so you can pass custom numbers as user data and read them from inside the callback.
Number, to set as user data on the character.
Maximum angle in radians between the ground normal in the horizontal plane and the character forward vector where we're willing to adjust the step forward test towards the contact normal.
cos(75)
Radians.
The distance to step forward after the step up.
0.02 (m)
Minimum distance.
An additional translation that is added when stepping down at the end. Allows you to step further down than up. Set to zero vector if you don't want this. Should be in the opposite direction of up.
Vec3(0, 0, 0)
Extra translation.
When running at a high frequency, stepForward can be very small and it's likely that you hit the side of the stairs on the way down. This could produce a normal that violates the max slope angle. If this happens, we test again using this distance from the up position to see if we find a valid slope.
0.15 (m)
Test distance.
The direction and distance to step up (this corresponds to the max step height).
Vec3(0, 0.4, 0) (m)
Direction and distance of the step.
Allows to add a shape to a mutable compound shape.
The index of a shape to add. It can be created by createShape.
Optional localPos: any = Vec3.ZEROLocal position of the shape.
Optional localRot: any = Quat.IDENTITYLocal rotation of the shape.
Optional userData: number = 0User defined unsigned integer.
Allows to modify a child shape of a mutable compound shape.
The child shape index. Children indices are zero based and have no gaps.
Optional localPos: any = Vec3.ZEROLocal position of the shape.
Optional localRot: any = Quat.IDENTITYLocal rotation of the shape.
Optional shapeIndex: number = -1The index of a shape to add. It can be created by createShape.
Allows to remove a child shape from a mutable compound shape. The children are indexed in order they were added. Indices are zero based and have no gaps. If you remove a child, then the next child takes its index.
For example, if you remove child under index 0, then all children shift there indices, so
that the child with index 1, becomes a child with index 0, etc.
The index of a child shape to remove.
Allows to change the shape of the character collider.
The shape index to switch to. It can be created by createShape. Use negative number to reset to original shape.
Callback function that will accept a boolean, telling if the shape change was successful.
Char Component. Describes the properties of a Jolt Virtual Character.