@react-three/rapier 0.6.7 → 0.6.9

package/dist/react-three-rapier.esm.js

@@ -5,6 +5,7 @@ import { useAsset } from 'use-asset';
 import { useFrame } from '@react-three/fiber';
 import { Quaternion, Euler, Vector3, Object3D, Matrix4, InstancedMesh, MeshBasicMaterial, Color, PlaneGeometry, ConeBufferGeometry, CapsuleBufferGeometry, CylinderBufferGeometry, BufferGeometry, BufferAttribute, SphereBufferGeometry, BoxBufferGeometry, DynamicDrawUsage } from 'three';
 import { mergeVertices } from 'three/examples/jsm/utils/BufferGeometryUtils';
+import { clamp } from 'three/src/math/MathUtils';
 import { RoundedBoxGeometry } from 'three-stdlib';
 
 const _quaternion = new Quaternion();
@@ -24,7 +25,7 @@ const rapierVector3ToVector3 = ({
   x,
   y,
   z
-}) => _vector3.set(x, y, z).clone();
+}) => _vector3.set(x, y, z);
 const rapierQuaternionToQuaternion = ({
   x,
   y,
@@ -70,6 +71,12 @@ const scaleColliderArgs = (shape, args, scale) => {
   const scaleArray = [scale.x, scale.y, scale.z, scale.x, scale.x];
   return newArgs.map((arg, index) => scaleArray[index] * arg);
 };
+
+const applyColliderOptions = (collider, options) => {
+  if (options.collisionGroups !== undefined) collider.setCollisionGroups(options.collisionGroups);
+  if (options.solverGroups !== undefined) collider.setSolverGroups(options.solverGroups);
+};
+
 const createColliderFromOptions = ({
   options,
   world,
@@ -97,10 +104,6 @@ const createColliderFromOptions = ({
     w: qRotation.w
   }).setRestitution((_options$restitution = options === null || options === void 0 ? void 0 : options.restitution) !== null && _options$restitution !== void 0 ? _options$restitution : 0).setRestitutionCombineRule((_options$restitutionC = options === null || options === void 0 ? void 0 : options.restitutionCombineRule) !== null && _options$restitutionC !== void 0 ? _options$restitutionC : CoefficientCombineRule.Average).setFriction((_options$friction = options === null || options === void 0 ? void 0 : options.friction) !== null && _options$friction !== void 0 ? _options$friction : 0.7).setFrictionCombineRule((_options$frictionComb = options === null || options === void 0 ? void 0 : options.frictionCombineRule) !== null && _options$frictionComb !== void 0 ? _options$frictionComb : CoefficientCombineRule.Average);
 
-  if (colliderShape === "heightfield") {
-    console.log(colliderDesc);
-  }
-
   if (hasCollisionEvents) {
     colliderDesc = colliderDesc.setActiveEvents(ActiveEvents.COLLISION_EVENTS);
   } // If any of the mass properties are specified, add mass properties
@@ -127,6 +130,7 @@ const createColliderFromOptions = ({
   }
 
   const collider = world.createCollider(colliderDesc, rigidBody);
+  applyColliderOptions(collider, options);
   return collider;
 };
 
@@ -147,7 +151,6 @@ const createCollidersFromChildren = ({
 }) => {
   const hasCollisionEvents = !!(options.onCollisionEnter || options.onCollisionExit);
   const colliders = [];
-  new Vector3();
   object.traverseVisible(child => {
     if ("isMesh" in child) {
       if (_ignoreMeshColliders && isChildOfMeshCollider(child)) return;
@@ -193,6 +196,7 @@ const createCollidersFromChildren = ({
       });
       const actualRigidBody = rigidBody ? world.getRigidBody(rigidBody.handle) : undefined;
       const collider = world.createCollider(desc, actualRigidBody);
+      applyColliderOptions(collider, options);
       colliders.push(collider);
     }
   });
@@ -303,12 +307,7 @@ const createRigidBodyApi = ref => {
     addTorque: torque => ref.current().addTorque(torque, true),
 
     translation() {
-      const {
-        x,
-        y,
-        z
-      } = ref.current().translation();
-      return new Vector3(x, y, z);
+      return rapierVector3ToVector3(ref.current().translation());
     },
 
     setTranslation: translation => ref.current().setTranslation(translation, true),
@@ -323,18 +322,8 @@ const createRigidBodyApi = ref => {
       return new Quaternion(x, y, z, w);
     },
 
-    setRotation: ({
-      x,
-      y,
-      z
-    }) => {
-      const q = vector3ToQuaternion(new Vector3(x, y, z));
-      ref.current().setRotation({
-        x: q.x,
-        y: q.y,
-        z: q.z,
-        w: q.w
-      }, true);
+    setRotation: rotation => {
+      ref.current().setRotation(rotation, true);
     },
 
     linvel() {
@@ -370,18 +359,8 @@ const createRigidBodyApi = ref => {
     },
 
     setAngularDamping: factor => ref.current().setAngularDamping(factor),
-    setNextKinematicRotation: ({
-      x,
-      y,
-      z
-    }) => {
-      const q = vector3ToQuaternion(new Vector3(x, y, z));
-      ref.current().setNextKinematicRotation({
-        x: q.x,
-        y: q.y,
-        z: q.z,
-        w: q.w
-      });
+    setNextKinematicRotation: rotation => {
+      ref.current().setNextKinematicRotation(rotation);
     },
     setNextKinematicTranslation: translation => ref.current().setNextKinematicTranslation(translation),
     resetForces: () => ref.current().resetForces(true),
@@ -455,7 +434,8 @@ const Physics = ({
   children,
   timeStep: _timeStep = 1 / 60,
   maxSubSteps: _maxSubSteps = 10,
-  paused: _paused = false
+  paused: _paused = false,
+  updatePriority
 }) => {
   const rapier = useAsset(importRapier);
   const [isPaused, setIsPaused] = useState(_paused);
@@ -471,9 +451,9 @@ const Physics = ({
 
     return worldRef.current;
   });
-  const [colliderMeshes] = useState(() => new Map());
   const [rigidBodyStates] = useState(() => new Map());
   const [rigidBodyEvents] = useState(() => new Map());
+  const [colliderEvents] = useState(() => new Map());
   const [eventQueue] = useState(() => new EventQueue(false)); // Init world
 
   useEffect(() => {
@@ -503,12 +483,12 @@ const Physics = ({
     world.timestep = _timeStep;
     /**
      * Fixed timeStep simulation progression
-     * @see https://gafferongames.com/post/fix_your_timestep/ 
+     * @see https://gafferongames.com/post/fix_your_timestep/
     */
 
     let previousTranslations = {}; // don't step time forwards if paused
 
-    const nowTime = steppingState.time += _paused ? 0 : delta * 1000;
+    const nowTime = steppingState.time += _paused ? 0 : clamp(delta, 0, 1) * 1000;
     const timeStepMs = _timeStep * 1000;
     const timeSinceLast = nowTime - steppingState.lastTime;
     steppingState.lastTime = nowTime;
@@ -558,7 +538,7 @@ const Physics = ({
       }
 
       let oldState = previousTranslations[rigidBody.handle];
-      let newTranslation = rapierVector3ToVector3(rigidBody.translation());
+      let newTranslation = rigidBody.translation();
       let newRotation = rapierQuaternionToQuaternion(rigidBody.rotation());
       let interpolatedTranslation = oldState ? oldState.translation.lerp(newTranslation, 1) : newTranslation;
       let interpolatedRotation = oldState ? oldState.rotation.slerp(newRotation, interpolationAlpha) : newRotation;
@@ -577,42 +557,71 @@ const Physics = ({
       const rigidBodyHandle1 = (_collider1$parent = collider1.parent()) === null || _collider1$parent === void 0 ? void 0 : _collider1$parent.handle;
       const rigidBodyHandle2 = (_collider2$parent = collider2.parent()) === null || _collider2$parent === void 0 ? void 0 : _collider2$parent.handle;
 
-      if (!collider1 || !collider2 || !rigidBodyHandle1 || !rigidBodyHandle2) {
+      if (!collider1 || !collider2 || rigidBodyHandle1 === undefined || rigidBodyHandle2 === undefined) {
         return;
       }
 
       const rigidBody1 = world.getRigidBody(rigidBodyHandle1);
       const rigidBody2 = world.getRigidBody(rigidBodyHandle2);
-      const events1 = rigidBodyEvents.get(rigidBodyHandle1);
-      const events2 = rigidBodyEvents.get(rigidBodyHandle2);
+      const rigidBody1Events = rigidBodyEvents.get(rigidBodyHandle1);
+      const rigidBoyd2Events = rigidBodyEvents.get(rigidBodyHandle2);
+      const collider1Events = colliderEvents.get(collider1.handle);
+      const collider2Events = colliderEvents.get(collider2.handle);
 
       if (started) {
         world.contactPair(collider1, collider2, (manifold, flipped) => {
-          var _events1$onCollisionE, _events2$onCollisionE;
+          var _rigidBody1Events$onC, _rigidBoyd2Events$onC, _collider1Events$onCo, _collider2Events$onCo;
+
+          /* RigidBody events */
+          rigidBody1Events === null || rigidBody1Events === void 0 ? void 0 : (_rigidBody1Events$onC = rigidBody1Events.onCollisionEnter) === null || _rigidBody1Events$onC === void 0 ? void 0 : _rigidBody1Events$onC.call(rigidBody1Events, {
+            target: rigidBody2,
+            collider: collider2,
+            manifold,
+            flipped
+          });
+          rigidBoyd2Events === null || rigidBoyd2Events === void 0 ? void 0 : (_rigidBoyd2Events$onC = rigidBoyd2Events.onCollisionEnter) === null || _rigidBoyd2Events$onC === void 0 ? void 0 : _rigidBoyd2Events$onC.call(rigidBoyd2Events, {
+            target: rigidBody1,
+            collider: collider1,
+            manifold,
+            flipped
+          });
+          /* Collider events */
 
-          events1 === null || events1 === void 0 ? void 0 : (_events1$onCollisionE = events1.onCollisionEnter) === null || _events1$onCollisionE === void 0 ? void 0 : _events1$onCollisionE.call(events1, {
+          collider1Events === null || collider1Events === void 0 ? void 0 : (_collider1Events$onCo = collider1Events.onCollisionEnter) === null || _collider1Events$onCo === void 0 ? void 0 : _collider1Events$onCo.call(collider1Events, {
             target: rigidBody2,
+            collider: collider2,
             manifold,
             flipped
           });
-          events2 === null || events2 === void 0 ? void 0 : (_events2$onCollisionE = events2.onCollisionEnter) === null || _events2$onCollisionE === void 0 ? void 0 : _events2$onCollisionE.call(events2, {
+          collider2Events === null || collider2Events === void 0 ? void 0 : (_collider2Events$onCo = collider2Events.onCollisionEnter) === null || _collider2Events$onCo === void 0 ? void 0 : _collider2Events$onCo.call(collider2Events, {
             target: rigidBody1,
+            collider: collider1,
             manifold,
             flipped
           });
         });
       } else {
-        var _events1$onCollisionE2, _events2$onCollisionE2;
+        var _rigidBody1Events$onC2, _rigidBoyd2Events$onC2, _collider1Events$onCo2, _collider2Events$onCo2;
 
-        events1 === null || events1 === void 0 ? void 0 : (_events1$onCollisionE2 = events1.onCollisionExit) === null || _events1$onCollisionE2 === void 0 ? void 0 : _events1$onCollisionE2.call(events1, {
-          target: rigidBody2
+        rigidBody1Events === null || rigidBody1Events === void 0 ? void 0 : (_rigidBody1Events$onC2 = rigidBody1Events.onCollisionExit) === null || _rigidBody1Events$onC2 === void 0 ? void 0 : _rigidBody1Events$onC2.call(rigidBody1Events, {
+          target: rigidBody2,
+          collider: collider2
+        });
+        rigidBoyd2Events === null || rigidBoyd2Events === void 0 ? void 0 : (_rigidBoyd2Events$onC2 = rigidBoyd2Events.onCollisionExit) === null || _rigidBoyd2Events$onC2 === void 0 ? void 0 : _rigidBoyd2Events$onC2.call(rigidBoyd2Events, {
+          target: rigidBody1,
+          collider: collider1
         });
-        events2 === null || events2 === void 0 ? void 0 : (_events2$onCollisionE2 = events2.onCollisionExit) === null || _events2$onCollisionE2 === void 0 ? void 0 : _events2$onCollisionE2.call(events2, {
-          target: rigidBody1
+        collider1Events === null || collider1Events === void 0 ? void 0 : (_collider1Events$onCo2 = collider1Events.onCollisionExit) === null || _collider1Events$onCo2 === void 0 ? void 0 : _collider1Events$onCo2.call(collider1Events, {
+          target: rigidBody2,
+          collider: collider2
+        });
+        collider2Events === null || collider2Events === void 0 ? void 0 : (_collider2Events$onCo2 = collider2Events.onCollisionExit) === null || _collider2Events$onCo2 === void 0 ? void 0 : _collider2Events$onCo2.call(collider2Events, {
+          target: rigidBody1,
+          collider: collider1
         });
       }
     });
-  });
+  }, updatePriority);
   const api = useMemo(() => createWorldApi(getWorldRef), []);
   const context = useMemo(() => ({
     rapier,
@@ -621,9 +630,9 @@ const Physics = ({
       colliders: _colliders,
       gravity: _gravity
     },
-    colliderMeshes,
     rigidBodyStates,
     rigidBodyEvents,
+    colliderEvents,
     isPaused
   }), [isPaused]);
   return /*#__PURE__*/React.createElement(RapierContext.Provider, {
@@ -1289,22 +1298,26 @@ const InstancedRigidBodies = /*#__PURE__*/forwardRef((props, ref) => {
   }, props.children));
 });
 
-const _excluded = ["children"];
+const _excluded = ["children", "onCollisionEnter", "onCollisionExit"];
 
 const AnyCollider = _ref => {
   let {
-    children
+    children,
+    onCollisionEnter,
+    onCollisionExit
   } = _ref,
       props = _objectWithoutProperties(_ref, _excluded);
 
   const {
-    world
+    world,
+    colliderEvents
   } = useRapier();
   const rigidBodyContext = useRigidBodyContext();
   const ref = useRef(null);
   useEffect(() => {
     const scale = ref.current.getWorldScale(new Vector3());
-    const colliders = []; // If this is an InstancedRigidBody api
+    const colliders = [];
+    const hasCollisionEvents = (rigidBodyContext === null || rigidBodyContext === void 0 ? void 0 : rigidBodyContext.hasCollisionEvents) || !!onCollisionEnter || !!onCollisionExit; // If this is an InstancedRigidBody api
 
     if (rigidBodyContext && "at" in rigidBodyContext.api) {
       rigidBodyContext.api.forEach((body, index) => {
@@ -1317,26 +1330,41 @@ const AnyCollider = _ref => {
         }
 
         colliders.push(createColliderFromOptions({
-          options: props,
+          options: _objectSpread2({
+            solverGroups: rigidBodyContext.options.solverGroups,
+            collisionGroups: rigidBodyContext.options.collisionGroups
+          }, props),
           world,
           rigidBody: body.raw(),
           scale: instanceScale,
-          hasCollisionEvents: rigidBodyContext === null || rigidBodyContext === void 0 ? void 0 : rigidBodyContext.hasCollisionEvents
+          hasCollisionEvents
         }));
       });
     } else {
       colliders.push(createColliderFromOptions({
-        options: props,
+        options: _objectSpread2({
+          solverGroups: (rigidBodyContext === null || rigidBodyContext === void 0 ? void 0 : rigidBodyContext.options.solverGroups) || props.solverGroups,
+          collisionGroups: (rigidBodyContext === null || rigidBodyContext === void 0 ? void 0 : rigidBodyContext.options.collisionGroups) || props.collisionGroups
+        }, props),
         world,
         // Initiate with a rigidbody, or undefined, because colliders can exist without a rigid body
         rigidBody: rigidBodyContext && "raw" in rigidBodyContext.api ? rigidBodyContext.api.raw() : undefined,
         scale,
-        hasCollisionEvents: rigidBodyContext === null || rigidBodyContext === void 0 ? void 0 : rigidBodyContext.hasCollisionEvents
+        hasCollisionEvents
       }));
     }
+    /* Register collision events. */
 
+
+    colliders.forEach(collider => colliderEvents.set(collider.handle, {
+      onCollisionEnter,
+      onCollisionExit
+    }));
     return () => {
-      colliders.forEach(collider => world.removeCollider(collider));
+      colliders.forEach(collider => {
+        colliderEvents.delete(collider.handle);
+        world.removeCollider(collider);
+      });
     };
   }, []);
   return /*#__PURE__*/React.createElement("object3D", {
@@ -1390,4 +1418,40 @@ const ConvexHullCollider = props => {
   }));
 };
 
-export { BallCollider, CapsuleCollider, ConeCollider, ConvexHullCollider, CuboidCollider, CylinderCollider, Debug, HeightfieldCollider, InstancedRigidBodies, MeshCollider, Physics, RigidBody, RoundCuboidCollider, TrimeshCollider, useFixedJoint, useImpulseJoint, usePrismaticJoint, useRapier, useRevoluteJoint, useRigidBody, useSphericalJoint };
+/**
+ * Calculates an InteractionGroup bitmask for use in the `collisionGroups` or `solverGroups`
+ * properties of RigidBody or Collider components. The first argument represents a list of
+ * groups the entity is in (expressed as numbers from 0 to 15). The second argument is a list
+ * of groups that will be filtered against. When it is omitted, all groups are filtered against.
+ *
+ * @example
+ * A RigidBody that is member of group 0 and will collide with everything from groups 0 and 1:
+ *
+ * ```tsx
+ * <RigidBody collisionGroups={interactionGroups([0], [0, 1])} />
+ * ```
+ *
+ * A RigidBody that is member of groups 0 and 1 and will collide with everything else:
+ *
+ * ```tsx
+ * <RigidBody collisionGroups={interactionGroups([0, 1])} />
+ * ```
+ *
+ * A RigidBody that is member of groups 0 and 1 and will not collide with anything:
+ *
+ * ```tsx
+ * <RigidBody collisionGroups={interactionGroups([0, 1], [])} />
+ * ```
+ *
+ * Please note that Rapier needs interaction filters to evaluate to true between _both_ colliding
+ * entities for collision events to trigger.
+ *
+ * @param memberships Groups the collider is a member of. (Values can range from 0 to 15.)
+ * @param filters Groups the interaction group should filter against. (Values can range from 0 to 15.)
+ * @returns An InteractionGroup bitmask.
+ */
+const interactionGroups = (memberships, filters) => (bitmask(memberships) << 16) + (filters !== undefined ? bitmask(filters) : 0b1111111111111111);
+
+const bitmask = groups => [groups].flat().reduce((acc, layer) => acc | 1 << layer, 0);
+
+export { BallCollider, CapsuleCollider, ConeCollider, ConvexHullCollider, CuboidCollider, CylinderCollider, Debug, HeightfieldCollider, InstancedRigidBodies, MeshCollider, Physics, RigidBody, RoundCuboidCollider, TrimeshCollider, interactionGroups, useFixedJoint, useImpulseJoint, usePrismaticJoint, useRapier, useRevoluteJoint, useRigidBody, useSphericalJoint };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@react-three/rapier",
-  "version": "0.6.7",
+  "version": "0.6.9",
   "source": "src/index.ts",
   "main": "dist/react-three-rapier.cjs.js",
   "module": "dist/react-three-rapier.esm.js",
@@ -20,12 +20,12 @@
   "peerDependencies": {
     "@react-three/fiber": "^8.0.12",
     "react": "^18.0.0",
-    "three": "^0.139.2",
-    "three-stdlib": "^2.15.0"
+    "three": ">=0.139.2"
   },
   "dependencies": {
     "@dimforge/rapier3d-compat": "0.9.0",
-    "use-asset": "^1.0.4"
+    "use-asset": "^1.0.4",
+    "three-stdlib": "^2.15.0"
   },
   "repository": "https://github.com/pmndrs/react-three-rapier/tree/master/packages/react-three-rapier"
 }

package/readme.md

@@ -1,10 +1,10 @@
 <p align="center">
-  <img src="https://raw.githubusercontent.com/pmndrs/react-three-rapier/HEAD/packages/react-three-rapier/misc/hero.svg" alt="@react-three/rapier" />
+  <a href="#"><img src="https://raw.githubusercontent.com/pmndrs/react-three-rapier/HEAD/packages/react-three-rapier/misc/hero.svg" alt="@react-three/rapier" /></a>
 </p>
 
 <p align="center">
-  <img src="https://img.shields.io/npm/v/@react-three/rapier?style=for-the-badge&colorA=0099DA&colorB=ffffff" />
-  <img src="https://img.shields.io/discord/740090768164651008?style=for-the-badge&colorA=0099DA&colorB=ffffff&label=discord&logo=discord&logoColor=ffffff)](https://discord.gg/ZZjjNvJ" />
+  <a href="https://www.npmjs.com/package/@react-three/rapier"><img src="https://img.shields.io/npm/v/@react-three/rapier?style=for-the-badge&colorA=0099DA&colorB=ffffff" /></a>
+  <a href="https://discord.gg/ZZjjNvJ"><img src="https://img.shields.io/discord/740090768164651008?style=for-the-badge&colorA=0099DA&colorB=ffffff&label=discord&logo=discord&logoColor=ffffff" /></a>
 </p>
 
 <p align="center">⚠️ Under heavy development. All APIs are subject to change. ⚠️</p>
@@ -141,7 +141,7 @@ const Scene = () => {
     instancedApi.at(40).applyImpulse({ x: 0, y: 10, z: 0 });
 
     // Or update all instances as if they were in an array
-    instancedApi.forEach((api) => {
+    instancedApi.forEach(api => {
       api.applyImpulse({ x: 0, y: 10, z: 0 });
     });
   }, []);
@@ -153,13 +153,13 @@ const Scene = () => {
   const rotations = Array.from({ length: COUNT }, (_, index) => [
     Math.random(),
     Math.random(),
-    Math.random(),
+    Math.random()
   ]);
 
   const scales = Array.from({ length: COUNT }, (_, index) => [
     Math.random(),
     Math.random(),
-    Math.random(),
+    Math.random()
   ]);
 
   return (
@@ -212,7 +212,7 @@ const Scene = () => {
 
 ## Events
 
-You can subscribe collision and state events on the RigidBody.
+You can subscribe to collision and state events on the RigidBody:
 
 ```tsx
 const RigidBottle = () => {
@@ -235,6 +235,60 @@ return (
 }
 ```
 
+You may also subscribe to collision events on individual colliders:
+
+```tsx
+<CuboidCollider
+  onCollisionEnter={payload => {
+    /* ... */
+  }}
+  onCollisionExit={payload => {
+    /* ... */
+  }}
+/>
+```
+
+The `payload` object for all collision callbacks contains the following properties:
+
+- `target`  
+  The other rigidbody that was involved in the collision event.
+- `collider`  
+  The other collider that was involved in the collision event.
+- `manifold` (enter only)  
+  The [contact manifold](https://rapier.rs/javascript3d/classes/TempContactManifold.html) generated by the collision event.
+- `flipped` (enter only)  
+  `true` if the data in the `manifold` [is flipped](https://rapier.rs/javascript3d/classes/World.html#contactPair).
+
+### Configuring collision and solver groups
+
+Both `<RigidBody>` as well as all collider components allow you to configure `collisionsGroups` and `solverGroups` properties that configures which groups the colliders are in, and what other groups they should interact with in potential collision and solving events (you will find more details on this in the [Rapier documentation](https://rapier.rs/docs/user_guides/javascript/colliders/#collision-groups-and-solver-groups).)
+
+Since these are set as bitmasks and bitmasks can get a bit unwieldy to generate, this library provides a helper called `interactionGroups` that can be used to generate bitmasks from numbers and arrays of groups, where groups are identified using numbers from 0 to 15.
+
+The first argument is the group, or an array of groups, that the collider is a member of; the second argument is the group, or an array of groups, that the collider should interact with.
+
+Here the collider is in group 0, and interacts with colliders from groups 0, 1 and 2:
+
+```tsx
+<CapsuleCollider collisionGroups={interactionGroups(0, [0, 1, 2])} />
+```
+
+This collider is in multiple groups, but only interacts with colliders from a single group:
+
+```tsx
+<CapsuleCollider collisionGroups={interactionGroups([0, 5], 7)} />
+```
+
+When the second argument is omitted, the collider will interact with all groups:
+
+```tsx
+<CapsuleCollider collisionGroups={interactionGroups(12)} />
+```
+
+> **Note** Please remember that in Rapier, for a collision (or solving) event to occur, both colliders involved in the event must match the related interaction groups -- a one-way match will be ignored.
+
+> **Note** By default, colliders are members of all groups, and will interact with all other groups.
+
 ## Joints
 
 WIP
@@ -255,7 +309,7 @@ In order, but also not necessarily:
 - [x] Colliders outside RigidBodies
 - [x] InstancedMesh support
 - [x] Timestep improvements for determinism
-- [ ] Normalize and improve collision events (add events to single Colliders, InstancedRigidBodies, etc)
+- [x] Normalize and improve collision events (add events to single Colliders)
+- [ ] Add collision events to InstancedRigidBodies
 - [ ] Docs
 - [ ] CodeSandbox examples
-- [ ] Helpers, for things like Vehicle, Rope, Player, etc