The Ninja - Endless Runner Game

🎮 About The Game

The Ninja is an exciting endless runner game built with Python and Pygame that combines fast-paced action with beautiful parallax scrolling visuals. Control a nimble ninja character as you navigate through an endless urban landscape, avoiding obstacles and chasing high scores!

✨ Features

🎯 Core Gameplay

• Endless Running - Infinite gameplay with progressively increasing difficulty
• Double Jump Mechanic - Perform mid-air jumps for advanced maneuverability
• Dynamic Speed System - Game speed increases as your score grows
• Health System - Three-hit health system with visual heart indicators

🎨 Visual Excellence

• Parallax Scrolling - Multi-layered background for immersive depth
• Animated Sprites - Smooth character animations for running and jumping
• Pixel-Perfect Graphics - Carefully crafted visual elements
• Dynamic UI - Animated heart icons and real-time score display

🔊 Audio Experience

• Background Music - Engaging soundtrack that enhances gameplay
• Sound Effects - Jump, hurt, and game over sound effects
• Audio Management - Dynamic volume control during game states

💾 Progress & Data

• High Score System - Persistent score saving using JSON
• Real-time Statistics - Live score tracking and best performance display
• Game State Management - Smooth transitions between gameplay and menus

🕹️ How to Play

Basic Controls

• SPACE BAR - Jump (Press again in air for double jump)

Game Rules

1. Avoid obstacles by jumping over them
2. Each collision reduces your health by one heart
3. Game speed increases every 2 points scored
4. Maximum speed cap ensures fair gameplay
5. Game ends when all hearts are lost

Scoring System

• +1 Point for each successfully avoided obstacle
• Speed Boost every 2 points
• Personal Best tracking with persistent storage

🚀 Installation

Prerequisites

• Python 3.6 or higher
• Pygame library

Step-by-Step Setup

1. Clone the Repository

   git clone https://github.com/greatitandev/Ninja-Game-python.git
   cd the-ninja-runner

2. Install Dependencies

   pip install pygame

3. Verify File Structure

   the-ninja-runner/
   ├── main.py
   ├── score.json
   ├── images/
   │   ├── city/          # Background layers
   │   ├── player/        # Character animations
   │   ├── obstacle/      # Obstacle variations
   │   ├── heart/         # Health indicators
   │   └── bg/           # Menu backgrounds
   └── sound/
       ├── background.mp3
       ├── jump.wav
       ├── hurt.wav
       ├── hurt1.wav
       └── lose.wav
   

4. Launch the Game

   python main.py

🎯 Game Screenshots

Gameplay	Game Over

🔧 Technical Details

Game Architecture

• Object-Oriented Design - Clean class structure for game entities
• Sprite-Based Rendering - Efficient image handling and animation
• Event-Driven Logic - Responsive input handling and game state management

Performance Features

• Frame Rate Control - Consistent 60 FPS gameplay
• Efficient Collision Detection - Rectangle-based collision system
• Memory Management - Proper resource loading and cleanup

File Structure

# Core Classes
Player()        # Handles player movement, jumping, and animations
Obstacle()      # Manages obstacle generation and movement

# Game Systems
load_sound()    # Audio file management
get_score()     # High score persistence
save_score()    # Progress saving

🛠️ Customization

Easy Modifications

• Difficulty: Adjust SPEED_INCREMENT and SPEED_INCREASE_RATE
• Physics: Modify JUMP_STRENGTH and GRAVITY constants
• Visuals: Replace image files in respective folders
• Audio: Add new sound files to the sound directory

Adding New Features

The modular code structure makes it easy to add:

• New obstacle types
• Power-ups and collectibles
• Additional character abilities
• New background themes

🐛 Troubleshooting

Common Issues

1. Missing Dependencies

   pip install --upgrade pygame

2. File Not Found Errors

   • Ensure all asset folders are in the correct location
   • Check file paths in the code match your directory structure

3. Audio Playback Issues

   • Verify audio file formats (WAV, MP3)
   • Check system volume and audio drivers

Performance Tips

• Close other applications for optimal performance
• Update graphics drivers if experiencing lag
• Reduce screen resolution if needed

👨‍💻 Developer

Nimona Engida - Ethiopian Game Developer

Built with passion for game development and Python programming

About the Developer

• Self-taught young programmer and game developer
• Passionate about creating engaging gaming experiences
• Focus on clean code and user-friendly design
• Ethiopian developer promoting local tech talent

🌟 Contributing

We welcome contributions from the community! Feel free to:

1. Report bugs and issues
2. Suggest new features and improvements
3. Submit pull requests with enhancements
4. Share your modified versions

Development Guidelines

• Follow PEP 8 coding standards
• Test changes thoroughly before submitting
• Document new features clearly
• Maintain backward compatibility

📜 License

This project is licensed under the MIT License - see the LICENSE file for details.

You are free to:

• Use, copy, modify, and distribute the software
• Use for commercial purposes
• Sublicense and sell copies

🎊 Acknowledgments

• Pygame Community - For excellent documentation and support
• Open Source Assets - Contributors to free game development resources
• Testers - Everyone who helped refine the gameplay experience

---

Ready to become the ultimate ninja? Start running now!

"With great speed comes great responsibility... to avoid obstacles!" 🏃‍♂️💨