invaders/README.txt

#==Space Invaders==
#
#Original game was created and developed by Giacomo Parolini and Enrico Guiraud (year 2010-2011)
#License: GNU GPLv3
#
#Avaiable game versions:
# -invaders2.0
# -invaders2.1
# -invaders3.0
# -invaders3.1
# -invaders3.2
# -invaders3.3
# -invaders3.4
# -invaders3.5
# -invaders3.6
# -invaders4.0
# -invaders4.1
# -invaders4.2
# -invaders4.3
# -invaders4.3.5
# -curses_invaders2.0
# -curses_invaders3.0
# -curses_invaders3.5
# -curses_invaders4.0
# -curses_invaders4.1
# -curses_invaders4.2
# -curses_invaders4.3
# -GL_invaders
#
#All versions are written in C++. 
#
#curses_invaders versions were developed by Giacomo Parolini and differ from the previous ones for exploiting library <ncurses.h> for graphic terminal management.
#GL_invaders versions were developed by Enrico Guiraud and exploit GL libraries such as <glutm/window.h> and <glt/project.h> for graphics.
#
#System Requirements:
#All versions are Linux x-executable files, so will only run within Linux environment.
#However, files CAN be compiled also in MacOS environment.
#
#GL_invaders versions require GLT libraries in order to be compiled and run.
#note that the macro GLT_DIR in GL_invaders's makefile refers to a specific folder, therefore, if you want to compile the game on your computer, you'll need to match the correct destination for macro GLT_DIR!
#
#curses_invaders versions require the library <ncurses.h> and may not work correctly on some terminals. Versions 3.0 and following also contain executable "bossrush".
#
#curses_invaders4.0 and following include the <pthread.h> library (used for executing sounds and music). Sound and music work only in terminals with command "beep".
#
#since v.4.3, game controls are customizable at the beginning of the game.
#
#Other: header files are *.hpp and implementations are *.cpp.
#
#Makefile includes the following dummy macros:
# -open: opens all source files
# -openhpp: opens all header files
# -opencpp: opens all implementations
# -clean: removes all objects
# -cleanall: removes all objects and executable
# -remake: removes previous objects and compiles
#
#CREATING AND EDITING BOSSES
#curses_invaders4.0 and following also come with the scripts checkboss.sh and setboss.sh, written by Enrico Guiraud. These scripts are used to edit the five game bosses, allowing the player to create his custom bosses. 
#In order to create a boss, follow these steps:
# *1: create a file named <custom_boss_name>.dat and open it with any text editor (like Gedit, Vim or Notepad).
# *2: "draw" your boss in ASCII-style. You don't have to pay attention of the rows' lengths, as checkboss.sh will fix them automatically. Just be sure the lines and the columns fit the game board (game board's dimensions are written in definitions.hpp as "R" and "C").
# *3: save your file.dat and launch either checkboss.sh (if you just want to adjust your boss's dimensions) or directly setboss.sh (to add the boss to the game). Syntax of checkboss.sh is "./checkboss.sh <bossname.dat>" or "./checkboss <bossname>". Syntax of setboss.sh is "./setboss.sh <bossname> <level>"; the script will substitute the boss of the <level>-th game level (1=easy, 2=medium, 3=hard, 4=impossible, 5=special boss) with your custom boss. Notice that setboss.sh needs you to pass the argument WITHOUT the ".dat".
# *4: play to test your new boss! If you want to restore the original boss, just run setboss.sh once again passing the original boss as argument.


#...and yes: cheats ARE available, just try and find them ;)