Skip to content

Asteroids is a classic arcade game where the player controls a spaceship in an asteroid field. The objective is to destroy asteroids and avoid collisions to survive as long as possible.

Notifications You must be signed in to change notification settings

luckstraw/asteroids

Repository files navigation

Asteroids

Table of Contents

  1. Project Description
  2. Features
  3. Screenshots
  4. Installation
  5. How to Play
  6. Contributing
  7. License

Project Description

Asteroids is a classic arcade game where the player controls a spaceship in an asteroid field. The objective is to destroy asteroids and avoid collisions to survive as long as possible.

Features

  • Player-controlled spaceship
  • Randomly generated asteroids
  • Collision detection
  • Asteroid health tracking

Screenshots

Main Gameplay

Main Gameplay

Controls

Controls

Installation

Make sure you have Python 3 or the latest version installed before proceeding.

  1. Clone the repository:
    git clone https://github.com/luckstraw/asteroids.git
  2. Navigate to the project directory:
    cd asteroids
  3. Create a virtual environment:
    python3 -m venv venv
  4. Activate the virtual environment:
    • On Windows:
      .\venv\Scripts\activate
    • On macOS and Linux:
      source venv/bin/activate
  5. Install the requirements:
    pip install -r requirements.txt
  6. Run the Game:
    python3 main.py

How to Play

  • Use the arrow keys to navigate the spaceship.
  • Press the spacebar to shoot and destroy asteroids.
  • Avoid collisions with asteroids to survive.

Contributing

We welcome contributions! Please fork the repository and submit pull requests.

About

Asteroids is a classic arcade game where the player controls a spaceship in an asteroid field. The objective is to destroy asteroids and avoid collisions to survive as long as possible.

Topics

Resources

Stars

Watchers

Forks

Languages