Skip to content

a vertical scroller game where players steer their spaceship with hand movements, dodging asteroids and aiming for high scores.

License

Notifications You must be signed in to change notification settings

ushellnullpath/astroDodger

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

4 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

astroDodger is a space-themed vertical scroller game where players control a spaceship using hand gestures to dodge incoming asteroids and aim for high scores. Developed with Python, Pygame, OpenCV, and MediaPipe, astroDodger adds a unique twist to classic dodger gameplay by incorporating hand tracking for an immersive gaming experience.

When the game is first run, it has a gamertag screen where you can add your gamertag.

Untitled0

In the main game, avoid asteroids, survive asteroid waves, collect shields to stay alive, and aim for a high score.

Untitled1

Untitled2

The game over screen shows your score as well as the top 5 high scores when you click the 'High Scores' button.

Untitled3

Untitled4

Your scores are saved in an SQLite database every time you achieve a score. If you enter the same gamertag, it will update the score if it is higher.

Untitled5

Features

  • Hand Gesture Controls: Navigate your spaceship using hand movements captured by your webcam.
  • Dynamic Asteroid Waves: Encounter increasingly challenging waves of asteroids as you progress.
  • Power-Up System: Collect shields to protect your spaceship from damage.
  • Scoring System: Compete for high scores based on survival time.

How to Play

  1. Start the game and enter your gamertag.
  2. Use your hand to control the spaceship's movement |-> (ensure your webcam is enabled and you are in a well-lit room).
  3. Dodge incoming asteroids to survive.
  4. Collect shield power-ups to protect your ship.
  5. Survive as long as possible to achieve a high score!

Installation

  1. Ensure you have Python 3.x installed on your system.
  2. Clone this repository: git clone https://github.com/ushellnullpath/astroDodger
  3. Navigate to the project directory: cd astroDodger
  4. Install the required dependencies: pip install -r requirements.txt
  5. Execute the main game file: python main.py

Controls

Use your hand movements in front of the webcam to control the spaceship. The game tracks your index finger to determine the ship's position.

Development

astroDodger was developed using:

  • Python 3.x
  • Pygame for game mechanics and rendering
  • OpenCV and MediaPipe for hand tracking
  • Tkinter for the start menu
  • SQLite for saving scores

Future Enhancements (not sure when though...)

  • Implement multiple difficulty levels

  • Add additional animations

  • Introduce an online multiplayer mode

  • Develop an online leaderboard system

  • LAST UPDATED (D/M/Y): 06/08/2024

License

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

Credits:

Sound FX Keys FX Music Font

About

a vertical scroller game where players steer their spaceship with hand movements, dodging asteroids and aiming for high scores.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages