Pacman-3D

CONTROLS: - Desktop: - Up Arrow (↑) / KeyCode 38: Move forward - Down Arrow (↓) / KeyCode 40: Move backward - Left Arrow (←) / KeyCode 37: Turn left / Rotate left - Right Arrow (→) / KeyCode 39: Turn right / Rotate right - Space Key / KeyCode 32: Alternative input (interaction) - Mobile/Tablet: - Touch controls not explicitly implemented (desktop-focused game with arrow keys) BASIC MECHANICS: 1. Movement System: - First-person 3D movement through maze - Forward/backward movement using up/down arrows - Left/right turning using left/right arrows - Movement speed: s = 2 units per frame - Smooth 3D position updates - Camera follows player position and direction 2. Maze Navigation: - Navigate through 3D maze corridors - Walls block movement (collision detection) - Grid-based maze layout - Position rounding for grid alignment - Four-directional movement with turning 3. Dot Collection: - Collect small dots scattered throughout maze - Each dot worth 10 points - Dots marked as "isDot = true" - Dots become invisible when collected - Collect all dots to complete level - Dot counter tracks remaining dots 4. Power Pellets: - Large glowing pellets (marked with "o" in layout) - Each power pellet worth 50 points - Power pellets marked as "isPowerPellet = true" - Eating power pellet activates "atePellet" flag - Makes all ghosts vulnerable (afraid) for 10 seconds - Ghosts turn white when afraid 5. Ghost System: - Ghosts spawn from ghost spawn point (marked "G" in layout) - Ghosts initially red color - Ghosts move autonomously through maze - Ghost speed: d = 1.5 units per frame - Maximum 4 ghosts active simultaneously - Ghost spawns every 8 seconds after first ghost 6. Ghost Behavior: - Normal state: Red color, chases player, causes death on contact - Afraid state: White color, flees from player, can be eaten - Ghost becomes afraid when power pellet eaten - Afraid duration: 10 seconds (timer-based) - Ghost direction changes at walls randomly - Ghosts can wrap around screen edges 7. Collision with Ghosts: - Touching normal ghost causes death (lose one life) - Touching afraid ghost (white) allows eating ghost - Eating ghost worth 200 points - Ghost respawns after being eaten - Distance check: < 0.5625 units triggers collision 8. Lives System: - Start with 3 lives - Life icons displayed in top-right corner - Lose one life when touching normal ghost - Life icons removed when lost - Game over when all lives lost (L = 0) - Lives reset when level completed 9. Level Completion: - Complete level by collecting all dots - Level complete grants 1000 bonus points - Victory message displayed: "You won =D" - Level resets with all dots restored - Speed increases: movement speed +1, ghost speed +1.5 - Player and ghosts get faster each level 10. Speed Progression: - Initial movement speed: s = 2 - Initial ghost speed: d = 1.5 - Speed increases each completed level - Movement speed: s += 1 per level - Ghost speed: d += 1.5 per level - Progressive difficulty through speed 11. Game Modes: - Classic Mode: Complete 5 unique levels with different layouts - Level 1: Original classic layout - Level 2: Cross-shaped maze with more walls - Level 3: Spiral maze with winding paths - Level 4: Complex maze with multiple sections - Level 5: Final boss level - Most complex maze - Survival Mode: Endless waves of ghosts with random layouts - Infinite gameplay - Random level layouts from pool - Wave progression system - Survival focus over completion 12. Scoring System: - Dot collected: +10 points - Power pellet collected: +50 points - Ghost eaten: +200 points - Level completed: +1000 points - Game completed (all levels): +5000 points - Score displayed continuously during gameplay 13. High Score System: - High score saved to localStorage - Key: "mysticbyte_pacman_highscore" - High score persists between sessions - High score updated when game over or level complete - High score tracking for competition 14. Achievement System: - First Dot: Collect first dot (10+ points) - Score Master: Reach 1000 points - Score Legend: Reach 5000 points - First Ghost: Eat first ghost (mentioned in code) - First Level: Complete first level - Perfect Level: Complete level perfectly (mentioned in code) - Achievement notifications display with animations 15. Visual Effects: - Particle effects on score events - Gold particles for dots/power pellets - Red particles for ghost eating - Particles created at screen center - Achievement popup notifications - Visual feedback for all actions 16. Sound System: - Sound effects for different actions - Dot sound: 800 Hz, 0.1s duration - Ghost sound: 200 Hz, 0.3s duration - Power pellet sound: 1200 Hz, 0.2s duration - AudioContext-based sound generation - Sound enabled/disabled toggle 17. Camera System: - First-person perspective camera - Camera follows player position - Camera positioned behind and above player - Camera looks at player position + direction - Smooth camera interpolation - Different camera positions for won/lost states 18. 3D Rendering: - Three.js WebGL renderer - 3D meshes for walls, dots, pellets, player, ghosts - Ambient and spot lighting - Phong and Lambert materials - Smooth animations and transitions 19. Player Animation: - Pacman character animated with mouth opening/closing - 40 frames of animation for mouth movement - Animation based on distance moved - Death animation sequence - Visual feedback for movement 20. Ghost AI: - Ghosts navigate maze autonomously - Ghost direction changes when hitting walls - Random direction selection at junctions - Ghosts avoid getting stuck - Ghosts wrap around screen edges - Ghost behavior differs when afraid 21. Screen Wrapping: - Player and ghosts wrap around screen edges - Left edge wraps to right edge - Right edge wraps to left edge - Top edge wraps to bottom edge - Bottom edge wraps to top edge - Seamless maze traversal 22. Level Layouts: - Each level has unique ASCII-based layout - Layouts define wall positions (#) - Dots marked with period (.) - Power pellets marked with "o" - Player spawn marked with "P" - Ghost spawn marked with "G" - 5 distinct layouts for Classic mode 23. Game States: - Loading: Initial loading screen - Mode Selection: Choose Classic or Survival - Playing: Active gameplay - Level Complete: Victory state - Game Over: Death state - Paused: (If applicable) 24. UI Elements: - Score display: Top-left corner - Level/Wave display: Below score - Lives display: Top-right corner - Help button: Opens controls dialog - Achievement notifications: Popup system - MysticByte Studios logo: Top-left 25. Death and Respawn: - Death occurs on ghost contact - Death message: "You died =(" or "Game over =(" - Respawn after 4 seconds delay - Player respawns at spawn position (P) - Direction reset to default (-1, 0, 0) - Distance moved reset to 0 STRATEGIC TIPS: - Power Pellet Strategy: Save power pellets for when ghosts are nearby. Eating multiple ghosts during one power pellet maximizes points. - Dot Collection Route: Plan efficient routes to collect all dots. Minimize backtracking to complete levels faster. - Ghost Avoidance: Keep distance from ghosts when no power pellet active. Use corners and maze turns to escape pursuit. - Speed Adaptation: Adjust to increasing speed each level. Faster gameplay requires quicker reactions and decisions. - Screen Wrapping: Use screen wrapping to escape ghosts. Wrapping can create distance or confuse ghost AI. - Power Pellet Timing: Time power pellet collection when multiple ghosts are nearby. Maximize ghost eating opportunities. - Maze Familiarity: Learn each level's layout. Knowing dot and power pellet locations improves efficiency. - Ghost Pattern Recognition: Observe ghost movement patterns. Understanding AI helps predict ghost behavior. - Life Conservation: Protect your 3 lives carefully. Lives are limited and critical for progression. - Score Optimization: Balance speed with point collection. Eating ghosts during power pellets significantly boosts score. ADVANCED TECHNIQUES: - Ghost Farming: Use power pellets strategically to eat maximum ghosts. Position yourself to intercept multiple fleeing ghosts. - Speed Mastery: Master movement at highest speeds. Advanced players adapt to speed increases quickly. - Route Optimization: Develop optimal dot collection routes. Efficient paths complete levels faster and score higher. - Power Pellet Chain: Chain power pellet activations effectively. Time activations to maintain ghost vulnerability periods. - Wrapping Techniques: Master screen wrapping for tactical advantage. Wrapping can save lives and confuse ghosts. - Death Avoidance: Develop evasive movement patterns. Advanced players rarely die through skillful navigation. - Score Maximization: Maximize score through efficient play. Combining dots, pellets, and ghost eating optimizes points. - Pattern Recognition: Learn ghost AI patterns. Understanding ghost behavior enables prediction and counter-strategy. - Level Memorization: Memorize level layouts for speed runs. Layout knowledge enables perfect routes. - Survival Mode Mastery: Master endless survival mode. Survival requires perfect execution and adaptation. WINNING AND PROGRESSION: - Level Completion: Complete all dots in level to advance. Each level completed unlocks next challenge. - Classic Mode Victory: Complete all 5 levels in Classic mode. Full completion grants 5000 bonus points. - Score Achievement: Achieve high scores through efficient play. High scores saved and tracked for competition. - Achievement Unlocking: Unlock all achievements through gameplay. Achievements provide goals and rewards. - Speed Mastery: Complete levels at maximum speed. Speed increases test and improve skills. - Life Conservation: Complete levels without losing lives. Perfect play demonstrates mastery. - Ghost Mastery: Eat maximum ghosts during power pellets. Ghost eating optimizes scoring potential. - Pattern Mastery: Master all 5 level layouts. Layout knowledge enables efficient completion. - Survival Progression: Progress through survival waves. Endless waves test endurance and skill. - High Score Challenge: Beat high score records. Competitive scoring motivates improvement. Enjoy navigating the 3D mazes in Pacman 3D and mastering the classic arcade gameplay!