A multi-platform fast-paced space shooter built with Python and pygame. Pilot your ship, dodge asteroids, and survive as long as you can.
- Python 3.10 or higher
- pip
-
Clone the repository:
git clone https://github.com/alejaalvar/pygons.git cd pygons -
(Recommended) Create and activate a virtual environment:
python3 -m venv venv source venv/bin/activate # Linux/macOS venv\Scripts\activate # Windows
-
Install dependencies:
pip install -r requirements.txt
-
Run the game:
python main.py
| Package | Version |
|---|---|
| pygame | 2.6.1 |
| Action | Keys |
|---|---|
| Rotate left | A / ← / J |
| Rotate right | D / → / L |
| Thrust | W / ↑ / K |
| Shoot | Space |
| Pause / Unpause | P / Esc |
| Restart | R |
| Quit | Q |
- 🔊 Sound effects — audio feedback for shooting, explosions, and collisions
- 🎵 Music — background soundtrack to set the atmosphere
- ⚙️ Settings menu — in-game options for customizing gameplay to your liking
- 🪨 Bigger asteroids — larger threats that take up more space
- 💥 Splitting asteroids — asteroids that break into smaller pieces on destruction
- ⚡ Escalating difficulty — asteroids get faster and more numerous as you survive longer
- ❤️ Ship lives — multiple chances before game over
- 🌠 Special events — meteor showers and other surprises to keep you on your toes
- 💯 Points System - earn points for each asteroid destroyed and for surviving!
This project is licensed under the MIT License. See LICENSE for details.
- On some Linux distros, it is necessary to set the execution bits after installation in order to play the game. You can do so by entering the following on the ccommand line:
chmod a+x /path/to/downloadIt is also possible to change the permissions in most graphical file managers if you prefer to use a GUI. Simply inspect the properties of the file and view its permissions.