# spaceShooter
**Repository Path**: leeming751/spaceShooter
## Basic Information
- **Project Name**: spaceShooter
- **Description**: :video_game: The classic retro game recreated using Pygame and python
- **Primary Language**: Python
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No
## Statistics
- **Stars**: 0
- **Forks**: 0
- **Created**: 2020-05-03
- **Last Updated**: 2024-12-15
## Categories & Tags
**Categories**: Uncategorized
**Tags**: None
## README
## Space Shooter
The classic retro game recreated using `Pygame` and `python`.
## Index
- [Demo](https://github.com/tasdikrahman/spaceShooter#demo)
- [Screenshots](https://github.com/tasdikrahman/spaceShooter#screenshots)
- [Game Features](https://github.com/tasdikrahman/spaceShooter#game-features)
- [Controls](https://github.com/tasdikrahman/spaceShooter#controls)
- [Installation](https://github.com/tasdikrahman/spaceShooter#installation)
- [For Windows](https://github.com/tasdikrahman/spaceShooter#for-windows)
- [Linux/Debian based systems](https://github.com/tasdikrahman/spaceShooter#linuxdebian-based-systems)
- [Option 1: Download the zipped executable file](https://github.com/tasdikrahman/spaceShooter#option-1-download-the-zipped-executable-file)
- [Option 2: Build from source](https://github.com/tasdikrahman/spaceShooter#option-2-build-from-source)
- [For MAC OS X](https://github.com/tasdikrahman/spaceShooter#for-mac-os-x)
- [Contributing](https://github.com/tasdikrahman/spaceShooter#contributing)
- [Contributers](https://github.com/tasdikrahman/spaceShooter#contributers)
- [To-do](https://github.com/tasdikrahman/spaceShooter#to-do)
- [Issues](https://github.com/tasdikrahman/spaceShooter#issues)
- [Similar](https://github.com/tasdikrahman/spaceShooter#similar)
- [License](https://github.com/tasdikrahman/spaceShooter#license)
- [Donation](https://github.com/tasdikrahman/spaceShooter#donation)
## Demo
[[Back to top]](https://github.com/tasdikrahman/spaceShooter#index)
Follow the youtube video to see how I fared on ``spaceShooter``
[](https://www.youtube.com/watch?v=o99zpLsM-ZI)
## Screenshots
[[Back to top]](https://github.com/tasdikrahman/spaceShooter#index)
|  |  |
|---------------------------------------------|---------------------------------------------|
|  |  |
## Game Features
[[Back to top]](https://github.com/tasdikrahman/spaceShooter#index)
- Health bar for the space ship
- Score board to show how you are faring so far
- Power ups like
- shield: increases the space ships life
- bolt: increases the shooting capability of the ship by firing 2 to 3 bullets instead of one at time.
- Custom sounds and sprite animation for things like
- meteorite explosion
- bullet shoots
- player explosion
- 3 lives per game
- Fun to play :)
## Controls
[[Back to top]](https://github.com/tasdikrahman/spaceShooter#index)
| | Button |
|--------------|---------------------|
| Move Left | left |
| Move right | right |
| Fire bullets | spacebar |
| Quit game | Esc |
## Installation
[[Back to top]](https://github.com/tasdikrahman/spaceShooter#index)
### For `Windows`
- :arrow_down: [Download the prebuilt zip file and unzip it.](https://github.com/tasdikrahman/spaceShooter/releases/latest)
- Run the executable named `spaceShooter` inside the extracted file.
### `Linux/Debian` based systems
#### Option 1: Download the zipped executable file
- :arrow_down: [Download the latest zip file for linux](https://github.com/tasdikrahman/spaceShooter/releases/latest)
- Unzip the file
If your download was saved on the `~/Downloads` folder
Press Ctrl + Alt + T to open the shell if you are on `GNU/Linux` based systems and type
```bash
$ unzip ~/Downloads/SpaceShooter-0.0.3.Linux.zip -d ~/Desktop
$ cd ~/Desktop
$ ## navigate to the unzipped file and change the file permissions for the executable
~/Desktop $ chmod +x spaceShooter
~/Desktop $ ./spaceShooter
```
This will unzip the file on your `Desktop`, you can replace it with the directory of your choice
**NOTE** : If it gives you an error, you probably don't have `unzip` installed in your system.
```bash
$ sudo apt-get install unzip
```
That should fix the error.
- Run the executable named `spaceShooter`
A Similar process would be followed for `OS X`
#### Option 2: Build from source
You need to have `pygame` installed for this option.
### For `FreeBSD`
```sh
$ sudo pkg install devel/py-game
```
##### Clone the repo
```sh
$ git clone https://github.com/tasdikrahman/spaceShooter.git
$ cd spaceShooter/
$ chmod +x spaceShooter.py
$ python spaceShooter.py
```
### For `Ubuntu/Debian`
```bash
$ sudo apt-get install python-pygame
```
##### Clone the repo
```bash
$ git clone https://github.com/tasdikrahman/spaceShooter.git
$ cd spaceShooter/
$ python spaceShooter.py
```
### For `MAC OS X`
You have to build from source to get it up and running on `OS X`. Reason?
I don't have an `OS X` system to build the executable! So I would love for a Pull request on that one.
Building from source will do the trick though
```bash
$ pip3 install hg+http://bitbucket.org/pygame/pygame
```
Install Pygame specific dependencies
```bash
$ brew install sdl sdl_image sdl_ttf portmidi libogg libvorbis
$ brew install sdl_mixer --with-libvorbis
```
##### Clone the repo
```bash
$ git clone https://github.com/tasdikrahman/spaceShooter.git
$ cd spaceShooter/
$ python spaceShooter.py
```
## Contributing
[[Back to top]](https://github.com/tasdikrahman/spaceShooter#index)
This game was written in one day, so the coding standards might not be up the mark. Don't be shy to make a Pull request :)
For details, please refer [the Contributing page](https://github.com/tasdikrahman/spaceShooter/blob/master/CONTRIBUTING.rst)
### Contributers
[[Back to top]](https://github.com/tasdikrahman/spaceShooter#index)
- [@bardlean86](https://github.com/bardlean86/) for adding the third missile powerup and the main menu
### To-do
[[Back to top]](https://github.com/tasdikrahman/spaceShooter#index)
- [x] Add the `windows` executable file
- [x] Add main menu for the game
- [x] Fix [bug](https://github.com/tasdikrahman/spaceShooter/blob/master/spaceShooter.py#L372) which stops the background music from looping
- [x] Add support for `WAV` game music file as `ogg` format is not playable as described in [#1](https://github.com/tasdikrahman/spaceShooter/issues/1)
- [ ] Add feature to pause to the game.
- [ ] add feature to replay the game after all players die
- [ ] Add `OS X` executable file as the `Debian` based one fails to execute on it
## Issues
[[Back to top]](https://github.com/tasdikrahman/spaceShooter#index)
You can report the bugs at the [issue tracker](https://github.com/tasdikrahman/spaceShooter/issues)
**OR**
You can [tweet me](https://twitter.com/tasdikrahman) if you can't get it to work. In fact, you should tweet me anyway.
## Similar
[[Back to top]](https://github.com/tasdikrahman/spaceShooter#index)
- [Bullethell.py ](https://github.com/Frederikxyz/bullethell.py) : A fork of [tasdikrahman/spaceShooter](https://github.com/tasdikrahman/spaceShooter) which adds fancy shooting capabilities
## License
[[Back to top]](https://github.com/tasdikrahman/spaceShooter#index)
Built with ♥ by [Tasdik Rahman](http://tasdikrahman.me)[(@tasdikrahman)](https://twitter.com/tasdikrahman) under [MIT License](http://tasdikrahman.mit-license.org)
You can find a copy of the License at http://tasdikrahman.mit-license.org/
- The images used in the game are taken from [http://opengameart.org/](http://opengameart.org/), more particulary from the [Space shooter content pack](http://opengameart.org/content/space-shooter-redux) from [@kenney](http://opengameart.org/users/kenney).
License for them is in `Public Domain`
- The game sounds were again taken from [http://opengameart.org/](http://opengameart.org/). The game music, [Frozen Jam](http://opengameart.org/content/frozen-jam-seamless-loop) by [tgfcoder](https://twitter.com/tgfcoder) licensed under [CC-BY-3](http://creativecommons.org/licenses/by/3.0/)
## Donation
[[Back to top]](https://github.com/tasdikrahman/spaceShooter#index)
If you have found my little bits of software being of any use to you, do consider helping me pay my internet bills :)
| PayPal | 
|
|:-------------------------------------------:|:-------------------------------------------------------------:|
| Gratipay | 
|
| Patreon | 
|
| £ (GBP) | 
|
| € Euros | |
| ₹ (INR) | 
|