README.md
1# AstroMenace [](https://travis-ci.org/viewizard/astromenace)
2
3* [Installation (Windows, macOS, Linux)](https://github.com/viewizard/astromenace#installation)
4* [Build (macOS, Linux)](https://github.com/viewizard/astromenace#build)
5* [Translators Wanted](https://github.com/viewizard/astromenace#translators-wanted)
6* [Work In Progress](https://github.com/viewizard/astromenace#work-in-progress)
7* [Donate to Support Development](https://github.com/viewizard/astromenace#donate-to-support-development) [](https://github.com/viewizard/astromenace#bitcoin-14kdalnntroffuur2tzmudup8ek3ps2uq6) [](https://github.com/viewizard/astromenace#paypal-httpswwwpaypalmeviewizard)
8
9---
10
11[AstroMenace on YouTube, a video is worth a thousand words.](https://www.youtube.com/watch?v=ysY9vKKisbo&index=1&list=PLrWi_GXhwHyznYT19oAQL4zNldlVXFlj2)
12
13Immerse 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.
14
15<p align="center">
16 <img src="./share/preview1.png" alt="preview"/>
17</p>
18
19The 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.
20
21<p align="center">
22 <img src="./share/preview2.png" alt="preview"/>
23</p>
24
25More information and screenshots could be found at [AstroMenace website](https://viewizard.com/).
26
27## Installation
28
29Installer for Windows and macOS bundle could be found at [release](https://github.com/viewizard/astromenace/releases) section.
30
31Almost 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 compiled binary packages for Linux anymore, contact maintainers of your Linux distro in order to get binary package.
32
33[](https://repology.org/metapackage/astromenace)
34[](https://repology.org/metapackage/astromenace)
35
36#### Debian/Ubuntu and derivatives
37```
38sudo apt-get install astromenace
39```
40
41#### OpenSuse
42```
43sudo zypper install astromenace
44```
45
46#### Fedora
47```
48sudo yum install astromenace
49```
50
51#### Gentoo
52```
53sudo emerge openastromenace
54```
55
56## Build
57
58Build dependencies:
59libSDL2 (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+)
60
61
62The easy way to get up to date AstroMenace on your computer:
63
64### 1) Make sure all necessary packages with development headers installed in your system:
65
66gcc 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
67
68#### For macOS:
69Download and install "Command Line Tools for Xcode" or "Xcode".
70Install HomeBrew package manager: https://brew.sh/
71```
72$ brew install cmake sdl2 git libogg libvorbis freealut freetype
73```
74
75#### For Ubuntu/Mint/Debian:
76```
77$ sudo apt-get install g++ cmake make git libsdl2-dev libogg-dev \
78 libvorbis-dev libopenal-dev libalut-dev libfreetype6-dev
79```
80
81#### For Mageia:
82```
83$ sudo urpmi gcc-c++ cmake make git libsdl2.0-devel libogg-devel \
84 libvorbis-devel libopenal-devel libfreealut-devel freetype2-devel
85```
86
87#### For OpenSuse:
88```
89$ sudo zypper install gcc-c++ cmake make git libSDL2-devel libogg-devel \
90 libvorbis-devel openal-soft-devel freealut-devel freetype2-devel
91```
92
93#### For Fedora:
94```
95$ sudo yum install gcc-c++ cmake make git SDL2-devel libogg-devel libvorbis-devel \
96 openal-soft-devel freealut-devel freetype-devel linux-libertine-fonts
97```
98
99#### For FreeBSD:
100```
101$ sudo pkg_add -r -v gcc cmake git sdl20 libogg libvorbis openal freealut freetype2
102```
103
104### 2) Clone git with latest source files
105```
106$ cd ~/
107```
108```
109$ git clone https://github.com/viewizard/astromenace.git astromenace
110```
111
112### 3) Compile game binary (game data file will be created automatically)
113```
114$ cd ~/astromenace
115```
116```
117$ cmake -DCMAKE_BUILD_TYPE=Release ./
118```
119```
120$ make -j5
121```
122
123### 4) Create desktop shortcut or start AstroMenace
124```
125$ ~/astromenace/astromenace
126```
127
128## Translators Wanted
129Please help us make AstroMenace more friendly and clear for all gamers.
130
131AstroMenace localization now supported by Crowdin https://crowdin.com/project/astromenace.
132
133Don't hesitate to create [issue](https://github.com/viewizard/astromenace/issues), if you have questions or you need help.
134
135## Work In Progress
136Yes, AstroMenace was first released in 2007, but work still in progress. For open source game, no need to change game's title in order to evolve.
137
138The main goal now is code refactoring for modern OpenGL features and new C++ standards (C++11, STL). Plus, I still provide AstroMenace code support, that means changes for new libs versions and new compilers versions.
139
140Unfortunately, I could not provide you with any new version's release dates, since this is extremely depends from my free time and limited resources. Check project's [plans](https://github.com/viewizard/astromenace/projects) for more info about current progress.
141
142We also have a surprise for you, here is the artwork 1 of 12 light ships and 1 of 8 capital ships we already have, with best wishes from Oleg Linkov (3D models author). Since this is ours 3D models, we will release sources under GPLv3 in [astromenace-artwork](https://github.com/viewizard/astromenace-artwork) repository as soon, as AstroMenace will use them. I hope, some day we will replace all 3D models licensed under CC-BY-SA (without sources) to open source 3D models.
143<p align="center">
144 <img src="./share/wip/scout.png" alt="preview"/>
145</p>
146<p align="center">
147 <img src="./share/wip/heavy.png" alt="preview"/>
148</p>
149
150## Donate to Support Development
151#### Bitcoin: 14kDaLnNTroFfuur2tZmUdUp8eK3pS2Uq6
152<p align="left">
153 <img src="./share/donate/bitcoin-qr-code.png" alt="bitcoin-qr-code"/>
154</p>
155
156#### PayPal: https://www.paypal.me/viewizard
157
){kind=link}
){kind=link}
){kind=link}
){kind=link}
){kind=link}
