🕹️ Gemika Arkanoid Retro Classical Game 🎮

Step into the neon-lit world of our Gemika Arkanoid Retro Classical Game – the quintessential blast from the past! Get ready to dive headfirst into the electrifying nostalgia of 80s arcade culture, where every brick you shatter brings you one step closer to arcade greatness! Strap in for a journey through time and space as you aim for the top of the leaderboard in this pixel-perfect adventure! 🕹️🌟

Table of Contents 📚

1. Introduction
2. Features
3. Getting Started
   • Prerequisites
   • Installing Python
   • Installing Pip
   • Installing Pygame
   • Installation
4. How to Play
5. File Structure
6. Configuration
7. Troubleshooting
   • ModuleNotFoundError: No module named 'pygame'
   • Step-by-Step Solution
   • Additional Tips
8. Credits
9. License

Introduction 🕹️

Inspired by the beloved 80s arcade era, this game combines the timeless charm of old-school gaming with modern twists and turns. Whether you're a seasoned retro gamer or a newcomer to the scene, get ready for a journey filled with pixelated nostalgia and adrenaline-pumping action. Break through brick walls, master the art of ball bouncing, and compete for the top spot on the leaderboard. Get ready to be whisked away to the golden age of arcades, where every victory feels like a triumph and every level conquered is a step closer to gaming greatness. Gemika Arkanoid Retro Classical Game, your ticket to a blast from the past! 🚀🕹️✨

Features ✨

• 🟦 Configurable Levels: Customize your levels for endless fun.
• 💾 Leaderboard: Compete with friends and players worldwide. Record your high scores and aim for the top.
• 🔊 Sound Effects: Enjoy immersive and retro sound effects that enhance your gaming experience (Note: Sound effects are not included; users need to add them to the appropriate directory).
• 🔄 Difficulty Levels: Choose from different difficulty settings to match your skill level.
• 🕹️ Retro Graphics: Relive the 80s with retro-style graphics and gameplay mechanics.
• 🎮 Intuitive Controls: Simple and intuitive controls that anyone can pick up and play.

Getting Started 🚀

Before you begin, make sure you have Python installed (preferably version 3.6 or higher). You will also need to install the Pygame library, which is used to create games in Python.

Prerequisites 🛠️

Ensure you have Python installed on your machine.

Installing Python 🐍

Windows

1. Download Python: Go to the Python Downloads page and download the latest installer.
2. Run the Installer: Open the installer and follow the prompts. Make sure to check the box that says "Add Python to PATH".
3. Verify Installation: Open Command Prompt and type:

   python --version

macOS

1. Download Python: Visit the Python Downloads page and download the latest installer.
2. Run the Installer: Open the installer and follow the instructions.
3. Verify Installation: Open Terminal and type:

   python3 --version

Linux

1. Use Package Manager: Open your terminal and run:

   sudo apt-get update
   sudo apt-get install python3 python3-pip

2. Verify Installation: Type:

   python3 --version

Installing Pip 📦

After installing Python, you may need to install pip, the package manager for Python, to install additional libraries such as Pygame.

Windows

Pip usually comes with Python installation on Windows. You can verify if pip is installed by running the following command in Command Prompt:

pip --version

macOS and Linux

Pip should be installed along with Python on macOS and most Linux distributions. You can verify its installation by running the following command in Terminal:

pip --version

If pip is not installed, you can install it using the instructions provided on the official pip website.

Installing Pygame 🕹️

Once you have Python and pip installed, you can install Pygame using pip:

pip install pygame

Or on macOS and Linux:

pip3 install pygame

Installation 📥

1. Clone the Repository:

   git clone https://github.com/leonism/Gemika-Arkanoid-Retro-Classical-Game.git
   cd Gemika-Arkanoid-Retro-Classical-Game/

2. Ensure Directory Structure: Make sure your directory structure looks like this:

   Gemika-Arkanoid-Retro-Classical-Game/
   │
   ├── assets/
   │   ├── sounds/
   │   │   ├── hit.wav           # Sound files are not included, so you may customize
   │   │   ├── lose_life.wav     # Images files are not included, so you may customize
   │   │   └── game_over.wav
   │   ├── images/
   │   │   ├── brick.png
   │   │   ├── paddle.png
   │   │   └── ball.png
   │   └── leaderboard.txt (created automatically)
   │
   ├── arkanoid/                 # Game source code
   │   ├── __init__.py           # Init file to mark the package
   │   ├── config.py             # Configuration file
   │   ├── game.py               # Main game logic
   │   ├── sprites.py            # Sprite classes
   │   ├── utils.py              # Utility functions
   │
   └── run_game.py               # Entry point to run the game
   

3. Run the Game: Navigate to the directory containing run_game.py and execute the following command to start the game:

   python run_game.py

How to Play 🎮

• Move the Paddle: Use the left and right arrow keys to move the paddle.
• Bounce the Ball: Prevent the ball from falling off the screen by bouncing it with the paddle.
• Break All Bricks: Your goal is to break all the bricks to advance to the next level.
• Score Points: Each brick you break scores points. Try to achieve the highest score!
• Monitor Lives: You start with 3 lives. Losing the ball costs a life. Lose all lives, and the game is over.

Configuration ⚙️

You can customize the game settings by modifying the config.py file. Here are some key configurations you can adjust:

• Screen Dimensions: Set the width and height of the game window.
• FPS: Adjust the frames per second for smooth gameplay.
• Colors: Customize the color scheme of your game elements.
• Asset Paths: Change the paths for your sound and image files if needed.

Troubleshooting 🛠️

ModuleNotFoundError: No module named 'pygame'

This indicates that Pygame is not installed. Install it using:

pip install pygame

Or else if you encountered the following error :

`/usr/local/bin/pip: bad interpreter: /usr/bin/python: no such file or directory`

This suggests that the pip command is pointing to a Python interpreter that does not exist on your system.

Step-by-Step Solution

1. Verify Python Installation:

   python3 --version

2. Install Pygame using Python3:

   python3 -m ensurepip --upgrade

   python3 -m pip install pygame

3. Running the Game:

   python3 run_game.py

Additional Tips

1. If pip is not working:

   python3 -m ensurepip --upgrade

2. Check your PATH:

   echo $PATH

   Ensure the correct Python binaries are in your PATH. If necessary, add Python to your PATH by modifying your .zshrc or .bashrc file:

   export PATH="/usr/local/bin:/usr/bin:/bin:/usr/sbin:/sbin:/Library/Frameworks/Python.framework/Versions/3.8/bin:$PATH"

3. Use a Virtual Environment:

   python3 -m venv venv
   source venv/bin/activate
   pip install pygame
   python run_game.py

By following these steps, you should be able to resolve the issues and get your Arkanoid game running smoothly. If you encounter any further issues, please provide the specific error messages so we can assist you further.

Credits 🎤

• Sound Effects: Thanks to FreeSound, Zapsplat, and SoundBible for providing the sound assets.
• Images: Special thanks to OpenGameArt, Kenney.nl, and GameArt2D

License 📄

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