Subway Surfers Game

A fast-paced, endless runner game built in C++ using SFML (Simple and Fast Multimedia Library). Navigate through subway tracks, collect coins, avoid obstacles, and climb the leaderboard!

🎮 Features

• Dynamic Gameplay: Experience progressively increasing difficulty with speed ramping

• Power-ups: Collect special items to enhance gameplay:

  • 🛡️ Shield: Protect yourself from one collision
  • 🧲 Magnet: Automatically attract nearby coins
  • ✈️ Jetpack: Fly above the tracks temporarily
  • 💰 Double Coins: Double your coin collection rate

• Score System:

  • Earn points per second while playing
  • Bonus points for collecting coins
  • Score multiplier from power-ups

• Player Profiles: Enter your name and compete against yourself and other players

• Leaderboard: Track top scores with player names and high scores saved locally

• Multiple Game States:

  • Start Menu
  • Name Entry
  • Main Menu
  • Active Gameplay
  • Pause Menu
  • Game Over Screen
  • Leaderboard Viewing

• Lane-based Movement: Move left and right between tracks to avoid obstacles

• Jump & Slide: Jump over obstacles or slide under them

• Progressive Difficulty: Game speed increases over time, reaching up to 20x the base speed

🛠️ Build & Installation

Prerequisites

• C++11 or higher
• SFML 2.6+ library
• CMake 3.10+
• GCC/Clang compiler (or MSVC for Windows)

On Linux/WSL

# Install SFML
sudo apt install libsfml-dev

# Clone or download the project
cd SubwaySurfers

# Create build directory
mkdir build
cd build

# Build with CMake
cmake ..
make

# Run the game
./subwaysurfers

On Windows

1. Download SFML 2.6+ from sfml-dev.org
2. Update the SFML_DIR path in CMakeLists.txt to match your SFML installation
3. Use CMake to generate Visual Studio project files
4. Build and run from Visual Studio or command line

📦 Project Structure

SubwaySurfers/
├── CMakeLists.txt           # Build configuration
├── main.cpp                 # Entry point
├── GameEngine.h/cpp         # Core game loop and state management
├── Player.h/cpp             # Player character and controls
├── TrackManager.h/cpp       # Track and obstacle management
├── Obstacle.h/cpp           # Obstacle objects
├── Coin.h/cpp               # Collectible coins
├── PowerUp.h/cpp            # Power-up mechanics
├── ScoreManager.h/cpp       # Score tracking and leaderboard
├── GameList.h               # Game object lists
├── Fence.h/cpp              # Fence/barrier objects
├── build/                   # Compiled binaries and build files
└── README.md                # This file

🎮 How to Play

1. Start the Game: Run the executable and enter your player name
2. Navigate:
   • Press Left/Right Arrow Keys or A/D to move between lanes
   • Press Space or W to jump
   • Press S to slide
3. Collect: Grab coins and power-ups for points and abilities
4. Survive: Avoid obstacles and fences
5. Score: Higher score = better placement on the leaderboard

🎯 Game Mechanics

• Speed Progression: Game speed increases by ~2 units every 10 seconds (capped at 20x base speed)
• Collision Detection: Hit obstacles to lose the shield or trigger game over
• Coin Collection: Normal coins worth 50 points; double coins worth 100 with the double coin power-up
• Power-up Duration: Power-ups last approximately 10 seconds each
• Leaderboard: Top 3 scores are saved and displayed

📊 Scoring

• Time-based Points: 10 points per second of survival
• Coins: 50 points per coin (100 with double coin power-up)
• Multipliers: Score multiplier increases based on active power-ups

🔧 Development

Key Classes

• GameEngine: Manages game states, game loop, and overall flow
• Player: Handles player movement, collisions, and power-up status
• TrackManager: Spawns and manages obstacles and coins
• ScoreManager: Tracks current score, coins, and maintains leaderboard
• PowerUp: Base class for all power-up types
• Obstacle: Collision objects the player must avoid

Building in Debug Mode

mkdir build && cd build
cmake -DCMAKE_BUILD_TYPE=Debug ..
make

💾 Save Files

The game creates two data files:

• highscore.dat: Stores your personal high score
• leaderboard.dat: Stores the top 3 player scores globally

🎨 Assets Required

Make sure the following asset files are in the game directory:

• Texture files (.png, .jpg)
• Font files (.TTF)
• Sound files (.wav)

These are automatically copied to the build directory during compilation.

🚀 Future Enhancements

• Add more power-up types
• Implement sound effects and background music
• Add difficulty levels
• Create multiple track themes
• Implement multiplayer modes
• Add achievements/badges system

📝 License

This project is provided as-is for educational and personal use.

🤝 Contributing

Feel free to fork this project, make improvements, and submit pull requests!

📧 Support

For issues or questions, please open an issue on GitHub.

---

Enjoy the game and good luck climbing the leaderboard! 🎮✨