Tower Defense

CONTROLS: - Desktop: - Left Mouse Button / Click: Place tower (when tower type selected), Select tower (click existing tower), Interact with UI buttons (Pause, Speed, Tower selection, Upgrade, Sell) - Mouse Movement / Hover: Preview tower placement (ghost tower shows valid/invalid placement) - Mouse Click (Tower Selection Buttons): Select tower type to place (Basic, Laser, Missile, Ice, Tesla) - Mouse Click (Pause Button): Toggle pause/resume - Mouse Click (Speed Buttons): Change game speed (1x, 2x, 4x) - Mouse Click (Upgrade Button): Upgrade selected tower (costs $30) - Mouse Click (Sell Button): Sell selected tower (returns 75% of cost + upgrades) - Mouse Click (Title Screen): Start game - Mouse Click (Game Over Screen): Restart game - Mobile/Tablet: - Touch / Tap: Same as mouse click - Place towers, select towers, interact with UI - Touch and Drag: (If applicable) Move view or select multiple towers (not explicitly found in code) BASIC MECHANICS: 1. Tower Types - Basic Tower: - Cost: $50 - Damage: 10 per shot - Range: 110 pixels - Fire Rate: 48 frames (slower firing) - Color: Grey (0x4a4a4a) - Bullet: Yellow circle - Starting tower: Cheapest option for early game 2. Tower Types - Laser Tower: - Cost: $100 - Damage: 15 per shot - Range: 130 pixels (longest range) - Fire Rate: 30 frames (fast firing) - Color: Red (0xff0000) - Bullet: Red rectangle - Special: High fire rate and long range 3. Tower Types - Missile Tower: - Cost: $150 - Damage: 25 per shot (highest damage) - Range: 120 pixels - Fire Rate: 60 frames (slowest firing) - Color: Green (0x00ff00) - Bullet: Green circle with yellow tip - Special: Highest single-shot damage 4. Tower Types - Ice Tower: - Cost: $120 - Damage: 8 per shot - Range: 100 pixels (shortest range) - Fire Rate: 40 frames - Color: Cyan (0x00ffff) - Bullet: Cyan rectangle - Slow Effect: 0.5 (halves enemy speed) - Slow Duration: 120 frames - Special: Slows enemies on hit (blue tint visual effect) 5. Tower Types - Tesla Tower: - Cost: $200 - Damage: 12 per shot - Range: 140 pixels (longest range) - Fire Rate: 80 frames (very slow firing) - Color: Yellow (0xffff00) - Chain Lightning: Yes - Chain Range: 80 pixels - Max Chains: 3 additional enemies - Special: Chain lightning hits multiple enemies, electric visual effects 6. Tower Placement: - Selection: Click tower type button to select - Ghost tower: Preview shows where tower will be placed - Valid placement: Green tint on ghost tower - Invalid placement: Red tint on ghost tower - Placement rules: Cannot place on path, cannot place too close to existing towers (40 pixel minimum), must be within playable area (15 pixels from edges) - Click to place: Click valid location to place selected tower - Cost deduction: Money deducted on placement 7. Tower Upgrades: - Upgrade cost: $30 per upgrade - Damage increase: +5 damage per upgrade - Range increase: +10 pixels per upgrade - Fire rate improvement: -5 frames per upgrade (min 10 frames) - Upgrade limit: No explicit maximum level - Visual: Upgrade particles on upgrade - Upgrade button: Appears when tower selected and money available 8. Tower Selling: - Sell value: 75% of original cost + upgrade costs - Calculation: (towerType.cost + (level - 1) × upgradeCost) × 0.75 - Sell button: Appears when tower selected - Refund: Full money returned based on sell value - Tower removal: Tower removed from game immediately - Visual: Upgrade particles on sell 9. Tower Selection: - Click tower: Click existing tower to select - Range display: Green circle shows tower range - Info display: Upgrade and sell buttons appear - Deselection: Click empty space to deselect - Visual feedback: Selected tower shows range indicator 10. Enemy Spawning: - Wave start: Enemies spawn when wave begins - Spawn rate: 1 enemy per 40 frames (spawnInterval) - Spawn count: 4 + wave × 1.2 enemies (normal waves) - Path selection: Enemies randomly choose one of multiple paths - Spawn location: Start of chosen path - Spawn timer: Tracks time between spawns 11. Enemy Mechanics: - Health scaling: 60 + wave × 10 starting health - Speed scaling: 0.8 + wave × 0.05 starting speed - Waypoint system: Follows path waypoints sequentially - Path following: Moves along predefined path segments - Health bars: Green (high HP), Yellow (medium HP), Red (low HP) - Enemy death: Awards $10 money on kill - Base reach: Enemy damages base (loses 1 life) if reaches end 12. Boss Waves: - Boss waves: Waves 5, 10, 15, 20 - Boss spawn: Only 1 boss per boss wave - Boss health: 200 + wave × 50 (much higher than normal enemies) - Boss speed: 0.8 (same base speed) - Boss appearance: Larger dark red enemy with armor plates, spikes, and red eyes - Boss path: Randomly chooses path - Boss indicator: Boss flag distinguishes from normal enemies 13. Wave System: - Wave progression: Waves increment after all enemies defeated - Wave start: Automatic start after previous wave ends - Wave delay: 1200ms delay between waves - Wave tracking: Current wave displayed in UI - Wave scaling: Difficulty increases with wave number - Wave completion: All enemies must be defeated or reach base 14. Multiple Paths: - Path system: Two separate paths available - Main path: Longer winding path through center - Alternative path: Shorter path along edges - Path selection: Enemies randomly choose path at spawn - Path width: 46 pixels - Path color: Brown (0x4a4032) with texture - Path collision: Towers cannot be placed on paths 15. Money System: - Starting money: $200 - Enemy kill reward: $10 per enemy killed - Tower costs: Vary by tower type ($50-$200) - Upgrade costs: $30 per upgrade - Sell returns: 75% of tower investment - Money display: Top-left corner UI - Insufficient funds: Money text flashes red when cannot afford 16. Lives System: - Starting lives: 10 - Life loss: Enemy reaches base = -1 life - Game over: Lives reach 0 = game over - Lives display: Top-left corner UI (red text) - Life importance: Protect base to maintain lives 17. Tower Firing: - Target selection: Tower targets closest enemy in range - Range check: Enemies within tower.range pixels - Rotation: Turret rotates toward target - Fire cooldown: Tower must wait fireRate frames between shots - Bullet creation: Bullet spawned at tower position - Bullet direction: Toward target enemy - Bullet speed: 6 pixels per frame 18. Bullet Mechanics: - Bullet types: Different visuals per tower type - Bullet lifetime: 60 frames - Bullet speed: 6 pixels per frame (tower.bulletSpeed) - Hit detection: Bullet hits enemy if within 20 pixels - Damage application: Enemy health reduced by bullet damage - Bullet removal: Removed on hit, lifetime expiry, or screen exit - Impact particles: Created on enemy hit 19. Slow Effect System (Ice Tower): - Slow effect: Reduces enemy speed to 50% (slowEffect = 0.5) - Slow duration: 120 frames - Slow timer: Counts down from slowDuration - Visual indicator: Enemy sprite tinted blue (0x88ffff) when slowed - Speed calculation: currentSpeed = baseSpeed × slowEffect - Stacking: New slow resets timer (doesn't stack) - Reset: Enemy returns to normal speed when timer expires 20. Chain Lightning System (Tesla Tower): - Chain lightning: Tesla towers don't fire bullets - Primary target: First enemy in range - Chain range: 80 pixels from previous target - Max chains: 3 additional enemies (4 total hits) - Chain selection: Finds closest unchained enemy within range - Damage application: All chained enemies take damage simultaneously - Visual: Jagged yellow lightning bolt graphics - Lightning duration: 200ms visual effect - Chain efficiency: Maximizes damage against groups 21. Particle Effects: - Impact particles: Created when bullets hit enemies (8 particles) - Explosion particles: Created when enemies die (15 particles) - Upgrade particles: Created when upgrading/selling towers (12 particles) - Particle colors: Match tower/bullet type - Particle lifetime: Random 20-50 frames - Particle physics: Friction and velocity decay - Particle container: Separate container for performance 22. Screen Shake: - Activation: Triggered on enemy death (explosion) - Intensity: 5 pixels maximum - Decay: Intensity reduces by 10% per frame - Effect: Stage position shifts randomly within intensity - Visual feedback: Adds impact to explosions 23. Pause System: - Pause button: Top-right corner UI button - Toggle pause: Click to pause/resume - Pause state: Game updates stop when paused - Visual indicator: Button text changes to "RESUME" when paused - Button tint: Red tint when paused 24. Speed Control: - Speed options: 1x (normal), 2x (fast), 4x (very fast) - Speed buttons: Three buttons in top-right corner - Active indicator: Active speed button tinted green - Delta scaling: All game updates multiplied by gameSpeed - Time acceleration: Speeds up entire game simulation 25. Achievements: - First Kill: First enemy killed (not explicitly shown in code, may be placeholder) - Wave 10: Reached wave 10 ("Wave Master!") - Wave 20: Reached wave 20 ("Wave Legend!") - Money $1000: Accumulated $1000 ("Rich!") - Tower Master: Built 10 towers ("Tower Master!") - Achievement display: Notification appears in top-right - Achievement lifetime: 300 frames (5 seconds) - Achievement sound: Upgrade sound plays 26. Sound System: - Tower fire sounds: Different tones per tower type - Enemy hit sound: Square wave at 300Hz - Enemy death sound: Explosion sound (200Hz + 150Hz) - UI sound: Sine wave at 600Hz - Wave start sound: Three-tone ascending sequence - Game over sound: Three descending tones - Upgrade sound: Two ascending tones - Master volume: 0.3 (30%) - Audio context: Web Audio API 27. Game States: - Title state: Start screen with "Click to Start" - Play state: Active gameplay - Game Over state: End screen with wave survived count - State transitions: Title → Play → Game Over → Play (restart) - Container visibility: Different containers shown per state 28. Base Defense: - Base position: Right side of screen (gameWidth - 20, gameHeight / 2) - Base sprite: Image asset loaded from URL - Base visibility: Shown during play state - Base defense: Enemies must reach base to damage it - Base protection: Towers defend base by killing enemies 29. Path System Details: - Path width: 46 pixels - Path graphics: Brown color with texture details - Path segments: Connected waypoints form path - Path validation: Towers cannot be placed on paths - Path collision: Point-in-path detection (pathWidth / 2 + 4 pixel buffer) - Multiple paths: Two separate enemy routes 30. UI Elements: - Money display: Top-left, gold color ($FFD700) - Wave display: Top-left, white color - Lives display: Top-left, red color ($FF003C) - Tower selection: Bottom center, horizontal buttons - Control buttons: Top-right (Pause, Speed) - Upgrade button: Right side when tower selected - Sell button: Right side when tower selected - Achievement notifications: Top-right corner STRATEGIC TIPS: - Tower Variety: Mix tower types. Use Ice towers to slow, Tesla for groups, Missile for high HP enemies. - Path Coverage: Cover all paths. Enemies randomly choose paths - defend both routes. - Early Economy: Start with Basic towers. Save money for upgrades and better towers later. - Upgrade Priority: Upgrade damage dealers first. High-level towers more effective than many low-level ones. - Ice Support: Use Ice towers strategically. Slow enemies give other towers more time to damage. - Tesla Positioning: Place Tesla towers in enemy cluster zones. Chain lightning maximizes damage per shot. - Boss Preparation: Save money before boss waves. Bosses have high HP - upgrade towers or buy more. - Range Optimization: Use Laser towers for range. Long range covers more path area. - Sell Strategy: Sell poorly placed towers. 75% refund allows repositioning. - Speed Control: Use speed controls wisely. 2x-4x speed helps in later waves but requires fast reactions. ADVANCED TECHNIQUES: - Chokepoint Defense: Identify path bottlenecks. Concentrate towers where enemies cluster. - Tower Synergy: Combine Ice + Damage towers. Slow + high damage = effective combo. - Tesla Chains: Position Tesla for maximum chains. Group enemies for 4-hit chains. - Upgrade Timing: Upgrade mid-wave for immediate effect. Don't wait between waves. - Money Management: Balance spending vs. saving. Too many towers = no upgrades, too few = weak defense. - Path Prediction: Anticipate enemy path choices. Cover high-probability routes first. - Sell and Replace: Sell early Basic towers. Replace with specialized towers as economy grows. - Boss Strategy: Focus fire on bosses. Multiple upgraded towers needed for high-HP bosses. - Range Overlap: Overlap tower ranges slightly. Multiple towers can target same enemy. - Wave Preparation: Prepare for next wave during current wave. Upgrade and position strategically. WINNING AND PROGRESSION: - Wave Survival: Survive as many waves as possible. Higher waves = higher achievement. - Wave 10 Achievement: Reach wave 10 to unlock "Wave Master!" achievement. Demonstrates endurance. - Wave 20 Achievement: Reach wave 20 to unlock "Wave Legend!" achievement. Expert level play. - Money Achievement: Accumulate $1000 to unlock "Rich!" achievement. Effective economy management. - Tower Master Achievement: Build 10 towers to unlock "Tower Master!" achievement. Extensive defense grid. - Score Optimization: Maximize enemy kills per wave. Efficient tower placement increases kill rate. - Boss Defeats: Defeat all boss waves (5, 10, 15, 20). Boss waves test strategy and upgrades. - Economy Mastery: Maintain strong economy. Balance spending and earning for sustainable defense. - Perfect Waves: Complete waves without losing lives. Protect base perfectly. - Longevity Challenge: Survive as long as possible. Test limits of strategy and execution. Enjoy defending your base and building the ultimate tower defense grid!