Manuel d'aide de Bluesky ++
Version 1.2.0
Informations générales :
Bluesky++ est un jeu de shoot multi-plateformes créé par Francois Braud alias phrounz. Ce jeu est freeware, modifiez-le et distribuez-le !
Ce jeu est protégé sous un contrat Creative Commons.
Ceci est mon premier jeu en C++, alors soyez indulgent :-)
Instructions pour jouer (Linux) :
Pour jouer à ce jeu, il faut :
- le dezipper (avec unzip si vous utilisez un terminal)
- lancer un terminal (par exemple Konsole)
- aller dans le dossier du jeu ("cd le-dossier-du-jeu-depuis-votre-dossier")
- lancez le script qui lance le jeu (./bluesky.sh)
IMPORTANT !
- Dans la distribution linux Mandrake 8.2, le jeu ne peut se lancer qu'à partir d'un terminal.
- Dans la distribution linux Mandrake 10, le jeu ne peut se lancer qu'à partir d'un terminal, ou bien à partir de Konqueror (v 3.2.0).
- Il faut lancer le script Bluesky.sh et pas le programme gamelinux.
Instructions pour jouer (Windows) :
Pour jouer à ce jeu, il faut :
- le dezipper
- ouvrir le dossier du jeu
- executer bluesky.exe
Configuration nécessaire (estimation) :
- Environ 3,5 Mo d'espace disque disponible.
- Linux avec X11, ou bien Windows (98 à XP).
- Un processeur 400 Mhz ou superieur pour Linux et 1 Ghz pour Windows (oui je sais c'est aberrant pour un jeu en 2D, manque d'optimisation de ma part). Si le jeu rame, changer la vitesse dans les options, et lancez-le avec une résolution plus petite.
- 10 Mo de memoire vive pour le jeu (sans compter ce qu'il faut pour le système d'exploitation).
Arguments de la ligne de commande :
Le script peut prendre un argument optionnel, qui peut être :
- 400x300w
- 640x480w
- 800x600w
- 640x480f
- 800x600f
- 1024x768f
- 1280x768f
- 1280x1024f
Cet argument définit la résolution, et si le jeu est oui ou non en plein écran. Sans argument, le jeu est en 1024x768f. Si le plein écran ne marche pas, le programme se lancera en fenêtré
Informations sur le code source :
Pour recompiler, vous aurez besoin de la bibliothèque allegro.
data/ contient toutes les images (chargées au debut au moyen de la fonction init_all()).
Liste des modules :
bluesky.cpp : fichier principal.
common : Contient des fonctions utilitaires diverses, les settings, etc ...
common.h est include dans tous les fichiers .cpp.
global : Contient les fonctions importantes du jeu.
Ce module est l'intermediaire entre bluesky.cpp et les classes.
global.h est include dans presque tous les fichiers .cpp.
inventory : Gère l'inventaire des bonus (en haut a gauche de l'ecran dans le jeu).
Le dossier "classes" contient des modules qui sont des classes à part entiere :
- menubox : fenetre de menu
- player : vaisseau joueur
- ship : vaisseau ennemi
- proj : projectile
- explosion : explosion
- bonus : bonus (vie,projectile atomique)
- other : autre (nuage)
Pour toutes ces classes (sauf menubox), si vous voulez rajouter un nouvel élément de classe machin, il suffit souvent de modifier des defines et des constantes au debut du fichier machin.cpp, et de rajouter l'image dans init_class_machin.
Pour un bonus, il faut rajouter les conséquences de ce bonus dans global_use_inventory_bonus(int index_player) dans global.cpp.
Pour créer une menubox, il faut mettre des items dans menubox::print_items(void) et écrire les consequences de ces items dans menubox::execute(int). Un menubox est identifié par son titre.
Informations sur la réalisation :
Fait sur Linux Mandrake 8.2 (sur Kde 2.2.2) avec :
Gimp 1.2
Konsole 1.0.2
g++
Allegro 4.0.3
Modules de la librairie standard
Recompilé sous Windows XP, avec Dev-Cpp 4.9.9.0 et allegro 4.2.0 beta 3.
Windows XP a aussi servi a la réalisation partielle des images, avec :
Photoshop 7.0
L'éditeur de dessin de TheGamesFactory
3DSMax pour les images en 3D
Et peut-être que j'en oublie ...
Bibliothèques : allegro 4.0.3, et certains modules de la bibliothèque standard.
Bugs existants :
- Nécessaire de lancer le jeu depuis un terminal sur certains ordinateurs sous Linux.
- Certains vaisseaux ont tendance à rester en haut de l'écran, et à ne quasiment pas descendre.
- La recompilation sous Windows provoque plein de Warnings tout pas beaux (mais le jeu marche :-) ).
- Les fenêtres des menus peuvent déborder de l'écran en résolution 400x300 et 640x480.
(C'est normal qu'il n'y ait pas de son, je n'en ai pas mis.)
Mailez-moi a l'adresse ci-dessus si vous trouvez d'autres bugs.