@react-three/rapier 0.7.4 → 0.7.5

package/dist/declarations/src/AnyCollider.d.ts

@@ -1,9 +1,10 @@
+import { Collider } from "@dimforge/rapier3d-compat";
 import React, { ReactNode } from "react";
 import { UseColliderOptions, CuboidArgs, RoundCuboidArgs, BallArgs, CapsuleArgs, HeightfieldArgs, TrimeshArgs, ConeArgs, CylinderArgs, ConvexHullArgs } from "./types";
 export interface ColliderProps extends UseColliderOptions<any> {
     children?: ReactNode;
 }
-export declare const AnyCollider: React.MemoExoticComponent<(props: ColliderProps) => JSX.Element>;
+export declare const AnyCollider: React.MemoExoticComponent<React.ForwardRefExoticComponent<ColliderProps & React.RefAttributes<Collider[]>>>;
 declare type UseColliderOptionsRequiredArgs<T extends unknown[]> = Omit<UseColliderOptions<T>, "args"> & {
     args: T;
     children?: ReactNode;
@@ -17,13 +18,40 @@ export declare type TrimeshColliderProps = UseColliderOptionsRequiredArgs<Trimes
 export declare type ConeColliderProps = UseColliderOptionsRequiredArgs<ConeArgs>;
 export declare type CylinderColliderProps = UseColliderOptionsRequiredArgs<CylinderArgs>;
 export declare type ConvexHullColliderProps = UseColliderOptionsRequiredArgs<ConvexHullArgs>;
-export declare const CuboidCollider: (props: CuboidColliderProps) => JSX.Element;
-export declare const RoundCuboidCollider: (props: RoundCuboidColliderProps) => JSX.Element;
-export declare const BallCollider: (props: BallColliderProps) => JSX.Element;
-export declare const CapsuleCollider: (props: CapsuleColliderProps) => JSX.Element;
-export declare const HeightfieldCollider: (props: HeightfieldColliderProps) => JSX.Element;
-export declare const TrimeshCollider: (props: TrimeshColliderProps) => JSX.Element;
-export declare const ConeCollider: (props: ConeColliderProps) => JSX.Element;
-export declare const CylinderCollider: (props: CylinderColliderProps) => JSX.Element;
-export declare const ConvexHullCollider: (props: ConvexHullColliderProps) => JSX.Element;
+export declare const CuboidCollider: React.ForwardRefExoticComponent<Omit<UseColliderOptions<CuboidArgs>, "args"> & {
+    args: CuboidArgs;
+    children?: ReactNode;
+} & React.RefAttributes<Collider[]>>;
+export declare const RoundCuboidCollider: React.ForwardRefExoticComponent<Omit<UseColliderOptions<RoundCuboidArgs>, "args"> & {
+    args: RoundCuboidArgs;
+    children?: ReactNode;
+} & React.RefAttributes<Collider[]>>;
+export declare const BallCollider: React.ForwardRefExoticComponent<Omit<UseColliderOptions<BallArgs>, "args"> & {
+    args: BallArgs;
+    children?: ReactNode;
+} & React.RefAttributes<Collider[]>>;
+export declare const CapsuleCollider: React.ForwardRefExoticComponent<Omit<UseColliderOptions<CapsuleArgs>, "args"> & {
+    args: CapsuleArgs;
+    children?: ReactNode;
+} & React.RefAttributes<Collider[]>>;
+export declare const HeightfieldCollider: React.ForwardRefExoticComponent<Omit<UseColliderOptions<HeightfieldArgs>, "args"> & {
+    args: HeightfieldArgs;
+    children?: ReactNode;
+} & React.RefAttributes<Collider[]>>;
+export declare const TrimeshCollider: React.ForwardRefExoticComponent<Omit<UseColliderOptions<TrimeshArgs>, "args"> & {
+    args: TrimeshArgs;
+    children?: ReactNode;
+} & React.RefAttributes<Collider[]>>;
+export declare const ConeCollider: React.ForwardRefExoticComponent<Omit<UseColliderOptions<ConeArgs>, "args"> & {
+    args: ConeArgs;
+    children?: ReactNode;
+} & React.RefAttributes<Collider[]>>;
+export declare const CylinderCollider: React.ForwardRefExoticComponent<Omit<UseColliderOptions<CylinderArgs>, "args"> & {
+    args: CylinderArgs;
+    children?: ReactNode;
+} & React.RefAttributes<Collider[]>>;
+export declare const ConvexHullCollider: React.ForwardRefExoticComponent<Omit<UseColliderOptions<ConvexHullArgs>, "args"> & {
+    args: ConvexHullArgs;
+    children?: ReactNode;
+} & React.RefAttributes<Collider[]>>;
 export {};

package/dist/declarations/src/api.d.ts

@@ -22,27 +22,27 @@ export interface RigidBodyApi {
     /**
      * Applies an impulse at the center-of-mass of this rigid-body.
      */
-    applyImpulse(impulseVector: Vector3Object): void;
+    applyImpulse(impulseVector: Vector3Object, wakeUp: boolean): void;
     /**
      * Applies an impulsive torque at the center-of-mass of this rigid-body.
      */
-    applyTorqueImpulse(torqueVector: Vector3Object): void;
+    applyTorqueImpulse(torqueVector: Vector3Object, wakeUp: boolean): void;
     /**
      * Applies an impulse at the given world-space point of this rigid-body.
      */
-    applyImpulseAtPoint(impulseVector: Vector3Object, impulsePoint: Vector3Object): void;
+    applyImpulseAtPoint(impulseVector: Vector3Object, impulsePoint: Vector3Object, wakeUp: boolean): void;
     /**
      * Adds a force at the center-of-mass of this rigid-body.
      */
-    addForce(force: Vector3Object): void;
+    addForce(force: Vector3Object, wakeUp: boolean): void;
     /**
      * Adds a force at the given world-space point of this rigid-body.
      */
-    addForceAtPoint(force: Vector3Object, point: Vector3Object): void;
+    addForceAtPoint(force: Vector3Object, point: Vector3Object, wakeUp: boolean): void;
     /**
      * Adds a torque at the center-of-mass of this rigid-body.
      */
-    addTorque(torque: Vector3Object): void;
+    addTorque(torque: Vector3Object, wakeUp: boolean): void;
     /**
      * The world-space translation of this rigid-body.
      */
@@ -50,7 +50,7 @@ export interface RigidBodyApi {
     /**
      * Sets the translation of this rigid-body.
      */
-    setTranslation(translation: Vector3Object): void;
+    setTranslation(translation: Vector3Object, wakeUp: boolean): void;
     /**
      * The world-space orientation of this rigid-body.
      */
@@ -58,7 +58,7 @@ export interface RigidBodyApi {
     /**
      * Sets the rotation quaternion of this rigid-body.
      */
-    setRotation(rotation: Quaternion): void;
+    setRotation(rotation: Quaternion, wakeUp: boolean): void;
     /**
      * The linear velocity of this rigid-body.
      */
@@ -66,7 +66,7 @@ export interface RigidBodyApi {
     /**
      * Sets the linear velocity of this rigid-body.
      */
-    setLinvel(velocity: Vector3Object): void;
+    setLinvel(velocity: Vector3Object, wakeUp: boolean): void;
     /**
      * The angular velocity of this rigid-body.
      */
@@ -74,7 +74,7 @@ export interface RigidBodyApi {
     /**
      * Sets the angular velocity of this rigid-body.
      */
-    setAngvel(velocity: Vector3Object): void;
+    setAngvel(velocity: Vector3Object, wakeUp: boolean): void;
     /**
      * The linear damping of this rigid-body.
      */
@@ -112,27 +112,27 @@ export interface RigidBodyApi {
     /**
      * Resets to zero the user forces (but not torques) applied to this rigid-body.
      */
-    resetForces(): void;
+    resetForces(wakeUp: boolean): void;
     /**
      * Resets to zero the user torques applied to this rigid-body.
      */
-    resetTorques(): void;
+    resetTorques(wakeUp: boolean): void;
     /**
      * Locks or unlocks the ability of this rigid-body to rotate.
      */
-    lockRotations(locked: boolean): void;
+    lockRotations(locked: boolean, wakeUp: boolean): void;
     /**
      * Locks or unlocks the ability of this rigid-body to translate.
      */
-    lockTranslations(locked: boolean): void;
+    lockTranslations(locked: boolean, wakeUp: boolean): void;
     /**
      * Locks or unlocks the ability of this rigid-body to rotate along individual coordinate axes.
      */
-    setEnabledRotations(x: boolean, y: boolean, z: boolean): void;
+    setEnabledRotations(x: boolean, y: boolean, z: boolean, wakeUp: boolean): void;
     /**
      * Locks or unlocks the ability of this rigid-body to translate along individual coordinate axes.
      */
-    setEnabledTranslations(x: boolean, y: boolean, z: boolean): void;
+    setEnabledTranslations(x: boolean, y: boolean, z: boolean, wakeUp: boolean): void;
 }
 export declare const createRigidBodyApi: (ref: RefGetter<RigidBody>) => RigidBodyApi;
 export interface InstancedRigidBodyApi {
@@ -155,9 +155,9 @@ export interface WorldApi {
     createRigidBody(desc: RigidBodyDesc): RigidBody;
     createCollider(desc: ColliderDesc, parent?: RigidBody): Collider;
     removeRigidBody(rigidBody: RigidBody): void;
-    removeCollider(collider: Collider): void;
-    createImpulseJoint(params: JointData, rigidBodyA: RigidBody, rigidBodyB: RigidBody): ImpulseJoint;
-    removeImpulseJoint(joint: ImpulseJoint): void;
+    removeCollider(collider: Collider, wakeUp: boolean): void;
+    createImpulseJoint(params: JointData, rigidBodyA: RigidBody, rigidBodyB: RigidBody, wakeUp: boolean): ImpulseJoint;
+    removeImpulseJoint(joint: ImpulseJoint, wakeUp: boolean): void;
     forEachCollider(callback: (collider: Collider) => void): void;
     setGravity(gravity: Vector3): void;
 }

package/dist/declarations/src/types.d.ts

@@ -6,6 +6,7 @@ import { Object3DProps } from "@react-three/fiber";
 import { Object3D } from "three";
 export { CoefficientCombineRule as CoefficientCombineRule } from "@dimforge/rapier3d-compat";
 export { RapierRigidBody, RapierCollider };
+import { Rotation, Vector } from "@dimforge/rapier3d-compat/math";
 export declare type RefGetter<T> = MutableRefObject<() => T | undefined>;
 export declare type RigidBodyAutoCollider = "ball" | "cuboid" | "hull" | "trimesh" | false;
 export interface UseRigidBodyAPI {
@@ -81,18 +82,6 @@ export interface UseColliderOptions<ColliderArgs extends Array<unknown>> {
      * Arguments to pass to the collider
      */
     args?: ColliderArgs;
-    /**
-     * The mass of this collider.
-     * The mass and density is automatically calculated based on the shape of the collider.
-     * Generally, it's not recommended to adjust the mass properties as it could lead to
-     * unexpected behaviors.
-     * More info https://rapier.rs/docs/user_guides/javascript/colliders#mass-properties
-     */
-    mass?: number;
-    /**
-     * The center of mass of this rigid body
-     */
-    centerOfMass?: Vector3Array;
     /**
      * Principal angular inertia of this rigid body
      */
@@ -157,8 +146,30 @@ export interface UseColliderOptions<ColliderArgs extends Array<unknown>> {
     solverGroups?: InteractionGroups;
     /**
      * Sets the uniform density of this collider.
+     * If this is set, other mass-properties like the angular inertia tensor are computed
+     * automatically from the collider's shape.
+     * Cannot be used at the same time as the mass or massProperties values.
+     * More info https://rapier.rs/docs/user_guides/javascript/colliders#mass-properties
      */
     density?: number;
+    /**
+     * The mass of this collider.
+     * Generally, it's not recommended to adjust the mass properties as it could lead to
+     * unexpected behaviors.
+     * Cannot be used at the same time as the density or massProperties values.
+     * More info https://rapier.rs/docs/user_guides/javascript/colliders#mass-properties
+     */
+    mass?: number;
+    /**
+     * The mass properties of this rigid body.
+     * Cannot be used at the same time as the density or mass values.
+     */
+    massProperties?: {
+        mass: number;
+        centerOfMass: Vector;
+        principalAngularInertia: Vector;
+        angularInertiaLocalFrame: Rotation;
+    };
     /**
      * Sets whether or not this collider is a sensor.
      */

package/dist/react-three-rapier.cjs.dev.js

@@ -84,24 +84,24 @@ const createRigidBodyApi = ref => {
 
     mass: () => ref.current().mass(),
 
-    applyImpulse(impulseVector) {
-      ref.current().applyImpulse(impulseVector, true);
+    applyImpulse(impulseVector, wakeUp = true) {
+      ref.current().applyImpulse(impulseVector, wakeUp);
     },
 
-    applyTorqueImpulse(torqueVector) {
-      ref.current().applyTorqueImpulse(torqueVector, true);
+    applyTorqueImpulse(torqueVector, wakeUp = true) {
+      ref.current().applyTorqueImpulse(torqueVector, wakeUp);
     },
 
-    applyImpulseAtPoint: (impulseVector, impulsePoint) => ref.current().applyImpulseAtPoint(impulseVector, impulsePoint, true),
-    addForce: force => ref.current().addForce(force, true),
-    addForceAtPoint: (force, point) => ref.current().addForceAtPoint(force, point, true),
-    addTorque: torque => ref.current().addTorque(torque, true),
+    applyImpulseAtPoint: (impulseVector, impulsePoint, wakeUp = true) => ref.current().applyImpulseAtPoint(impulseVector, impulsePoint, wakeUp),
+    addForce: (force, wakeUp = true) => ref.current().addForce(force, wakeUp),
+    addForceAtPoint: (force, point, wakeUp = true) => ref.current().addForceAtPoint(force, point, wakeUp),
+    addTorque: (torque, wakeUp = true) => ref.current().addTorque(torque, wakeUp),
 
     translation() {
       return rapierVector3ToVector3(ref.current().translation());
     },
 
-    setTranslation: translation => ref.current().setTranslation(translation, true),
+    setTranslation: (translation, wakeUp = true) => ref.current().setTranslation(translation, wakeUp),
 
     rotation() {
       const {
@@ -113,8 +113,8 @@ const createRigidBodyApi = ref => {
       return new three.Quaternion(x, y, z, w);
     },
 
-    setRotation: rotation => {
-      ref.current().setRotation(rotation, true);
+    setRotation: (rotation, wakeUp = true) => {
+      ref.current().setRotation(rotation, wakeUp);
     },
 
     linvel() {
@@ -126,7 +126,7 @@ const createRigidBodyApi = ref => {
       return new three.Vector3(x, y, z);
     },
 
-    setLinvel: velocity => ref.current().setLinvel(velocity, true),
+    setLinvel: (velocity, wakeUp = true) => ref.current().setLinvel(velocity, wakeUp),
 
     angvel() {
       const {
@@ -137,7 +137,7 @@ const createRigidBodyApi = ref => {
       return new three.Vector3(x, y, z);
     },
 
-    setAngvel: velocity => ref.current().setAngvel(velocity, true),
+    setAngvel: (velocity, wakeUp = true) => ref.current().setAngvel(velocity, wakeUp),
 
     linearDamping() {
       return ref.current().linearDamping();
@@ -154,12 +154,12 @@ const createRigidBodyApi = ref => {
       ref.current().setNextKinematicRotation(rotation);
     },
     setNextKinematicTranslation: translation => ref.current().setNextKinematicTranslation(translation),
-    resetForces: () => ref.current().resetForces(true),
-    resetTorques: () => ref.current().resetTorques(true),
-    lockRotations: locked => ref.current().lockRotations(locked, true),
-    lockTranslations: locked => ref.current().lockTranslations(locked, true),
-    setEnabledRotations: (x, y, z) => ref.current().setEnabledRotations(x, y, z, true),
-    setEnabledTranslations: (x, y, z) => ref.current().setEnabledTranslations(x, y, z, true)
+    resetForces: (wakeUp = true) => ref.current().resetForces(wakeUp),
+    resetTorques: (wakeUp = true) => ref.current().resetTorques(wakeUp),
+    lockRotations: (locked, wakeUp = true) => ref.current().lockRotations(locked, wakeUp),
+    lockTranslations: (locked, wakeUp = true) => ref.current().lockTranslations(locked, wakeUp),
+    setEnabledRotations: (x, y, z, wakeUp = true) => ref.current().setEnabledRotations(x, y, z, wakeUp),
+    setEnabledTranslations: (x, y, z, wakeUp = true) => ref.current().setEnabledTranslations(x, y, z, wakeUp)
   };
 };
 const createInstancedRigidBodiesApi = bodiesGetter => ({
@@ -182,9 +182,9 @@ const createWorldApi = ref => {
     createRigidBody: desc => ref.current().createRigidBody(desc),
     createCollider: (desc, rigidBody) => ref.current().createCollider(desc, rigidBody),
     removeRigidBody: rigidBody => ref.current().removeRigidBody(rigidBody),
-    removeCollider: collider => ref.current().removeCollider(collider, true),
-    createImpulseJoint: (params, rigidBodyA, rigidBodyB) => ref.current().createImpulseJoint(params, rigidBodyA, rigidBodyB, true),
-    removeImpulseJoint: joint => ref.current().removeImpulseJoint(joint, true),
+    removeCollider: (collider, wakeUp = true) => ref.current().removeCollider(collider, wakeUp),
+    createImpulseJoint: (params, rigidBodyA, rigidBodyB, wakeUp = true) => ref.current().createImpulseJoint(params, rigidBodyA, rigidBodyB, wakeUp),
+    removeImpulseJoint: (joint, wakeUp = true) => ref.current().removeImpulseJoint(joint, wakeUp),
     forEachCollider: callback => ref.current().forEachCollider(callback),
     setGravity: ({
       x,
@@ -746,6 +746,32 @@ const createColliderFromOptions = (options, world, scale, rigidBody) => {
   const desc = rapier3dCompat.ColliderDesc[options.shape](...scaledArgs);
   return world.createCollider(desc, rigidBody);
 };
+const massPropertiesConflictError = "Please pick ONLY ONE of the `density`, `mass` and `massProperties` options.";
+
+const setColliderMassOptions = (collider, options) => {
+  if (options.density !== undefined) {
+    if (options.mass !== undefined || options.massProperties !== undefined) {
+      throw new Error(massPropertiesConflictError);
+    }
+
+    collider.setDensity(options.density);
+    return;
+  }
+
+  if (options.mass !== undefined) {
+    if (options.massProperties !== undefined) {
+      throw new Error(massPropertiesConflictError);
+    }
+
+    collider.setMass(options.mass);
+    return;
+  }
+
+  if (options.massProperties !== undefined) {
+    collider.setMassProperties(options.massProperties.mass, options.massProperties.centerOfMass, options.massProperties.principalAngularInertia, options.massProperties.angularInertiaLocalFrame);
+  }
+};
+
 const mutableColliderOptions = {
   sensor: (collider, value) => {
     collider.setSensor(value);
@@ -759,14 +785,14 @@ const mutableColliderOptions = {
   friction: (collider, value) => {
     collider.setFriction(value);
   },
+  frictionCombineRule: (collider, value) => {
+    collider.setFrictionCombineRule(value);
+  },
   restitution: (collider, value) => {
     collider.setRestitution(value);
   },
-  density: (collider, value) => {
-    collider.setDensity(value);
-  },
-  mass: (collider, value) => {
-    collider.setMass(value);
+  restitutionCombineRule: (collider, value) => {
+    collider.setRestitutionCombineRule(value);
   }
 };
 const mutableColliderOptionKeys = Object.keys(mutableColliderOptions);
@@ -798,9 +824,14 @@ const setColliderOptions = (collider, options, states) => {
 
     mutableColliderOptionKeys.forEach(key => {
       if (key in options) {
-        mutableColliderOptions[key](collider, options[key]);
+        const option = options[key];
+        mutableColliderOptions[key](collider, // @ts-ignore Option does not want to fit into the function, but it will
+        option, options);
       }
-    });
+    }); // handle mass separately, because the assignments
+    // are exclusive.
+
+    setColliderMassOptions(collider, options);
   }
 };
 const useUpdateColliderOptions = (collidersRef, props, states) => {
@@ -1109,7 +1140,7 @@ const usePrismaticJoint = (body1, body2, [body1Anchor, body2Anchor, axis]) => {
 };
 
 // Colliders
-const AnyCollider = /*#__PURE__*/React.memo(props => {
+const AnyCollider = /*#__PURE__*/React.memo( /*#__PURE__*/React__default["default"].forwardRef((props, forwardedRef) => {
   const {
     children,
     position,
@@ -1124,7 +1155,15 @@ const AnyCollider = /*#__PURE__*/React.memo(props => {
   } = useRapier();
   const rigidBodyContext = useRigidBodyContext();
   const ref = React.useRef(null);
-  const collidersRef = React.useRef([]);
+  const collidersRef = React.useMemo(() => {
+    if (forwardedRef !== null) {
+      return forwardedRef;
+    }
+
+    const result = /*#__PURE__*/React__default["default"].createRef();
+    result.current = [];
+    return result;
+  }, []);
   React.useEffect(() => {
     const object = ref.current;
     const worldScale = object.getWorldScale(new three.Vector3());
@@ -1169,52 +1208,61 @@ const AnyCollider = /*#__PURE__*/React.memo(props => {
     scale: scale,
     ref: ref
   }, children);
-});
-const CuboidCollider = props => {
+}));
+const CuboidCollider = /*#__PURE__*/React__default["default"].forwardRef((props, ref) => {
   return /*#__PURE__*/React__default["default"].createElement(AnyCollider, _extends({}, props, {
-    shape: "cuboid"
+    shape: "cuboid",
+    ref: ref
   }));
-};
-const RoundCuboidCollider = props => {
+});
+const RoundCuboidCollider = /*#__PURE__*/React__default["default"].forwardRef((props, ref) => {
   return /*#__PURE__*/React__default["default"].createElement(AnyCollider, _extends({}, props, {
-    shape: "roundCuboid"
+    shape: "roundCuboid",
+    ref: ref
   }));
-};
-const BallCollider = props => {
+});
+const BallCollider = /*#__PURE__*/React__default["default"].forwardRef((props, ref) => {
   return /*#__PURE__*/React__default["default"].createElement(AnyCollider, _extends({}, props, {
-    shape: "ball"
+    shape: "ball",
+    ref: ref
   }));
-};
-const CapsuleCollider = props => {
+});
+const CapsuleCollider = /*#__PURE__*/React__default["default"].forwardRef((props, ref) => {
   return /*#__PURE__*/React__default["default"].createElement(AnyCollider, _extends({}, props, {
-    shape: "capsule"
+    shape: "capsule",
+    ref: ref
   }));
-};
-const HeightfieldCollider = props => {
+});
+const HeightfieldCollider = /*#__PURE__*/React__default["default"].forwardRef((props, ref) => {
   return /*#__PURE__*/React__default["default"].createElement(AnyCollider, _extends({}, props, {
-    shape: "heightfield"
+    shape: "heightfield",
+    ref: ref
   }));
-};
-const TrimeshCollider = props => {
+});
+const TrimeshCollider = /*#__PURE__*/React__default["default"].forwardRef((props, ref) => {
   return /*#__PURE__*/React__default["default"].createElement(AnyCollider, _extends({}, props, {
-    shape: "trimesh"
+    shape: "trimesh",
+    ref: ref
   }));
-};
-const ConeCollider = props => {
+});
+const ConeCollider = /*#__PURE__*/React__default["default"].forwardRef((props, ref) => {
   return /*#__PURE__*/React__default["default"].createElement(AnyCollider, _extends({}, props, {
-    shape: "cone"
+    shape: "cone",
+    ref: ref
   }));
-};
-const CylinderCollider = props => {
+});
+const CylinderCollider = /*#__PURE__*/React__default["default"].forwardRef((props, ref) => {
   return /*#__PURE__*/React__default["default"].createElement(AnyCollider, _extends({}, props, {
-    shape: "cylinder"
+    shape: "cylinder",
+    ref: ref
   }));
-};
-const ConvexHullCollider = props => {
+});
+const ConvexHullCollider = /*#__PURE__*/React__default["default"].forwardRef((props, ref) => {
   return /*#__PURE__*/React__default["default"].createElement(AnyCollider, _extends({}, props, {
-    shape: "convexHull"
+    shape: "convexHull",
+    ref: ref
   }));
-};
+});
 
 const _excluded$1 = ["children", "type", "position", "rotation", "scale", "quaternion"];
 const RigidBodyContext = /*#__PURE__*/React.createContext(undefined);
@@ -1290,7 +1338,7 @@ const geometryFromCollider = collider => {
           y,
           z
         } = collider.shape.halfExtents;
-        return new three.BoxBufferGeometry(x * 2 + 0.01, y * 2 + 0.01, z * 2 + 0.01);
+        return new three.BoxGeometry(x * 2 + 0.01, y * 2 + 0.01, z * 2 + 0.01);
       }
 
     case rapier3dCompat.ShapeType.RoundCuboid:
@@ -1307,7 +1355,7 @@ const geometryFromCollider = collider => {
     case rapier3dCompat.ShapeType.Ball:
       {
         const r = collider.shape.radius;
-        return new three.SphereBufferGeometry(r + +0.01, 8, 8);
+        return new three.SphereGeometry(r + +0.01, 8, 8);
       }
 
     case rapier3dCompat.ShapeType.TriMesh:
@@ -1339,7 +1387,7 @@ const geometryFromCollider = collider => {
       {
         const r = collider.shape.radius;
         const h = collider.shape.halfHeight;
-        const g = new three.CylinderBufferGeometry(r, r, h * 2);
+        const g = new three.CylinderGeometry(r, r, h * 2);
         return g;
       }
 
@@ -1347,7 +1395,7 @@ const geometryFromCollider = collider => {
       {
         const r = collider.shape.radius;
         const h = collider.shape.halfHeight;
-        const g = new three.CapsuleBufferGeometry(r, h * 2, 4, 8);
+        const g = new three.CapsuleGeometry(r, h * 2, 4, 8);
         return g;
       }
 
@@ -1355,7 +1403,7 @@ const geometryFromCollider = collider => {
       {
         const r = collider.shape.radius;
         const h = collider.shape.halfHeight;
-        const g = new three.ConeBufferGeometry(r, h * 2, 16);
+        const g = new three.ConeGeometry(r, h * 2, 16);
         return g;
       }
 
@@ -1375,7 +1423,7 @@ const geometryFromCollider = collider => {
       }
   }
 
-  return new three.BoxBufferGeometry(1, 1, 1);
+  return new three.BoxGeometry(1, 1, 1);
 };
 
 const DebugShape = /*#__PURE__*/React.memo(({

package/dist/react-three-rapier.cjs.prod.js

@@ -84,24 +84,24 @@ const createRigidBodyApi = ref => {
 
     mass: () => ref.current().mass(),
 
-    applyImpulse(impulseVector) {
-      ref.current().applyImpulse(impulseVector, true);
+    applyImpulse(impulseVector, wakeUp = true) {
+      ref.current().applyImpulse(impulseVector, wakeUp);
     },
 
-    applyTorqueImpulse(torqueVector) {
-      ref.current().applyTorqueImpulse(torqueVector, true);
+    applyTorqueImpulse(torqueVector, wakeUp = true) {
+      ref.current().applyTorqueImpulse(torqueVector, wakeUp);
     },
 
-    applyImpulseAtPoint: (impulseVector, impulsePoint) => ref.current().applyImpulseAtPoint(impulseVector, impulsePoint, true),
-    addForce: force => ref.current().addForce(force, true),
-    addForceAtPoint: (force, point) => ref.current().addForceAtPoint(force, point, true),
-    addTorque: torque => ref.current().addTorque(torque, true),
+    applyImpulseAtPoint: (impulseVector, impulsePoint, wakeUp = true) => ref.current().applyImpulseAtPoint(impulseVector, impulsePoint, wakeUp),
+    addForce: (force, wakeUp = true) => ref.current().addForce(force, wakeUp),
+    addForceAtPoint: (force, point, wakeUp = true) => ref.current().addForceAtPoint(force, point, wakeUp),
+    addTorque: (torque, wakeUp = true) => ref.current().addTorque(torque, wakeUp),
 
     translation() {
       return rapierVector3ToVector3(ref.current().translation());
     },
 
-    setTranslation: translation => ref.current().setTranslation(translation, true),
+    setTranslation: (translation, wakeUp = true) => ref.current().setTranslation(translation, wakeUp),
 
     rotation() {
       const {
@@ -113,8 +113,8 @@ const createRigidBodyApi = ref => {
       return new three.Quaternion(x, y, z, w);
     },
 
-    setRotation: rotation => {
-      ref.current().setRotation(rotation, true);
+    setRotation: (rotation, wakeUp = true) => {
+      ref.current().setRotation(rotation, wakeUp);
     },
 
     linvel() {
@@ -126,7 +126,7 @@ const createRigidBodyApi = ref => {
       return new three.Vector3(x, y, z);
     },
 
-    setLinvel: velocity => ref.current().setLinvel(velocity, true),
+    setLinvel: (velocity, wakeUp = true) => ref.current().setLinvel(velocity, wakeUp),
 
     angvel() {
       const {
@@ -137,7 +137,7 @@ const createRigidBodyApi = ref => {
       return new three.Vector3(x, y, z);
     },
 
-    setAngvel: velocity => ref.current().setAngvel(velocity, true),
+    setAngvel: (velocity, wakeUp = true) => ref.current().setAngvel(velocity, wakeUp),
 
     linearDamping() {
       return ref.current().linearDamping();
@@ -154,12 +154,12 @@ const createRigidBodyApi = ref => {
       ref.current().setNextKinematicRotation(rotation);
     },
     setNextKinematicTranslation: translation => ref.current().setNextKinematicTranslation(translation),
-    resetForces: () => ref.current().resetForces(true),
-    resetTorques: () => ref.current().resetTorques(true),
-    lockRotations: locked => ref.current().lockRotations(locked, true),
-    lockTranslations: locked => ref.current().lockTranslations(locked, true),
-    setEnabledRotations: (x, y, z) => ref.current().setEnabledRotations(x, y, z, true),
-    setEnabledTranslations: (x, y, z) => ref.current().setEnabledTranslations(x, y, z, true)
+    resetForces: (wakeUp = true) => ref.current().resetForces(wakeUp),
+    resetTorques: (wakeUp = true) => ref.current().resetTorques(wakeUp),
+    lockRotations: (locked, wakeUp = true) => ref.current().lockRotations(locked, wakeUp),
+    lockTranslations: (locked, wakeUp = true) => ref.current().lockTranslations(locked, wakeUp),
+    setEnabledRotations: (x, y, z, wakeUp = true) => ref.current().setEnabledRotations(x, y, z, wakeUp),
+    setEnabledTranslations: (x, y, z, wakeUp = true) => ref.current().setEnabledTranslations(x, y, z, wakeUp)
   };
 };
 const createInstancedRigidBodiesApi = bodiesGetter => ({
@@ -182,9 +182,9 @@ const createWorldApi = ref => {
     createRigidBody: desc => ref.current().createRigidBody(desc),
     createCollider: (desc, rigidBody) => ref.current().createCollider(desc, rigidBody),
     removeRigidBody: rigidBody => ref.current().removeRigidBody(rigidBody),
-    removeCollider: collider => ref.current().removeCollider(collider, true),
-    createImpulseJoint: (params, rigidBodyA, rigidBodyB) => ref.current().createImpulseJoint(params, rigidBodyA, rigidBodyB, true),
-    removeImpulseJoint: joint => ref.current().removeImpulseJoint(joint, true),
+    removeCollider: (collider, wakeUp = true) => ref.current().removeCollider(collider, wakeUp),
+    createImpulseJoint: (params, rigidBodyA, rigidBodyB, wakeUp = true) => ref.current().createImpulseJoint(params, rigidBodyA, rigidBodyB, wakeUp),
+    removeImpulseJoint: (joint, wakeUp = true) => ref.current().removeImpulseJoint(joint, wakeUp),
     forEachCollider: callback => ref.current().forEachCollider(callback),
     setGravity: ({
       x,
@@ -746,6 +746,32 @@ const createColliderFromOptions = (options, world, scale, rigidBody) => {
   const desc = rapier3dCompat.ColliderDesc[options.shape](...scaledArgs);
   return world.createCollider(desc, rigidBody);
 };
+const massPropertiesConflictError = "Please pick ONLY ONE of the `density`, `mass` and `massProperties` options.";
+
+const setColliderMassOptions = (collider, options) => {
+  if (options.density !== undefined) {
+    if (options.mass !== undefined || options.massProperties !== undefined) {
+      throw new Error(massPropertiesConflictError);
+    }
+
+    collider.setDensity(options.density);
+    return;
+  }
+
+  if (options.mass !== undefined) {
+    if (options.massProperties !== undefined) {
+      throw new Error(massPropertiesConflictError);
+    }
+
+    collider.setMass(options.mass);
+    return;
+  }
+
+  if (options.massProperties !== undefined) {
+    collider.setMassProperties(options.massProperties.mass, options.massProperties.centerOfMass, options.massProperties.principalAngularInertia, options.massProperties.angularInertiaLocalFrame);
+  }
+};
+
 const mutableColliderOptions = {
   sensor: (collider, value) => {
     collider.setSensor(value);
@@ -759,14 +785,14 @@ const mutableColliderOptions = {
   friction: (collider, value) => {
     collider.setFriction(value);
   },
+  frictionCombineRule: (collider, value) => {
+    collider.setFrictionCombineRule(value);
+  },
   restitution: (collider, value) => {
     collider.setRestitution(value);
   },
-  density: (collider, value) => {
-    collider.setDensity(value);
-  },
-  mass: (collider, value) => {
-    collider.setMass(value);
+  restitutionCombineRule: (collider, value) => {
+    collider.setRestitutionCombineRule(value);
   }
 };
 const mutableColliderOptionKeys = Object.keys(mutableColliderOptions);
@@ -798,9 +824,14 @@ const setColliderOptions = (collider, options, states) => {
 
     mutableColliderOptionKeys.forEach(key => {
       if (key in options) {
-        mutableColliderOptions[key](collider, options[key]);
+        const option = options[key];
+        mutableColliderOptions[key](collider, // @ts-ignore Option does not want to fit into the function, but it will
+        option, options);
       }
-    });
+    }); // handle mass separately, because the assignments
+    // are exclusive.
+
+    setColliderMassOptions(collider, options);
   }
 };
 const useUpdateColliderOptions = (collidersRef, props, states) => {
@@ -1109,7 +1140,7 @@ const usePrismaticJoint = (body1, body2, [body1Anchor, body2Anchor, axis]) => {
 };
 
 // Colliders
-const AnyCollider = /*#__PURE__*/React.memo(props => {
+const AnyCollider = /*#__PURE__*/React.memo( /*#__PURE__*/React__default["default"].forwardRef((props, forwardedRef) => {
   const {
     children,
     position,
@@ -1124,7 +1155,15 @@ const AnyCollider = /*#__PURE__*/React.memo(props => {
   } = useRapier();
   const rigidBodyContext = useRigidBodyContext();
   const ref = React.useRef(null);
-  const collidersRef = React.useRef([]);
+  const collidersRef = React.useMemo(() => {
+    if (forwardedRef !== null) {
+      return forwardedRef;
+    }
+
+    const result = /*#__PURE__*/React__default["default"].createRef();
+    result.current = [];
+    return result;
+  }, []);
   React.useEffect(() => {
     const object = ref.current;
     const worldScale = object.getWorldScale(new three.Vector3());
@@ -1169,52 +1208,61 @@ const AnyCollider = /*#__PURE__*/React.memo(props => {
     scale: scale,
     ref: ref
   }, children);
-});
-const CuboidCollider = props => {
+}));
+const CuboidCollider = /*#__PURE__*/React__default["default"].forwardRef((props, ref) => {
   return /*#__PURE__*/React__default["default"].createElement(AnyCollider, _extends({}, props, {
-    shape: "cuboid"
+    shape: "cuboid",
+    ref: ref
   }));
-};
-const RoundCuboidCollider = props => {
+});
+const RoundCuboidCollider = /*#__PURE__*/React__default["default"].forwardRef((props, ref) => {
   return /*#__PURE__*/React__default["default"].createElement(AnyCollider, _extends({}, props, {
-    shape: "roundCuboid"
+    shape: "roundCuboid",
+    ref: ref
   }));
-};
-const BallCollider = props => {
+});
+const BallCollider = /*#__PURE__*/React__default["default"].forwardRef((props, ref) => {
   return /*#__PURE__*/React__default["default"].createElement(AnyCollider, _extends({}, props, {
-    shape: "ball"
+    shape: "ball",
+    ref: ref
   }));
-};
-const CapsuleCollider = props => {
+});
+const CapsuleCollider = /*#__PURE__*/React__default["default"].forwardRef((props, ref) => {
   return /*#__PURE__*/React__default["default"].createElement(AnyCollider, _extends({}, props, {
-    shape: "capsule"
+    shape: "capsule",
+    ref: ref
   }));
-};
-const HeightfieldCollider = props => {
+});
+const HeightfieldCollider = /*#__PURE__*/React__default["default"].forwardRef((props, ref) => {
   return /*#__PURE__*/React__default["default"].createElement(AnyCollider, _extends({}, props, {
-    shape: "heightfield"
+    shape: "heightfield",
+    ref: ref
   }));
-};
-const TrimeshCollider = props => {
+});
+const TrimeshCollider = /*#__PURE__*/React__default["default"].forwardRef((props, ref) => {
   return /*#__PURE__*/React__default["default"].createElement(AnyCollider, _extends({}, props, {
-    shape: "trimesh"
+    shape: "trimesh",
+    ref: ref
   }));
-};
-const ConeCollider = props => {
+});
+const ConeCollider = /*#__PURE__*/React__default["default"].forwardRef((props, ref) => {
   return /*#__PURE__*/React__default["default"].createElement(AnyCollider, _extends({}, props, {
-    shape: "cone"
+    shape: "cone",
+    ref: ref
   }));
-};
-const CylinderCollider = props => {
+});
+const CylinderCollider = /*#__PURE__*/React__default["default"].forwardRef((props, ref) => {
   return /*#__PURE__*/React__default["default"].createElement(AnyCollider, _extends({}, props, {
-    shape: "cylinder"
+    shape: "cylinder",
+    ref: ref
   }));
-};
-const ConvexHullCollider = props => {
+});
+const ConvexHullCollider = /*#__PURE__*/React__default["default"].forwardRef((props, ref) => {
   return /*#__PURE__*/React__default["default"].createElement(AnyCollider, _extends({}, props, {
-    shape: "convexHull"
+    shape: "convexHull",
+    ref: ref
   }));
-};
+});
 
 const _excluded$1 = ["children", "type", "position", "rotation", "scale", "quaternion"];
 const RigidBodyContext = /*#__PURE__*/React.createContext(undefined);
@@ -1290,7 +1338,7 @@ const geometryFromCollider = collider => {
           y,
           z
         } = collider.shape.halfExtents;
-        return new three.BoxBufferGeometry(x * 2 + 0.01, y * 2 + 0.01, z * 2 + 0.01);
+        return new three.BoxGeometry(x * 2 + 0.01, y * 2 + 0.01, z * 2 + 0.01);
       }
 
     case rapier3dCompat.ShapeType.RoundCuboid:
@@ -1307,7 +1355,7 @@ const geometryFromCollider = collider => {
     case rapier3dCompat.ShapeType.Ball:
       {
         const r = collider.shape.radius;
-        return new three.SphereBufferGeometry(r + +0.01, 8, 8);
+        return new three.SphereGeometry(r + +0.01, 8, 8);
       }
 
     case rapier3dCompat.ShapeType.TriMesh:
@@ -1339,7 +1387,7 @@ const geometryFromCollider = collider => {
       {
         const r = collider.shape.radius;
         const h = collider.shape.halfHeight;
-        const g = new three.CylinderBufferGeometry(r, r, h * 2);
+        const g = new three.CylinderGeometry(r, r, h * 2);
         return g;
       }
 
@@ -1347,7 +1395,7 @@ const geometryFromCollider = collider => {
       {
         const r = collider.shape.radius;
         const h = collider.shape.halfHeight;
-        const g = new three.CapsuleBufferGeometry(r, h * 2, 4, 8);
+        const g = new three.CapsuleGeometry(r, h * 2, 4, 8);
         return g;
       }
 
@@ -1355,7 +1403,7 @@ const geometryFromCollider = collider => {
       {
         const r = collider.shape.radius;
         const h = collider.shape.halfHeight;
-        const g = new three.ConeBufferGeometry(r, h * 2, 16);
+        const g = new three.ConeGeometry(r, h * 2, 16);
         return g;
       }
 
@@ -1375,7 +1423,7 @@ const geometryFromCollider = collider => {
       }
   }
 
-  return new three.BoxBufferGeometry(1, 1, 1);
+  return new three.BoxGeometry(1, 1, 1);
 };
 
 const DebugShape = /*#__PURE__*/React.memo(({

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

@@ -3,7 +3,7 @@ export { CoefficientCombineRule, Collider as RapierCollider, RigidBody as Rapier
 import React, { useState, useEffect, useRef, useMemo, createContext, useContext, memo, forwardRef, useImperativeHandle, useLayoutEffect } from 'react';
 import { useAsset } from 'use-asset';
 import { useFrame } from '@react-three/fiber';
-import { Quaternion, Euler, Vector3, Object3D, Matrix4, MathUtils, InstancedMesh, MeshBasicMaterial, Color, PlaneGeometry, ConeBufferGeometry, CapsuleBufferGeometry, CylinderBufferGeometry, BufferGeometry, BufferAttribute, SphereBufferGeometry, BoxBufferGeometry, DynamicDrawUsage } from 'three';
+import { Quaternion, Euler, Vector3, Object3D, Matrix4, MathUtils, InstancedMesh, MeshBasicMaterial, Color, PlaneGeometry, ConeGeometry, CapsuleGeometry, CylinderGeometry, BufferGeometry, BufferAttribute, SphereGeometry, BoxGeometry, DynamicDrawUsage } from 'three';
 import { mergeVertices, RoundedBoxGeometry } from 'three-stdlib';
 
 const _quaternion = new Quaternion();
@@ -59,24 +59,24 @@ const createRigidBodyApi = ref => {
 
     mass: () => ref.current().mass(),
 
-    applyImpulse(impulseVector) {
-      ref.current().applyImpulse(impulseVector, true);
+    applyImpulse(impulseVector, wakeUp = true) {
+      ref.current().applyImpulse(impulseVector, wakeUp);
     },
 
-    applyTorqueImpulse(torqueVector) {
-      ref.current().applyTorqueImpulse(torqueVector, true);
+    applyTorqueImpulse(torqueVector, wakeUp = true) {
+      ref.current().applyTorqueImpulse(torqueVector, wakeUp);
     },
 
-    applyImpulseAtPoint: (impulseVector, impulsePoint) => ref.current().applyImpulseAtPoint(impulseVector, impulsePoint, true),
-    addForce: force => ref.current().addForce(force, true),
-    addForceAtPoint: (force, point) => ref.current().addForceAtPoint(force, point, true),
-    addTorque: torque => ref.current().addTorque(torque, true),
+    applyImpulseAtPoint: (impulseVector, impulsePoint, wakeUp = true) => ref.current().applyImpulseAtPoint(impulseVector, impulsePoint, wakeUp),
+    addForce: (force, wakeUp = true) => ref.current().addForce(force, wakeUp),
+    addForceAtPoint: (force, point, wakeUp = true) => ref.current().addForceAtPoint(force, point, wakeUp),
+    addTorque: (torque, wakeUp = true) => ref.current().addTorque(torque, wakeUp),
 
     translation() {
       return rapierVector3ToVector3(ref.current().translation());
     },
 
-    setTranslation: translation => ref.current().setTranslation(translation, true),
+    setTranslation: (translation, wakeUp = true) => ref.current().setTranslation(translation, wakeUp),
 
     rotation() {
       const {
@@ -88,8 +88,8 @@ const createRigidBodyApi = ref => {
       return new Quaternion(x, y, z, w);
     },
 
-    setRotation: rotation => {
-      ref.current().setRotation(rotation, true);
+    setRotation: (rotation, wakeUp = true) => {
+      ref.current().setRotation(rotation, wakeUp);
     },
 
     linvel() {
@@ -101,7 +101,7 @@ const createRigidBodyApi = ref => {
       return new Vector3(x, y, z);
     },
 
-    setLinvel: velocity => ref.current().setLinvel(velocity, true),
+    setLinvel: (velocity, wakeUp = true) => ref.current().setLinvel(velocity, wakeUp),
 
     angvel() {
       const {
@@ -112,7 +112,7 @@ const createRigidBodyApi = ref => {
       return new Vector3(x, y, z);
     },
 
-    setAngvel: velocity => ref.current().setAngvel(velocity, true),
+    setAngvel: (velocity, wakeUp = true) => ref.current().setAngvel(velocity, wakeUp),
 
     linearDamping() {
       return ref.current().linearDamping();
@@ -129,12 +129,12 @@ const createRigidBodyApi = ref => {
       ref.current().setNextKinematicRotation(rotation);
     },
     setNextKinematicTranslation: translation => ref.current().setNextKinematicTranslation(translation),
-    resetForces: () => ref.current().resetForces(true),
-    resetTorques: () => ref.current().resetTorques(true),
-    lockRotations: locked => ref.current().lockRotations(locked, true),
-    lockTranslations: locked => ref.current().lockTranslations(locked, true),
-    setEnabledRotations: (x, y, z) => ref.current().setEnabledRotations(x, y, z, true),
-    setEnabledTranslations: (x, y, z) => ref.current().setEnabledTranslations(x, y, z, true)
+    resetForces: (wakeUp = true) => ref.current().resetForces(wakeUp),
+    resetTorques: (wakeUp = true) => ref.current().resetTorques(wakeUp),
+    lockRotations: (locked, wakeUp = true) => ref.current().lockRotations(locked, wakeUp),
+    lockTranslations: (locked, wakeUp = true) => ref.current().lockTranslations(locked, wakeUp),
+    setEnabledRotations: (x, y, z, wakeUp = true) => ref.current().setEnabledRotations(x, y, z, wakeUp),
+    setEnabledTranslations: (x, y, z, wakeUp = true) => ref.current().setEnabledTranslations(x, y, z, wakeUp)
   };
 };
 const createInstancedRigidBodiesApi = bodiesGetter => ({
@@ -157,9 +157,9 @@ const createWorldApi = ref => {
     createRigidBody: desc => ref.current().createRigidBody(desc),
     createCollider: (desc, rigidBody) => ref.current().createCollider(desc, rigidBody),
     removeRigidBody: rigidBody => ref.current().removeRigidBody(rigidBody),
-    removeCollider: collider => ref.current().removeCollider(collider, true),
-    createImpulseJoint: (params, rigidBodyA, rigidBodyB) => ref.current().createImpulseJoint(params, rigidBodyA, rigidBodyB, true),
-    removeImpulseJoint: joint => ref.current().removeImpulseJoint(joint, true),
+    removeCollider: (collider, wakeUp = true) => ref.current().removeCollider(collider, wakeUp),
+    createImpulseJoint: (params, rigidBodyA, rigidBodyB, wakeUp = true) => ref.current().createImpulseJoint(params, rigidBodyA, rigidBodyB, wakeUp),
+    removeImpulseJoint: (joint, wakeUp = true) => ref.current().removeImpulseJoint(joint, wakeUp),
     forEachCollider: callback => ref.current().forEachCollider(callback),
     setGravity: ({
       x,
@@ -721,6 +721,32 @@ const createColliderFromOptions = (options, world, scale, rigidBody) => {
   const desc = ColliderDesc[options.shape](...scaledArgs);
   return world.createCollider(desc, rigidBody);
 };
+const massPropertiesConflictError = "Please pick ONLY ONE of the `density`, `mass` and `massProperties` options.";
+
+const setColliderMassOptions = (collider, options) => {
+  if (options.density !== undefined) {
+    if (options.mass !== undefined || options.massProperties !== undefined) {
+      throw new Error(massPropertiesConflictError);
+    }
+
+    collider.setDensity(options.density);
+    return;
+  }
+
+  if (options.mass !== undefined) {
+    if (options.massProperties !== undefined) {
+      throw new Error(massPropertiesConflictError);
+    }
+
+    collider.setMass(options.mass);
+    return;
+  }
+
+  if (options.massProperties !== undefined) {
+    collider.setMassProperties(options.massProperties.mass, options.massProperties.centerOfMass, options.massProperties.principalAngularInertia, options.massProperties.angularInertiaLocalFrame);
+  }
+};
+
 const mutableColliderOptions = {
   sensor: (collider, value) => {
     collider.setSensor(value);
@@ -734,14 +760,14 @@ const mutableColliderOptions = {
   friction: (collider, value) => {
     collider.setFriction(value);
   },
+  frictionCombineRule: (collider, value) => {
+    collider.setFrictionCombineRule(value);
+  },
   restitution: (collider, value) => {
     collider.setRestitution(value);
   },
-  density: (collider, value) => {
-    collider.setDensity(value);
-  },
-  mass: (collider, value) => {
-    collider.setMass(value);
+  restitutionCombineRule: (collider, value) => {
+    collider.setRestitutionCombineRule(value);
   }
 };
 const mutableColliderOptionKeys = Object.keys(mutableColliderOptions);
@@ -773,9 +799,14 @@ const setColliderOptions = (collider, options, states) => {
 
     mutableColliderOptionKeys.forEach(key => {
       if (key in options) {
-        mutableColliderOptions[key](collider, options[key]);
+        const option = options[key];
+        mutableColliderOptions[key](collider, // @ts-ignore Option does not want to fit into the function, but it will
+        option, options);
       }
-    });
+    }); // handle mass separately, because the assignments
+    // are exclusive.
+
+    setColliderMassOptions(collider, options);
   }
 };
 const useUpdateColliderOptions = (collidersRef, props, states) => {
@@ -1084,7 +1115,7 @@ const usePrismaticJoint = (body1, body2, [body1Anchor, body2Anchor, axis]) => {
 };
 
 // Colliders
-const AnyCollider = /*#__PURE__*/memo(props => {
+const AnyCollider = /*#__PURE__*/memo( /*#__PURE__*/React.forwardRef((props, forwardedRef) => {
   const {
     children,
     position,
@@ -1099,7 +1130,15 @@ const AnyCollider = /*#__PURE__*/memo(props => {
   } = useRapier();
   const rigidBodyContext = useRigidBodyContext();
   const ref = useRef(null);
-  const collidersRef = useRef([]);
+  const collidersRef = useMemo(() => {
+    if (forwardedRef !== null) {
+      return forwardedRef;
+    }
+
+    const result = /*#__PURE__*/React.createRef();
+    result.current = [];
+    return result;
+  }, []);
   useEffect(() => {
     const object = ref.current;
     const worldScale = object.getWorldScale(new Vector3());
@@ -1144,52 +1183,61 @@ const AnyCollider = /*#__PURE__*/memo(props => {
     scale: scale,
     ref: ref
   }, children);
-});
-const CuboidCollider = props => {
+}));
+const CuboidCollider = /*#__PURE__*/React.forwardRef((props, ref) => {
   return /*#__PURE__*/React.createElement(AnyCollider, _extends({}, props, {
-    shape: "cuboid"
+    shape: "cuboid",
+    ref: ref
   }));
-};
-const RoundCuboidCollider = props => {
+});
+const RoundCuboidCollider = /*#__PURE__*/React.forwardRef((props, ref) => {
   return /*#__PURE__*/React.createElement(AnyCollider, _extends({}, props, {
-    shape: "roundCuboid"
+    shape: "roundCuboid",
+    ref: ref
   }));
-};
-const BallCollider = props => {
+});
+const BallCollider = /*#__PURE__*/React.forwardRef((props, ref) => {
   return /*#__PURE__*/React.createElement(AnyCollider, _extends({}, props, {
-    shape: "ball"
+    shape: "ball",
+    ref: ref
   }));
-};
-const CapsuleCollider = props => {
+});
+const CapsuleCollider = /*#__PURE__*/React.forwardRef((props, ref) => {
   return /*#__PURE__*/React.createElement(AnyCollider, _extends({}, props, {
-    shape: "capsule"
+    shape: "capsule",
+    ref: ref
   }));
-};
-const HeightfieldCollider = props => {
+});
+const HeightfieldCollider = /*#__PURE__*/React.forwardRef((props, ref) => {
   return /*#__PURE__*/React.createElement(AnyCollider, _extends({}, props, {
-    shape: "heightfield"
+    shape: "heightfield",
+    ref: ref
   }));
-};
-const TrimeshCollider = props => {
+});
+const TrimeshCollider = /*#__PURE__*/React.forwardRef((props, ref) => {
   return /*#__PURE__*/React.createElement(AnyCollider, _extends({}, props, {
-    shape: "trimesh"
+    shape: "trimesh",
+    ref: ref
   }));
-};
-const ConeCollider = props => {
+});
+const ConeCollider = /*#__PURE__*/React.forwardRef((props, ref) => {
   return /*#__PURE__*/React.createElement(AnyCollider, _extends({}, props, {
-    shape: "cone"
+    shape: "cone",
+    ref: ref
   }));
-};
-const CylinderCollider = props => {
+});
+const CylinderCollider = /*#__PURE__*/React.forwardRef((props, ref) => {
   return /*#__PURE__*/React.createElement(AnyCollider, _extends({}, props, {
-    shape: "cylinder"
+    shape: "cylinder",
+    ref: ref
   }));
-};
-const ConvexHullCollider = props => {
+});
+const ConvexHullCollider = /*#__PURE__*/React.forwardRef((props, ref) => {
   return /*#__PURE__*/React.createElement(AnyCollider, _extends({}, props, {
-    shape: "convexHull"
+    shape: "convexHull",
+    ref: ref
   }));
-};
+});
 
 const _excluded$1 = ["children", "type", "position", "rotation", "scale", "quaternion"];
 const RigidBodyContext = /*#__PURE__*/createContext(undefined);
@@ -1265,7 +1313,7 @@ const geometryFromCollider = collider => {
           y,
           z
         } = collider.shape.halfExtents;
-        return new BoxBufferGeometry(x * 2 + 0.01, y * 2 + 0.01, z * 2 + 0.01);
+        return new BoxGeometry(x * 2 + 0.01, y * 2 + 0.01, z * 2 + 0.01);
       }
 
     case ShapeType.RoundCuboid:
@@ -1282,7 +1330,7 @@ const geometryFromCollider = collider => {
     case ShapeType.Ball:
       {
         const r = collider.shape.radius;
-        return new SphereBufferGeometry(r + +0.01, 8, 8);
+        return new SphereGeometry(r + +0.01, 8, 8);
       }
 
     case ShapeType.TriMesh:
@@ -1314,7 +1362,7 @@ const geometryFromCollider = collider => {
       {
         const r = collider.shape.radius;
         const h = collider.shape.halfHeight;
-        const g = new CylinderBufferGeometry(r, r, h * 2);
+        const g = new CylinderGeometry(r, r, h * 2);
         return g;
       }
 
@@ -1322,7 +1370,7 @@ const geometryFromCollider = collider => {
       {
         const r = collider.shape.radius;
         const h = collider.shape.halfHeight;
-        const g = new CapsuleBufferGeometry(r, h * 2, 4, 8);
+        const g = new CapsuleGeometry(r, h * 2, 4, 8);
         return g;
       }
 
@@ -1330,7 +1378,7 @@ const geometryFromCollider = collider => {
       {
         const r = collider.shape.radius;
         const h = collider.shape.halfHeight;
-        const g = new ConeBufferGeometry(r, h * 2, 16);
+        const g = new ConeGeometry(r, h * 2, 16);
         return g;
       }
 
@@ -1350,7 +1398,7 @@ const geometryFromCollider = collider => {
       }
   }
 
-  return new BoxBufferGeometry(1, 1, 1);
+  return new BoxGeometry(1, 1, 1);
 };
 
 const DebugShape = /*#__PURE__*/memo(({

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@react-three/rapier",
-  "version": "0.7.4",
+  "version": "0.7.5",
   "source": "src/index.ts",
   "main": "dist/react-three-rapier.cjs.js",
   "module": "dist/react-three-rapier.esm.js",
@@ -11,11 +11,16 @@
   "devDependencies": {
     "@react-three/drei": "^9.6.2",
     "@react-three/fiber": "^8.0.12",
+    "@react-three/test-renderer": "^8.0.17",
     "@types/react-dom": "^18.0.2",
     "@types/three": "^0.139.0",
+    "@vitejs/plugin-react": "^2.1.0",
+    "@vitest/ui": "^0.23.4",
+    "happy-dom": "^6.0.4",
     "react": "^18.1.0",
     "react-dom": "^18.1.0",
-    "three": "^0.139.2"
+    "three": "^0.139.2",
+    "vitest": "^0.23.4"
   },
   "peerDependencies": {
     "@react-three/fiber": "^8.0.12",
@@ -24,8 +29,8 @@
   },
   "dependencies": {
     "@dimforge/rapier3d-compat": "0.9.0",
-    "use-asset": "^1.0.4",
-    "three-stdlib": "^2.15.0"
+    "three-stdlib": "^2.15.0",
+    "use-asset": "^1.0.4"
   },
   "repository": "https://github.com/pmndrs/react-three-rapier/tree/master/packages/react-three-rapier"
 }

package/readme.md

@@ -9,6 +9,8 @@
 
 <p align="center">⚠️ Under heavy development. All APIs are subject to change. ⚠️</p>
 
+For contributions, please read the [contributing guide](https://github.com/pmndrs/react-three-rapier/blob/main/packages/react-three-rapier/CONTRIBUTING.md).
+
 ## Usage
 
 ```tsx
@@ -171,7 +173,7 @@ const Scene = () => {
       colliders="ball"
     >
       <instancedMesh args={[undefined, undefined, COUNT]}>
-        <sphereBufferGeometry args={[0.2]} />
+        <sphereGeometry args={[0.2]} />
         <meshPhysicalGeometry color="blue" />
 
         <CuboidCollider args={[0.1, 0.2, 0.1]} />