feat: able to change body sensor size and pos

Author: ErdongChen-Andrew

example/index.html

@@ -12,6 +12,7 @@
     <div id="root"></div>
     <img class="controlKeys" src="./keyControls.png" alt="control keys">
     <p class="title">
+        <a target="_blank" href="https://github.com/pmndrs/ecctrl">Ecctrl</a>
         Floating Character Controller Demo by
         <a target="_blank" href="https://github.com/ErdongChen-Andrew/CharacterControl">Andrew Chen</a>
         <br>

package-lock.json

@@ -1,6 +1,6 @@
 {
   "name": "ecctrl",
-  "version": "1.0.90",
+  "version": "1.0.91",
   "author": "Erdong Chen",
   "license": "MIT",
   "description": "A floating rigibody character controller for R3F",

package.json

@@ -164,14 +164,17 @@ EcctrlProps: {
   autoBalance: true, // Enable auto-balance
   autoBalanceSpringK: 0.3, // Auto-balance spring constant
   autoBalanceDampingC: 0.03, // Auto-balance damping coefficient
-  autoBalanceSpringOnY: 0.5, // Auto-balance spring on Y-axis 
-  autoBalanceDampingOnY: 0.015, // Auto-balance damping on Y-axis 
+  autoBalanceSpringOnY: 0.5, // Auto-balance spring on Y-axis
+  autoBalanceDampingOnY: 0.015, // Auto-balance damping on Y-axis
   // Animation temporary setups
   animated: false, // Enable animation
   // Mode setups
   mode: null, // Activate different ecctrl modes ("CameraBasedMovement" | "FixedCamera" | "PointToMove")
   // Customizable controller key setups
   controllerKeys: { forward: 12, backward: 13, leftward: 14, rightward: 15, jump: 2, action1: 11, action2: 3, action3: 1, action4: 0 },
+  // Point-to-move setups
+  bodySensorSize: [capsuleHalfHeight / 2, capsuleRadius], // cylinder body sensor [halfHeight, radius]
+  bodySensorPosition: { x: 0, y: 0, z: capsuleRadius / 2 },
   // Other rigibody props from parent
   // Rigidbody props can be used here,
   // such as position, friction, gravityScale, etc.
@@ -420,7 +423,7 @@ pressButton1();
 
 ### Ecctrl Mode
 
-Activate different modes in Ecctrl by including the desired mode inside Ecctrl component: 
+Activate different modes in Ecctrl by including the desired mode inside Ecctrl component:
 `<Ecctrl mode="PointToMove">`.
 
 #### 1. "PointToMove" Mode ([CodeSandbox Demo](https://codesandbox.io/p/sandbox/ecctrl-pointtomove-m9z6xh?file=%2Fsrc%2FMap.js%3A46%2C19))

readme.md

@@ -123,6 +123,9 @@ const Ecctrl: ForwardRefRenderFunction<RapierRigidBody, EcctrlProps> = ({
   mode = null,
   // Controller setups
   controllerKeys = { forward: 12, backward: 13, leftward: 14, rightward: 15, jump: 2, action1: 11, action2: 3, action3: 1, action4: 0 },
+  // Point-to-move setups
+  bodySensorSize = [capsuleHalfHeight / 2, capsuleRadius],
+  bodySensorPosition = { x: 0, y: 0, z: capsuleRadius / 2 },
   // Other rigibody props from parent
   ...props
 }: EcctrlProps, ref) => {
@@ -1478,8 +1481,9 @@ const Ecctrl: ForwardRefRenderFunction<RapierRigidBody, EcctrlProps> = ({
         <CylinderCollider
           ref={bodySensorRef}
           sensor
-          args={[capsuleHalfHeight / 2, capsuleRadius]}
-          position={[0, 0, capsuleRadius / 2]}
+          mass={0}
+          args={[bodySensorSize[0], bodySensorSize[1]]}
+          position={[bodySensorPosition.x, bodySensorPosition.y, bodySensorPosition.z]}
           onIntersectionEnter={handleOnIntersectionEnter}
           onIntersectionExit={handleOnIntersectionExit}
         />}
@@ -1589,6 +1593,9 @@ export interface EcctrlProps extends RigidBodyProps {
   mode?: string;
   // Controller setups
   controllerKeys?: { forward?: number, backward?: number, leftward?: number, rightward?: number, jump?: number, action1?: number, action2?: number, action3?: number, action4?: number }
+  // Point-to-move setups
+  bodySensorSize?: Array<number>;
+  bodySensorPosition?: { x: number, y: number, z: number }
   // Other rigibody props from parent
   props?: RigidBodyProps;
 };