Bluesky ++ help manual
Version 1.2.0
General informations :
Bluesky++ is a free cross-platform shoot'em-up game made by Francois Braud alias phrounz. This game is freeware, so modify it and distribute it !
The game is protected by a Creative Commons License.
This is my first C++ game, so be indulgent :-)
Game instructions (Linux) :
You must :
- unzip the folder (with unzip if you use a terminal)
- launch a terminal (for example Konsole)
- go in the game folder ("cd the-folder-of-the-game")
- launch the script which launch the game (./bluesky.sh)
IMPORTANT !
- In the linux Mandrake 8.2 distribution, the game must be launched from a terminal.
- In the linux Mandrake 10 distribution, the game must be launched from a terminal, or from Konqueror (v 3.2.0).
- You must launch the "bluesky.sh" script and not the program "gamelinux".
Game instructions (Windows) :
You must :
- unzip the folder
- open the game folder
- execute bluesky.exe
Required configuration (estimation) :
- ~ 3,5 MB d'espace disque disponible.
- Linux with X11, or Windows (98 to XP).
- 400 Mhz CPU or better for Linux, or 1 Ghz or better for Windows (yes I know it is really a not fully optimized game). If the game is low, change the game speed in the options, and launch it with a smaller screen mode.
- 10 MB RAM, in addition of what is required for the operating system.
Command arguments :
The script can takes one optional argument, which can be :
- 400x300w
- 640x480w
- 800x600w
- 640x480f
- 800x600f
- 1024x768f
- 1280x768f
- 1280x1024f
This argument define the screen mode, and define if the game is fullscreen mode or not. Without argument, the game is 1024x768f. If the fullscreen mode doesn't work, the program will be launched in windowed mode.
Source code informations :
To compile, you must have the allegro library.
data/ contains all the images (loaded at the beginning of the game with the init_all() function).
Modules list :
bluesky.cpp : main file.
common : Contains utilitary functions, settings, etc ...
common.h is included in all .cpp files.
global : Contains the great game functions.
This module is an intermediate file between bluesky.cpp and the classes.
global.h is included in almost all .cpp files.
inventory : About the bonus inventory (at the top-left of the screen in the game).
The "classes" folder contains modules with one classe by module :
- menubox : menu box
- player : player ship
- ship : baddy ship
- proj : projectile
- explosion : explosion
- bonus : bonus (life bonus,atomic projectile)
- other : other (cloud)
For all of these classes (except menubox), for example if you want to add a new element in the "foo" class, you must modify the defines and constants at the top of foo.cpp, and add the image in init_class_foo.
To create a bonus, you must add the consequences this bonus will do in global_use_inventory_bonus(int index_player) in global.cpp.
To create a menubox, you must define the items in menubox::print_items(void) and write the consequences of clicking on these items in menubox::execute(int). A menubox is identified by its title.
Making informations :
Done on Linux Mandrake 8.2 (on Kde 2.2.2) with :
Gimp 1.2
Konsole 1.0.2
g++
Allegro 4.0.3
Standard library modules
Compiled on Windows XP, with Dev-Cpp 4.9.9.0 and allegro 4.2.0 beta 3.
Windows XP has been useful to the image making, with :
Photoshop 7.0
TheGamesFactory drawing editor
3DSMax for 3D images
And maybe other programs ...
Existing bugs :
- Maybe you must launch the game from a terminal if you are on Linux.
- Some ships stay at the top of the screen, and doesn't want to go down.
- The windows compilation display a lot of awful Warnings (but the game works :-) ).
- The menu boxes can extend beyond the limits of the screen, in 400x300 and 640x480 screen mode.
(There is no sound in the game, it is normal.)
Mail-me at the adress (see at the top) if you find other bugs.