Construct 3 3D Physics

Note versions 2.x.x are based around the rapier physics engine. Use only examples with 'Rapier' in the filename.

In demo above click mouse to do raycast, create another 3DShape at the raycast hit point and apply a little impulse force. 

To further support development:

• 3D Shape: Box, Wedge, Corner-in, Corner-out, Prism, Pyramid
• 3D Object: Capsule, Box, Cylinder, Sphere collider around 3D Object
• Only z axis rotation (3D Shape supports other rotation with the rotate 3d behavior or 3D Object without rotate 3d behavior)
• Apply impulse (and towards position)
• Immovable / movable
• World gravity setting
  
• 3D raycast with group filter
• Set mass
• Set velocity
• Set linear, angular damping
• Set collision filter group/mask
• Apply force (and towards position)
• Apply torque
• Support 3DShape full 3D rotation using Rotate 3D Behavior.
  
• Add Trigger for raycastResult available
• Add expression for x,y,z velocity
• Physics engine runs in worker to offload main runtime thread CPU
• Kinematic Character Controller
• Spherical joint
• Trimesh collider for Sprite with Mesh

Open to feedback and development collaboration for future rev share, leave comments or contact me on C3 Community Discord (@mikal1464)

Near term future work

• [Rapier] 3D Object support (fixed box collider first, others later)
• [Rapier] Add heightfield for sprite w/ mesh
• [Rapier] Collision group/filter
  
• [Rapier] OnCollision trigger
• [Rapier] CollisionData (from the OnCollision trigger)
• Add Trigger for raycastResult available (synchronous now anyway, but future may be async)
• Apply impulse towards position
• Detect runtime changes of C3 object size and update physics body.
  
• Heightfield
• Add expression for x,y,z velocity
  
• More 3D Shape shapes corner-in, corner-out, pyramid, prism
  
• Support 3DShape full 3D rotation using Rotate 3D Behavior.
  
• Disable collisions on body (use collision filter group/mask)
  
• More raycast options (array of all objects hit, collision filterGroup and mask, skipface), raycast to a particular body (probably identified by UID)
• Collision filterGroups and masks
• Apply force
  
• Apply torque

Usage Notes:

Worker mode

• Do not enable the C3 project setting 'Use worker'. Explicitly change the setting to 'no', do not leave as 'auto'. 
• Setting 'Use worker' to 'yes' breaks one of the libraries being used 'comlink' and will show up as cast ray and cast shape no longer working. I will look for a work around in the future.

3D Shape

• Natively 3D Shape only supports Z axis rotation, physics will do the same.
• To implement full 3D rotation for 3D Shape (including physics) add the free Rotate 3D behavior to 3DShape.
• With both behaviors used together, the Z angle can still be overridden by C3 behavior and ACEs and the X,Y rotation will be controlled by physics.

3D Object

• Natively supports x,y,z rotation. Do not add Rotate 3D behavior
• Specify collider abstraction to be used with 3D Object (Capsule, Box...)

Performance

• Use collision filter group and mask to limit the number of collision checks. For example in a platformer, immovable terrain does not need to be able to collide with itself. See the suggestions in the collisioFilter.txt file from Foozle.
• Also use filter group and mask with with raycast if it is used often.

Example rayacastExample-mouselook courtesy of: Fodi

For character control see the project example: RapierKinematicCharacter.c3p

For more implementations, look at other 'Rapier' project examples.

For general concepts, this addon is a small subset of the Rapier physics js library functionality.

For more information and general concepts of the Rapier library, see:

• https://rapier.rs/docs/user_guides/javascript/rigid_bodies
• https://rapier.rs/docs/user_guides/javascript/colliders
• https://rapier.rs/docs/user_guides/javascript/joints
• https://rapier.rs/docs/user_guides/javascript/character_controller
• https://rapier.rs/docs/user_guides/javascript/scene_queries
• https://rapier.rs/docs/user_guides/javascript/common_mistakes

Note versions 2.x.x use an experimental rapier physics engine with limited features. Use only examples with 'Rapier' in the filename.