# README
Spaceship Game
This is a classic arcade-style game created in Go. In this game, players take command of a spaceship as it flies through a meteor shower. The goal is to protect the spaceship by destroying incoming meteorites while navigating to avoid collisions.
Game Start
Linux
- Download a zip file
spaceship-linux-latest.zip
from a release page. - Unpack the downloaded archive
- Open your terminal
- Run the game
$ <path-to-unpacked-folder/spaceship.exe
If everything works fine, a console will display a game screen. Use the arrow keys to move and press the space key to shoot.
Windows
A Windows version struggles with perfomance issues that affect the gaming experience. However, you can still launch the Windows version by following these steps:
- Download a zip file
spaceship-windows-latest.zip
from a release page. - Unpack the downloaded archive
- Run cmd.exe or Windows PowerShell
- Run the game
For example, if the game was unpacked to<path-to-unpacked-folder>\spaceship.exe
C:\Games\spacehip-windows-latest
, enterC:\Games\spacehip-windows-latest\spaceship.exe
and pressEnter
. To exit, pressEscape
.
If everything works fine, a console will display a game screen. Use the arrow keys to move and press the space key to shoot.
Development
Prerequisites
Go v.1.20 should be already installed.
Installing
Open a project root directory in a console and install project dependencies:
go mod tidy
Quick Start
Run the game:
go run main.go
If everything works fine, a console will display a game screen.
Tests
Run the project tests:
go test ./...
Additional Info
You can collect logs and cpu profile info in a file.
go run main.go --debug true --log_file=spaceship.log --cpuprofile=cpu.out
Acknowledgements
The inspiration for this project comes from a Python developer course at dvmn.org.
License
This project is licensed under the GNU GPLv3 License - see the LICENSE file for details