🎮 Add Temple Run Endless Runner Game

[continue]

Overview

This PR adds a fully functional Temple Run-style endless runner game to the FolderScopeAI repository!

What's New

Game Features

• Endless running gameplay with smooth physics
• Jump and slide mechanics to avoid obstacles
• Coin collection system for bonus points
• Power-ups (speed boost) for extra challenge
• High score tracking to beat your personal best
• Multiple obstacle types (low, medium, high)
• Clean OOP design with sprite-based collision detection

Controls

• SPACE or UP ARROW: Jump over obstacles
• DOWN ARROW: Slide under obstacles
• SPACE in menu: Start game

Files Added

• temple_run_game.py - Main game implementation (500+ lines)
• TEMPLE_RUN_README.md - Comprehensive game documentation
• game_requirements.txt - Game dependencies (pygame)
• Updated main README.md with game section

How to Play

pip install pygame
python temple_run_game.py

Technical Details

• Built with Python 3 and Pygame
• 60 FPS gameplay
• 800x600 resolution
• Sprite-based architecture
• State machine for menu/playing/game over

Screenshots

The game includes:

• Main menu with instructions
• In-game HUD showing score, coins, and distance
• Game over screen with statistics
• Speed boost visual indicator

Testing

• ✅ Jump mechanics work correctly
• ✅ Slide mechanics work correctly
• ✅ Collision detection is accurate
• ✅ Coin collection increments score
• ✅ Power-ups provide speed boost
• ✅ High score persists during session
• ✅ Game over triggers on obstacle collision

Why This Addition?

This adds a fun, interactive element to the FolderScopeAI project while demonstrating:

• Clean Python code structure
• Game development fundamentals
• Object-oriented programming
• Event-driven architecture

Enjoy the game! 🏃💨

---

This agent session was co-authored by ijtihad-emon-1 and Continue.