Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/tasdikrahman/spaceShooter

:video_game: The classic retro game recreated using Pygame and python
https://github.com/tasdikrahman/spaceShooter

linux pygame python rpg-game windows

Last synced: 2 months ago
JSON representation

:video_game: The classic retro game recreated using Pygame and python

Awesome Lists containing this project

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)
- [Credits](https://github.com/tasdikrahman/spaceShooter#credits)
- [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``

[![Space Shooter Demo - Youtube](http://i.imgur.com/bHjlJfG.jpg)](https://www.youtube.com/watch?v=o99zpLsM-ZI)

## Screenshots

[[Back to top]](https://github.com/tasdikrahman/spaceShooter#index)

| ![Screen 1](http://i.imgur.com/3MzfmbT.jpg) | ![Screen 2](http://i.imgur.com/4OgIByR.png) |
|---------------------------------------------|---------------------------------------------|
| ![Screen 3](http://i.imgur.com/PFQJjE8.png) | ![Screen 4](http://i.imgur.com/lV4aIur.png) |

## 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.

## Credits

The game is a fork of the video instructions given by KidsCanCode. I have made several additional enhancements to it. Do check out their [Channel](https://www.youtube.com/channel/UCNaPQ5uLX5iIEHUCLmfAgKg)!

## 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 | Donate via PayPal! |
|:-------------------------------------------:|:-------------------------------------------------------------:|
| Gratipay | Support via Gratipay |
| Patreon | Support me on Patreon |
| £ (GBP) | Donate via TransferWise! |
| € Euros | Donate via TransferWise! |
| ₹ (INR) | Donate via instamojo |