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.
Broadphase Filter Layer number.
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.
Allows to turn on/off debug draw for this body. Only works with a debug build.
Boolean to enable/disable a debug draw.
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.
Read-only. If the character is supported, this will tell the ground entity.
Entity, representing the ground.
Read-only. If the character is supported, this will tell the ground normal. Otherwise, will be a zero vector.
Vector with ground normal.
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
Updates the filtering group bit. Value is ignored, if JoltInitSettings.bitFiltering is not set.
Unsigned integer.
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.
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.
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.
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.
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.
Updates the filtering mask bit. Value is ignored, if JoltInitSettings.bitFiltering is not set.
Unsigned integer.
Mass (kg).
A center of mass offset in local space of the body. Does not move the shape.
Vec3 with center of mass offset.
Hits number.
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.PlayCanvas Mesh instance.
Object Filter Layer number.
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.
Pairs an Entity with a body component to a character.
An entity to pair with the character.
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.
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.
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.
Shape offset.
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.
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.
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.
Enables/Disables a motion state for this character.
Boolean to enable/disable the motion state.
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.
Radians.
Minimum distance.
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.
Test distance.
Allows to add a shape to a mutable compound shape.
The index of a shape to add. It can be created by createShape.
OptionallocalPos: Vec3 = Vec3.ZEROLocal position of the shape.
OptionallocalRot: Quat = Quat.IDENTITYLocal rotation of the shape.
OptionaluserData: number = 0User defined unsigned integer.
Fire an event, all additional arguments are passed on to the event listener.
Name of event to fire.
Optionalarg1: anyFirst argument that is passed to the event handler.
Optionalarg2: anySecond argument that is passed to the event handler.
Optionalarg3: anyThird argument that is passed to the event handler.
Optionalarg4: anyFourth argument that is passed to the event handler.
Optionalarg5: anyFifth argument that is passed to the event handler.
Optionalarg6: anySixth argument that is passed to the event handler.
Optionalarg7: anySeventh argument that is passed to the event handler.
Optionalarg8: anyEighth argument that is passed to the event handler.
Self for chaining.
Test if there are any handlers bound to an event name.
The name of the event to test.
True if the object has handlers bound to the specified event name.
Allows to modify a child shape of a mutable compound shape.
The child shape index. Children indices are zero based and have no gaps.
OptionallocalPos: Vec3 = Vec3.ZEROLocal position of the shape.
OptionallocalRot: Quat = Quat.IDENTITYLocal rotation of the shape.
OptionalshapeIndex: number = -1The index of a shape to add. It can be created by createShape.
Detach an event handler from an event. If callback is not provided then all callbacks are unbound from the event, if scope is not provided then all events with the callback will be unbound.
Optionalname: stringName of the event to unbind.
Optionalcallback: HandleEventCallbackFunction to be unbound.
Optionalscope: objectScope that was used as the this when the event is fired.
Self for chaining.
const handler = () => {};
obj.on('test', handler);
obj.off(); // Removes all events
obj.off('test'); // Removes all events called 'test'
obj.off('test', handler); // Removes all handler functions, called 'test'
obj.off('test', handler, this); // Removes all handler functions, called 'test' with scope this
Attach an event handler to an event.
Name of the event to bind the callback to.
Function that is called when event is fired. Note the callback is limited to 8 arguments.
Optionalscope: objectObject to use as 'this' when the event is fired, defaults to current this.
Can be used for removing event in the future.
Attach an event handler to an event. This handler will be removed after being fired once.
Name of the event to bind the callback to.
Function that is called when event is fired. Note the callback is limited to 8 arguments.
Optionalscope: objectObject to use as 'this' when the event is fired, defaults to current this.
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.
InterfaceBoolean, whether the shape was successfully changed or not. If there
is not enough physical space to create the shape, the shape change will fail and this will be
false.
Char Component. Describes the properties of a Jolt Virtual Character.