feat(player): add crouch functionality with speed and aim adjustments

index.html

@@ -189,7 +189,7 @@
     <div id="overlay-content">
       <h1>Orcs In The Forest</h1>
       <p>Click to Start</p>
-      <p style="font-size: 14px;">Move: WASD | Look: Mouse | Fire: Click | Reload: R | Grenade: Hold G then release | Light: F | Pause: ESC</p>
+      <p style="font-size: 14px;">Move: WASD | Look: Mouse | Fire: Click | Reload: R | Grenade: Hold G then release | Crouch: C | Light: F | Pause: ESC</p>
     </div>
   </div>
 

src/config.js

@@ -21,9 +21,12 @@ export const CFG = {
   player: {
     speed: 8,
     sprintMult: 1.5,
+    crouchMult: 0.6,
     radius: 0.8,
     health: 100,
-    jumpVel: 5
+    jumpVel: 5,
+    eyeHeight: 1.8,
+    crouchEyeHeight: 1.2
   },
   flashlight: {
     on: true,
@@ -86,6 +89,7 @@ export const CFG = {
     spreadMoveMult: 2.2,        // walking
     spreadSprintMult: 3.2,      // sprinting
     spreadAirMult: 4.0,         // not grounded
+    spreadCrouchMult: 0.6,      // crouching for precision
     magSize: 24,
     reloadTime: 1.6,
     recoilKick: 0.065,

src/events.js

@@ -41,6 +41,7 @@ export function setupEvents({ startGame, restartGame, beginReload, updateWeaponA
       case 'KeyS': G.input.s = true; break;
       case 'KeyD': G.input.d = true; break;
       case 'ShiftLeft': G.input.sprint = true; break;
+      case 'KeyC': G.input.crouch = true; break;
       case 'KeyG':
         if (G.state === 'playing') {
           G.input.grenade = true;
@@ -82,6 +83,7 @@ export function setupEvents({ startGame, restartGame, beginReload, updateWeaponA
       case 'KeyS': G.input.s = false; break;
       case 'KeyD': G.input.d = false; break;
       case 'ShiftLeft': G.input.sprint = false; break;
+      case 'KeyC': G.input.crouch = false; break;
       case 'KeyG':
         if (G.input.grenade) {
           G.input.grenade = false;

src/globals.js

@@ -30,6 +30,7 @@ export const G = {
     d: false,
     shoot: false,
     sprint: false,
+    crouch: false,
     jump: false,
     grenade: false
   },
@@ -63,7 +64,7 @@ export const G = {
     reserve: Infinity,
     reloading: false,
     reloadTimer: 0,
-    anchor: { depth: 0.92, right: 0.48, bottom: 0.42 },
+    anchor: { depth: 0.80, right: 0.417, bottom: 0.365 },
     // Dynamic aim spread (NDC units) and helpers
     spread: 0,
     targetSpread: 0,

src/hud.js

@@ -124,7 +124,10 @@ export function updateCrosshair(delta) {
   if (!ch.root || !ch.left || !ch.right || !ch.top || !ch.bottom) return;
 
   // Convert NDC spread to pixel gap (approximate using viewport width)
-  const ndc = Math.max(G.weapon.spread, CFG.gun.spreadMin || CFG.gun.bloom || 0);
+  // When crouched, the effective minimum spread is reduced
+  const baseMin = (CFG.gun.spreadMin || CFG.gun.bloom || 0);
+  const crouchMin = G.input.crouch ? baseMin * (CFG.gun.spreadCrouchMult || 1) : baseMin;
+  const ndc = Math.max(G.weapon.spread, crouchMin);
   const baseGap = 6; // px baseline gap
   const gapPx = baseGap + ndc * 0.5 * window.innerWidth; // half-width maps NDC to px
   const armLen = 10 + Math.min(20, ndc * window.innerWidth * 0.4); // grow a bit with spread

src/main.js

@@ -55,7 +55,7 @@ function init() {
   G.random = makeRandom(CFG.seed);
 
   // Player
-  const startY = getTerrainHeight(0, 0) + 1.8;
+  const startY = getTerrainHeight(0, 0) + (CFG.player.eyeHeight || 1.8);
   G.player = {
     pos: new THREE.Vector3(0, startY, 0),
     vel: new THREE.Vector3(),
@@ -103,7 +103,7 @@ function startGame() {
   G.player.health = CFG.player.health;
   G.player.score = 0;
   G.player.alive = true;
-  G.player.pos.set(0, getTerrainHeight(0, 0) + 1.8, 0);
+  G.player.pos.set(0, getTerrainHeight(0, 0) + (CFG.player.eyeHeight || 1.8), 0);
   G.player.vel.set(0, 0, 0);
   G.camera.position.copy(G.player.pos);
   G.damageFlash = 0;

src/player.js

@@ -28,7 +28,8 @@ export function updatePlayer(delta) {
 
   if (MOVE.length() > 0) {
     MOVE.normalize();
-    const speed = G.player.speed * (G.input.sprint ? CFG.player.sprintMult : 1);
+    let speed = G.player.speed * (G.input.sprint ? CFG.player.sprintMult : 1);
+    if (G.input.crouch) speed *= (CFG.player.crouchMult || 1);
     MOVE.multiplyScalar(speed * delta);
   }
 
@@ -61,7 +62,8 @@ export function updatePlayer(delta) {
   NEXT.y += G.player.yVel * delta;
 
   // Grounded against terrain height
-  const groundEye = getTerrainHeight(NEXT.x, NEXT.z) + 1.8;
+  const eye = G.input.crouch ? (CFG.player.crouchEyeHeight || 1.8) : (CFG.player.eyeHeight || 1.8);
+  const groundEye = getTerrainHeight(NEXT.x, NEXT.z) + eye;
   if (NEXT.y <= groundEye) {
     NEXT.y = groundEye;
     G.player.yVel = 0;

src/weapon.js

@@ -148,10 +148,12 @@ export function updateWeapon(delta) {
 
   const moving = G.input.w || G.input.a || G.input.s || G.input.d;
   const sprinting = moving && G.input.sprint;
+  const crouching = !!G.input.crouch;
   // Reduce sway/bob intensity and slightly lower frequencies
   G.weapon.swayT += delta * (sprinting ? 9 : (moving ? 7 : 2.5));
-  const bobAmp = sprinting ? 0.008 : (moving ? 0.006 : 0.0035);
-  const swayAmp = sprinting ? 0.0045 : (moving ? 0.0035 : 0.002);
+  let bobAmp = sprinting ? 0.008 : (moving ? 0.006 : 0.0035);
+  let swayAmp = sprinting ? 0.0045 : (moving ? 0.0035 : 0.002);
+  if (crouching) { bobAmp *= 0.7; swayAmp *= 0.7; }
 
   const bobX = Math.sin(G.weapon.swayT * 1.8) * bobAmp;
   const bobY = Math.cos(G.weapon.swayT * 3.6) * bobAmp * 0.6;
@@ -163,7 +165,8 @@ export function updateWeapon(delta) {
   const base = CFG.gun.spreadMin ?? CFG.gun.bloom ?? 0;
   const moveMult = moving ? (sprinting ? (CFG.gun.spreadSprintMult || 1) : (CFG.gun.spreadMoveMult || 1)) : 1;
   const airMult = G.player.grounded ? 1 : (CFG.gun.spreadAirMult || 1);
-  const target = Math.min(CFG.gun.spreadMax || 0.02, base * moveMult * airMult);
+  const crouchMult = crouching ? (CFG.gun.spreadCrouchMult || 1) : 1;
+  const target = Math.min(CFG.gun.spreadMax || 0.02, base * moveMult * airMult * crouchMult);
   G.weapon.targetSpread = target;
   const decay = CFG.gun.spreadDecay || 6.0;
   // Exponential approach to target