Skip to content

A multi directional multi platform retro scrolling shooter written in Go

License

Notifications You must be signed in to change notification settings

Retro-Carnage-Team/retro-carnage

Repository files navigation

Go Bugs Code Smells Vulnerabilities Security Rating Maintainability Rating Technical Debt

RETRO CARNAGE

The goal of this project is to take you back to the best part of your childhood. To do this, we are building a modern multidirectional scrolling shooter. Once finished, Retro-Carnage is going to be a worthy successor of classic video games like Ikari Warriors by SNK, War Zone by Core Design, or Dogs of War by Elite Systems.

This game is currently in development and not ready to get played, yet.

Watch the video Development status as of 2024-10-13

Getting the latest release

You can find the latest builds for various platforms on the downloads page.

Run the game

  • Download the application archive for your platform
  • Unzip the application archive
  • On Linux only: make application executeable chmod +x retro-carnage
  • Double click on application or use terminal to run .\retro-carnage in application folder

Getting Started

Prerequisites

All platforms

First of all, you should install the necessary tools on your computer to be able to work with the source code. You will need git and Golang. Some scripts that make development easier are written in PowerShell. PowerShell is already installed when you're running Microsoft Windows. With Linux you still need to install PowerShell if you want to use the scripts - but this is optional.

On Ubuntu

Install the required libraries:

sudo apt-get install -y libgl1-mesa-dev xorg-dev libasound2-dev

On Fedora

Install the required libraries:

sudo dnf install libXcursor-devel libXrandr-devel libXinerama-devel libXi-devel mesa-libGL-devel xorg-x11-server-devel alsa-lib-devel libXxf86vm-devel

On Windows

Install tdm-gcc so that various go-bindings can be compiled. A installation with default option will do fine.

Installing

Get the code and assets

git clone https://github.com/Retro-Carnage-Team/retro-carnage.git
git clone https://github.com/Retro-Carnage-Team/retro-carnage-assets.git

Change into the src directory, install required modules, compile the application

cd retro-carnage
go get -d
go build

Start the game

./retro-carnage ../retro-carnage-assets

The repository contains IDE settings for Visual Studio Code to debug, run, and test the game.

Running the tests

Run the steps to install the development environment first (see previous chapter). Open a terminal, navigate into the application folder and run the test script:

pwsh ./test.ps1

asciicast

Authors

License

This project is licensed under the MIT License. See the LICENSE.md file for details.

Acknowledgments

This game is based on the work of many great artists who share their work free of charge. See the ATTRIBUTION.md file for details.