jes-bro / captain_forever

Welcome to Captain Forever

Conquer the infinite expanse of space and become the ultimate Captain Forever!

The big idea

Captain Forever is an exhilarating spaceship adventure game that transports you, the captain, into the role of an interstellar pilot on a mission to evade and destroy formidable enemy ships. In the midst of a cosmic field, you'll navigate a single spaceship while facing flying enemy ships that pursue and attempt to destroy you. If you take too many hits, you will explode! Your objective is to strategically shoot and annihilate them, all while avoiding collisions and dodging counter-fire. If you can destroy all of the enemy ships before reinforcements appear, you win!

Specifications

• This game uses Python 3.10.11 64-bit (Microsoft Store).
• We developed the software on Windows or in an Ubuntu VM for windows in the VSCode IDE.

Necessary Packages

This game uses Python 3.10.11 64-bit (Microsoft Store). We can only guarantee that this game work with this Python version.

To start, please ensure that you have this version of Python installed and that you are using the Python 3.10.11 interpreter in your IDE of choice.

Use pip3 to install PyGame with the following command. It's the only external Python library we use outside of pytest for unit testing. Please install it for your Python 3.10.11 version.

python3 -m pip install -U pygame --user

If you would like to run test files, please use the following command to install Pytest:

pip3.10 install pytest

Setup Instructions

To install this game locally, clone this repo into the directory of your choice. Then, cd into that directory, and then into the captain_forever directory, where main.py lives. To run the game, use the following command in your terminal:

python3 __main__.py

Gameplay

• Use up and down arrows to translate forwards and back, respectively. Use right and left arrows to rotate clock-wise and counter-clock-wise, respectively.
• To quit, press escape or close the PyGame window with the demarked button in the upper-right-hand corner of the window.
• To restart the game, once you have won or lost, press enter or return.