🚀 Ajitroids

🚀 Ajitroids

A modern Asteroids remake built with Pygame

🎮 Game Description

Ajitroids is an exciting remake of the classic arcade game Asteroids with modern features and gameplay elements. Pilot your spaceship through dangerous asteroid fields, dodge space rocks, destroy enemies and collect power-ups while trying to achieve the highest score.

✨ Features

• Classic Gameplay: Control your ship with precise rotation and thrust
• Modern Graphics: Enhanced visuals with particle effects and animations
• Sound System: Dynamic sound effects and background music
• Power-Up System: Collect various weapon upgrades and shields
• Highscore System: Save your best results and compare them
• Boss Fights: Face epic boss enemies in higher levels
• Customizable Settings: Fullscreen mode, sound options and more
• Smooth Animations: Fluid ship movements and asteroid rotations

🚀 Installation

Prerequisites

• Python 3.8 or higher
• uv or pip

Installation with uv (recommended)

# Clone repository
git clone https://github.com/your-username/ajitroids.git
cd ajitroids

# Install dependencies
uv install

# Start the game
uv run main.py

Installation with pip

# Clone repository
git clone https://github.com/your-username/ajitroids.git
cd ajitroids

# Install dependencies
pip install -r requirements.txt

# Start the game
python main.py

🌟 Gameplay

• Main Menu: Choose from different game modes or adjust settings
• Tutorial: Learn the basics of the game (recommended for beginners)
• Asteroids: Destroy asteroids to collect points
• Power-Ups: Collect special power-ups for unique abilities
• Boss Enemies: Powerful boss enemies appear after certain levels
• Highscores: Save your best performances and compare them with others
• Achievements: Unlock achievements for completing special challenges

🎯 Controls

• Arrow Keys: Control ship (rotation and thrust)
• Space: Shoot
• ESC: Pause game
• B: Switch weapons (when available)

🚀 Spaceships

Ajitroids features unlockable spaceships with unique abilities:

• Speedster: A fast and agile ship, perfect for dodging asteroids.
• Tank: A heavily armored ship that can fire on two directions.
• Destroyer: A powerful ship equipped with advanced weaponry.

Unlock these ships by progressing through the game and achieving milestones!

🛡️ Enemies

• Enemy Ships: Hostile ships that chase the player and add challenge to the gameplay
• Interaction: Enemies can collide with the player and be destroyed by weapons
• Dynamic Movement: Enemies actively pursue the player within a detection radius

🛠️ Technical Details

• Developed with Pygame
• Object-oriented design with separate classes for game elements
• Modular sound engine with dynamic effects
• Efficient particle system for visual effects
• Collision detection with optimized algorithms

📜 License

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

👥 Contributors

• Me - Main Developer
• GitHub Copilot - Development Assistant

🙏 Acknowledgements

• Inspiration from the classic Atari game Asteroids
• Thanks to the Pygame community for the great library
• Boot.dev for support and inspiration
• GitHub Copilot for assistance with code development
• Developed with ❤️ and Pygame

Note: This project is in active development. New features and improvements are regularly being added.