Cosmic Cat: Yarn Hunter

by BlueHome

v1.6.0

About

Help Captain Whiskers collect Golden Yarn Balls across the cosmos! A beautiful 3D space adventure for kids. Touch & drag to steer your cat rocket ship, collect yarn, and dodge asteroids through 10 exciting levels! ๐Ÿฑ๐Ÿš€โœจ

Game Design Document

๐Ÿ“„ View Game Plan (Markdown)

Releases

v1.6.0 - Sound Effects Added! ๐Ÿ”Š

๐Ÿ”Š **Full Sound Effects!** - โœจ Yarn collection: Happy chime (C-E-G progression) - ๐Ÿ’ฅ Asteroid hit: Explosion crash sound - ๐ŸŽ‰ Level complete: Victory fanfare - ๐Ÿ˜ฟ Game over: Sad descending tone - ๐Ÿ† Game win: Epic celebration melody ๐ŸŽต **Web Audio API:** - All sounds generated programmatically (no files!) - Lightweight and instant - Works on all browsers ๐Ÿ”‡ **Sound Toggle Button:** - Click ๐Ÿ”Š at top center to mute/unmute - Icon changes to ๐Ÿ”‡ when muted - Remembers preference during play session ๐ŸŽฎ **Audio Details:** - Yarn: Ascending musical notes (happy!) - Asteroid: Filtered noise (crash!) - Level: Short fanfare (achievement!) - Win: Long celebration (victory!) Now the game has audio feedback for every action! ๐Ÿฑโœจ

v1.5.0 - FIXED - All Yarn Actually Catchable!

๐Ÿ› **MAJOR FIX - Z-Depth Problem Solved:** - Yarn was spawning at different Z-depths (looked close but was 3 units away!) - ALL yarn now spawns at Z=0 (same plane as your ship) - Ship locked to Z=0 as well (no depth confusion) โœจ **Much Better Collision:** - Increased collision range from 1.5 to 2.0 units - VERY generous - if yarn looks close, you'll catch it! - No more "hovering over but can't catch" issue ๐ŸŽฏ **Simplified Floating:** - Yarn only drifts on X and Y (side to side, up and down) - NO Z-axis drift (stays at same depth as ship) - Tighter bounds (yarn won't drift out of reach) ๐ŸŽฎ **The Fix:** Before: Yarn at z=-3, ship at z=0 โ†’ looks close, 3 units apart! Now: Both at z=0 โ†’ if it looks close, it IS close! This should be the final fix for catchability! ๐Ÿฑ๐Ÿงถ

v1.4.0 - Floating Yarn & Better Challenge!

๐ŸŽฏ **All Yarn Now Reachable!** - Yarn spawns in circular pattern (evenly distributed) - All yarn balls guaranteed to be within ship range - No more unreachable yarn at edges! โœจ **Floating Yarn Balls!** - Yarn now drifts gently in space (sine wave motion) - Makes catching them more dynamic and fun - Requires timing and skill - not just position! - Yarn stays within bounds (won't drift away) ๐Ÿš€ **More Exciting Gameplay:** - MORE asteroids (5 base, faster scaling) - FASTER asteroids (18% faster base speed) - Ship movement range adjusted (can't go too far) - Ship bounded to playable area ๐Ÿ’ก **Design Philosophy:** - Asteroids = the challenge (dodge them!) - Floating yarn = the skill (catch at right moment!) - All yarn reachable = fair and fun! Perfect balance of challenge and achievability! ๐Ÿฑโœจ

v1.3.0 - CRITICAL FIX - Yarn Now Visible!

๐Ÿ› **CRITICAL GAME-BREAKING BUG FIXED:** - Yarn balls were spawning BEHIND the camera (invisible!) - Fixed yarn spawn positions to be in front of camera (z: -5 to +5) - Game is now actually playable! โœจ **Yarn Visibility Improvements:** - Made yarn balls 50% BIGGER (0.4 โ†’ 0.6 radius) - DOUBLED emissive brightness (easier to spot) - Made glow 80% bigger and brighter - Increased collection range for easier pickup ๐ŸŽฏ **Asteroid Improvements:** - Fixed asteroid spawn positions (were also too far away) - Asteroids now properly cycle from behind camera - Better visible distance for challenging gameplay Now you can actually SEE and COLLECT the golden yarn balls! Sorry for the bug! ๐Ÿ˜…

v1.2.0 - Faster & More Fun!

๐Ÿš€ **Major Gameplay Improvements:** - 2x FASTER ship movement - more responsive controls! - FASTER asteroids - much more challenging! - More asteroids per level for excitement - Bigger, faster particle explosions โœจ **Clear Progress System:** - BIG progress bar showing yarn collection - Clear objective display: "Collect X more yarn!" - Shows exact progress (3/5 yarn) - Better instructions on title screen ๐ŸŽฎ **Gameplay Enhancements:** - More yarn at higher levels (scales with difficulty) - Bonus life every 3 levels (max 5 lives) - Faster animations (yarn rotation, particles) - Pulsing glow effects on yarn - Small delay on level complete for satisfaction ๐ŸŽฏ Perfect for 10-year-olds - fast, clear, and challenging!

v1.1.0 - Bug Fix Release

๐Ÿ› **Critical Bug Fixes:** - Fixed game not starting (Three.js loading race condition) - Added proper error handling and loading checks - Fixed touch control issues on mobile devices - Fixed variable name conflict (window โ†’ windowMesh) - Added console logging for debugging - Improved event listener handling - Added fallback error messages โœจ **Improvements:** - Better mobile responsiveness - More reliable initialization - Proper touch event handling with preventDefault

v1.0.0 - Initial Release

- ๐Ÿฑ Captain Whiskers space cat character - ๐Ÿš€ Touch & drag rocket ship controls - โœจ 10 levels with increasing difficulty - ๐Ÿงถ Collect golden yarn balls - ๐Ÿ’ฅ Dodge asteroids - ๐ŸŽจ Beautiful 3D graphics with Three.js - ๐Ÿ“ฑ Mobile-friendly responsive design