🔴 BOUNCE 3D: VELOCITY REBORN

A modern, high-octane 3D remake of the legendary Nokia keypad phone game Bounce, built with Three.js and procedural Web Audio API.

---

🎮 Highlights & Gameplay

• Authentic Front-View 2.5D Camera: Faithful to the original Nokia gameplay layout, jump arcs, and side-scrolling platforming mechanics, elevated by modern 3D geometry and volumetric lighting.

• Dynamic Ball Physics & Soft-Body Deformations:

  • Squashes vertically and widens when slamming into floors.
  • Elongates along velocity vectors when launching from jump pads or falling fast.
  • Smooth rolling rotation with real 3D ball spin.

• Iconic Classic Mechanics Modernized:

  • Golden Hoops: Suspended rings that spin in 3D. Collecting them triggers golden sparkle vortexes, combo multipliers, and unlocks the final gate.
  • Exit Gate / Portal: Stargate that changes from a locked red barrier into an energetic swirling celestial portal once all hoops are gathered.
  • Pneumatic Pumps:
    • Big Ball Inflator: Inflates into a giant wrecking ball! High mass, floats like a buoy on water, and smashes through cracked brick barriers with explosive brick rubble particles.
    • Small Ball Deflator: Reverts to normal or mini size to squeeze through 1-block crawlways and bounce higher.
  • Volumetric Water Tanks: Translucent 3D water with buoyancy forces, fluid drag, surface ripples, and splash droplets on entry and exit.
  • Super Jump Pads: Floor launch pads with animated yellow chevrons that fling the ball high into the air.
  • Deadly Spikes: Metallic specular 3D spikes. Impact triggers a slow-mo pop explosion with rubber shard debris!
  • Checkpoints: Glowing lanterns that turn from red to emerald green when reached.

• Infinite Escalation System:

  • Level 1: Handcrafted tribute to Nokia Bounce Level 1.
  • Level 2: Handcrafted tribute to Nokia Bounce Level 2 (water swimming canal, Big Ball pump, cracked walls).
  • Levels 3+: Infinite procedural level generator that stitches together climbing shafts, gap hazards, submerged chambers, and moving obstacle runs across 4 rotating biomes (Retro Brick, Cyber Neon, Emerald Cave, Cosmic Void).

• Juicy Particle FX Engine:

  • Customizable trails (Golden Stars, Neon Ribbon, Fire Comet, Aqua Bubbles).
  • Multi-tiered ground impact shockwaves and dust puffs.
  • Rubber pop fragmentation.
  • Brick shattering physics debris.
  • Stage clear confetti celebration.

• Zero-Dependency Web Audio Synthesizer:

  • Procedural squishy boings, ascending combo chimes, sub-bass pops, splash whooshes, pump hisses, and dynamic arcade synth background music.

• Ball Locker & Customization:

  • Skins: Classic Red Rubber, Cyber Neon, Champion Gold, Magma Core, Liquid Chrome, 8-Bit Retro.
  • Trails: Golden Stars, Neon Ribbon, Fire Comet, Aqua Bubbles.
  • High score & stats tracker saved to localStorage.

• ⚡ Hyper Speed Dash (Shift / J / ⚡ DASH):

  • Rocket forward with high velocity ($v_x = \pm 18.0$), dynamic camera FOV widening ($50^\circ \to 58^\circ$), and glowing energy meter.

• 🧲 Ring Magnet Power-Up:

  • Automatically draws nearby golden rings toward the ball within an 8-unit radius for 10 seconds.

• 🛸 Patrolling Spiked Mines:

  • Floating robotic hazards that patrol horizontal and vertical waypoints.

• ⏱️ Live Speedrun Stopwatch & Personal Bests:

  • Tracks stage completion times to the millisecond with persistent PB records.

• 1UP Extra Life Pickups:

  • Hidden floating 3D pickups awarding extra lives up to 9 max with uplifting chime arpeggios.

• Dynamic Exit Navigation Compass:

  • Automatically guides you to the unlocked exit stargate with real-time distance and arrow direction.

• In-Game Pause System & Controls Guide:

  • Pause anytime with P, ESC, or HUD button to resume, inspect keyboard/touch controls, or access stage select.

---

🕹️ Controls

Action	Keyboard	Touch / Mobile
Roll Left	A or Left Arrow	◀ Touch Button
Roll Right	D or Right Arrow	▶ Touch Button
Jump / High Bounce / Swim	W, Space, or Up Arrow	▲ JUMP Big Touch Button
Hyper Speed Dash	Shift or J	⚡ DASH Touch Button
Pause Menu & Controls Guide	P or ESC	Top bar pause icon ⏸️
Quick Restart	R	Top bar restart icon 🔄
Fullscreen Mode	F11 / Browser	Top bar fullscreen icon ⛶
Toggle Sound	Mute button	Top bar speaker icon 🔊
Stage Select (Map)	Map button	Top bar map icon 🗺️
Save Game	Save button	Top bar disk icon 💾
Custom Skins Locker	Palette button	Top bar palette icon 🎨

---

📱 Playing on Mobile / Tablet

1. Double-click serve_mobile.bat (or run node serve_mobile.js).
2. The terminal will display your computer's Wi-Fi IP address (e.g., http://192.168.0.246:8080).
3. Open that link in mobile Safari (iOS) or mobile Chrome (Android) on any phone or tablet connected to the same Wi-Fi.
4. Includes full responsive touch controls, multi-touch concurrency, orientation detection, and fullscreen support.

---

🧪 Running Automated Tests

To run the full 40-test automated headless Chrome verification test suite:

node test_suite.js
# or double-click:
run_tests.bat

---

🚀 How to Play on PC

Double-click launch_game.bat (which configures NVIDIA Optimus dGPU acceleration) or open index.html directly in any web browser.