Ecosyste.ms: Awesome

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

Awesome Lists | Featured Topics | Projects

https://github.com/viewizard/astromenace

Hardcore 3D space scroll-shooter with spaceship upgrade possibilities.
https://github.com/viewizard/astromenace

3d-game 3d-graphics action action-game arcade arcade-game game scroll-shooter shooter shooter-game

Last synced: 29 days ago
JSON representation

Hardcore 3D space scroll-shooter with spaceship upgrade possibilities.

Awesome Lists containing this project

README 

        
# AstroMenace



* [Installation (Windows, macOS, Linux)](https://github.com/viewizard/astromenace#installation)

* [Build (Windows)](https://github.com/viewizard/astromenace#build-windows)

* [Build (macOS, Linux, BSD)](https://github.com/viewizard/astromenace#build-macos-linux-bsd)



---



[AstroMenace on YouTube, a video is worth a thousand words.](https://www.youtube.com/watch?v=ysY9vKKisbo&index=1&list=PLrWi_GXhwHyznYT19oAQL4zNldlVXFlj2)



Immerse into a decisive battle against tons of cunning foes, face the terrifying bosses and protect your homeland throughout 15 diverse levels of the game. The hardcore gameplay of AstroMenace, packed with pure non-stop action, will become a full scale test for your basic instinct of survival.





  preview




The game provides a wide variety of armaments and weapon upgrades for discharging the retributive wrath upon the hordes of enemies, besides it has a great number of improvements for enhancing the defensive abilities of your spaceship. Collect money during the combat and invest them into turning your spaceship into an ultimate weapon of mass destruction.





  preview




More information and screenshots could be found at [AstroMenace website](https://viewizard.com/).



## Installation



Installer for Windows could be found in [Releases](https://github.com/viewizard/astromenace/releases).



Almost all popular Linux distros already have a stable version of the game in their repositories. Install the "astromenace" package with your distro's package manager. We do not provide packages for any Linux anymore, contact maintainers of your Linux distro.



[![latest packaged version(s)](https://repology.org/badge/latest-versions/astromenace.svg)](https://repology.org/metapackage/astromenace) [![Packaging status](https://repology.org/badge/tiny-repos/astromenace.svg)](https://repology.org/metapackage/astromenace)



#### Debian/Ubuntu and derivatives

```

sudo apt-get install astromenace

```



#### OpenSuse

```

sudo zypper install astromenace

```



#### Fedora

```

sudo yum install astromenace

```



#### Gentoo

```

sudo emerge astromenace

```



#### FlatPak

AstroMenace is also available as a [FlatPak](https://flatpak.org) package from

[FlatHub](https://flathub.org/apps/com.viewizard.AstroMenace).



## Build (Windows)



- Install MSYS2 from https://www.msys2.org (follow step-by-step instruction on first page in order to install MSYS2)



**For Windows 32bit build.** Start `MSYS2` > `MSYS2 MINGW32` terminal session from `Start` menu. Install all necessary packages and download prebuilt dependencies:

```

cd ~/

```

```

pacman -S git unzip mingw-w64-i686-{toolchain,make,cmake,ninja}

```

```

wget https://github.com/viewizard/astromenace-windows-prebuilt-dependencies/releases/download/latest/prebuilt_dep_mingw_32bit.zip

```

```

unzip ./prebuilt_dep_mingw_32bit.zip

```

**For Windows 64bit build.** Start `MSYS2` > `MSYS2 MINGW64` terminal session from `Start` menu. Install all necessary packages and download prebuilt dependencies:

```

cd ~/

```

```

pacman -S git unzip mingw-w64-x86_64-{toolchain,make,cmake,ninja}

```

```

wget https://github.com/viewizard/astromenace-windows-prebuilt-dependencies/releases/download/latest/prebuilt_dep_mingw_64bit.zip

```

```

unzip ./prebuilt_dep_mingw_64bit.zip

```



- Clone git with latest source files

```

git clone https://github.com/viewizard/astromenace.git

```

- Compile game binary (game data file will be created automatically):

```

mkdir ~/astromenace/build

```

```

cd ~/astromenace/build

```

**For Windows 32bit build:**

```

cmake .. -G Ninja -DCMAKE_INSTALL_PREFIX=$PWD/../bin -DCMAKE_BUILD_TYPE=Release -DDEPS_PATH=$PWD/../../prebuilt_dep_mingw_32bit

```

**For Windows 64bit build:**

```

cmake .. -G Ninja -DCMAKE_INSTALL_PREFIX=$PWD/../bin -DCMAKE_BUILD_TYPE=Release -DDEPS_PATH=$PWD/../../prebuilt_dep_mingw_64bit

```

```

cmake --build . --target install

```

- Create desktop shortcut or start AstroMenace

```

~/astromenace/bin/astromenace

```

Note, in case of default MSYS2 path, all AstroMenace binary files will be stored into folder `C:\msys64\home\user\astromenace\bin`. You can copy this files into folder you want and remove MSYS2 from your system.



## Build (macOS, Linux, BSD)



Build dependencies:

libSDL2 (ver 2.0.5+), libopenal (ver 1.0+), libalut (ver 1.0+), libogg (ver 1.1+), libvorbis (ver 1.1+), freetype (ver 2.1.6+)



The easy way to get up to date AstroMenace on your computer:



### 1) Make sure all necessary packages with development headers installed in your system: 



gcc or clang or any compiler with full [ISO/IEC 14882:2011 (C++11)](https://www.iso.org/standard/50372.html) support, cmake, make, git, libsdl2, libogg, libvorbis, openal, alut (freealut), freetype2



#### For macOS:

Download and install "Command Line Tools for Xcode" or "Xcode".

Install HomeBrew package manager: https://brew.sh/

```

brew install ninja cmake sdl2 git libogg libvorbis freealut freetype

```



#### For Ubuntu/Mint/Debian:

```

sudo apt-get install g++ cmake make ninja-build libsdl2-dev libogg-dev \

git libvorbis-dev libopenal-dev libalut-dev libfreetype6-dev

```



#### For Mageia:

```

sudo urpmi gcc-c++ ninja cmake make git libsdl2.0-devel libogg-devel \

libvorbis-devel libopenal-devel libfreealut-devel freetype2-devel

```



#### For OpenSuse:

```

sudo zypper install gcc-c++ ninja cmake make libSDL2-devel libogg-devel \

git libvorbis-devel openal-soft-devel freealut-devel freetype2-devel

```



#### For Fedora:

```

sudo yum install gcc-c++ cmake make git SDL2-devel libogg-devel libvorbis-devel \

ninja-build openal-soft-devel freealut-devel freetype-devel linux-libertine-fonts

```



#### For FreeBSD:

```

sudo pkg_add -r -v gcc cmake git ninja sdl20 libogg libvorbis openal freealut freetype2

```



### 2) Clone git with latest source files

```

cd ~/

```

```

git clone https://github.com/viewizard/astromenace.git

```



### 3) Compile game binary (game data file will be created automatically)

```

mkdir ~/astromenace/build

```

```

cd ~/astromenace/build

```

```

cmake .. -G Ninja -DCMAKE_INSTALL_PREFIX=$PWD/../bin -DCMAKE_BUILD_TYPE=Release

```

```

cmake --build . --target install

```



### 4) Create desktop shortcut or start AstroMenace

```

~/astromenace/bin/astromenace

```