feat: add followLightPos prop

Author: ErdongChen-Andrew

package.json

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

readme.md

@@ -122,12 +122,14 @@ EcctrlProps: {
   capsuleRadius: 0.3, // Radius of the character capsule
   floatHeight: 0.3, // Height of the character when floating
   characterInitDir: 0, // Character initial facing direction (in rad)
-  followLight: false, // Enable follow light mode
+  followLight: false, // Enable follow light mode (name your light "followLight" before turn this on)
   // Follow camera setups
   camInitDis: -5, // Initial camera distance
   camMaxDis: -7, // Maximum camera distance
   camMinDis: -0.7, // Minimum camera distance
   camInitDir: 0, // Camera initial position direction (in rad)
+   // Follow light setups
+  followLightPos: { x: 20, y: 30, z: 10 }, // Follow light position
   // Base control setups
   maxVelLimit: 2.5, // Maximum velocity limit
   turnVelMultiplier: 0.2, // Turn velocity multiplier

src/Ecctrl.tsx

@@ -34,6 +34,8 @@ const Ecctrl = forwardRef<RapierRigidBody, EcctrlProps>(({
   camMaxDis = -7,
   camMinDis = -0.7,
   camInitDir = 0, // in rad
+  // Follow light setups
+  followLightPos = { x: 20, y: 30, z: 10 },
   // Base control setups
   maxVelLimit = 2.5,
   turnVelMultiplier = 0.2,
@@ -696,9 +698,9 @@ const Ecctrl = forwardRef<RapierRigidBody, EcctrlProps>(({
      * Apply character position to directional light
      */
     if (followLight && dirLight) {
-      dirLight.position.x = currentPos.x + 20;
-      dirLight.position.y = currentPos.y + 30;
-      dirLight.position.z = currentPos.z + 10;
+      dirLight.position.x = currentPos.x + followLightPos.x;
+      dirLight.position.y = currentPos.y + followLightPos.y;
+      dirLight.position.z = currentPos.z + followLightPos.z;
       dirLight.target = characterModelRef.current;
     }
 
@@ -1076,6 +1078,8 @@ export interface EcctrlProps extends RigidBodyProps {
   camMaxDis?: number;
   camMinDis?: number;
   camInitDir?: number;
+  // Follow light setups
+  followLightPos?: { x: number, y: number, z: number },
   // Base control setups
   maxVelLimit?: number;
   turnVelMultiplier?: number;