Bombermaaan Readme

Copyright

Bombermaaan is ...
Copyright (C) 2000-2002, 2007 Thibaut Tollemer
Copyright (C) 2007, 2008 Bernd Arnold

License

Bombermaaan is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.

Bombermaaan is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with Bombermaaan.  If not, see <http://www.gnu.org/licenses/>.

Introduction

This is a version of Thibaut's Bombermaaan game project which started on July 2000. He didn't develop this project in order to bring new concepts of gameplay or to make the best Bomberman game ever but to increase his programming skills and have a game project he can show to be hired.

History

This program is still, and will always be under development. You can check the latest history of this project by browsing its website. You'll be informed of what was changed, fixed, added, and removed in each version.

System requirements

This program has been tested under Windows 95 OSR2, 98 PE/SE, 2000 and XP. And Debian unstable on an i386 and an amd64 machine.

It requires DirectX 7.0 or later to run. It is recommended you set your display to at least 16 bit color depth. A sound card is recommended. In Linux the SDL library as well as SDL_mixer 1.2.7 or higher is required.

Parameters and switches

When Bombermaaan is called without a command line parameter (started with mouse click for example), the game fetches level files from the directory <path-to-exe-file>\Levels. The configuration file named config.dat and log file named log.dat are read and/or written in the same folder where the called exe file resides.

Since some Windows systems (Vista for example) don't allow the creation of files in the program's directory, Bombermaaan was modified so the dynamic files (config.dat and log.dat) are handled in a subfolder of the user's application data folder.
You can use echo %appdata% in the command line to see where your application folder is placed. Bombermaaan creates a subfolder called "Bombermaaan". You can browse to this folder by running %appdata%\Bombermaaan or typing start "%appdata%\Bombermaaan" in a command line window.
This behaviour is NOT enabled by default.
To enable the use of your %appdata% folder, append --use-appdata-dir when calling the Bombermaaan exe file.
Users can store their own level files in the %appdata%\Bombermaaan\Levels directory. These files are also loaded as level files. So there is no need to touch the program files directory. Remember: this behaviour is enabled when the --use-appdata-dir parameter is used.

You can call Bombermaaan with the --help switch to see a message box with copyright and license notice.

Controls

During a match :
- Here are the configurations :
  Keyboard 1 (Default) : 8/5/4/6 + PageUp/Home
  Keyboard 2 (Default) : R/F/D/G + 2/1
  Joystick X (Default) : Up/Down/Left/Right + Button1/Button2
- On your configuration :
  - Up/Down/Left/Right : make your bomber move
  - Action 1 : drop a bomb if possible,
               or lift the bomb you are onto.
               hold Action 1 to hold the bomb.
               release Action 1 to throw the bomb.
  - Action 2 : stop a bomb you kicked that is still rolling,
               or punch a bomb that is right in front of you.
- Escape : pause the match and make the menu box appear
- P : pause or resume

In the menu screens :
- Up/Down............... : select another field to modify
- Left/Right............ : change value of current field
- Backspace............. : previous screen
- Return/Space bar/Enter : next screen

In the menu box :
- Arrows................ : change between yes or no
- Return/Space bar/Enter : validate choice
- Escape................ : make the menu box disappear and resume the match

Anywhere in the game :
- F1...... : set 320x240 display mode
- F2...... : set 512x384 display mode
- F3...... : set 640x480 display mode
- F4...... : set windowed display mode
- Ctrl+F12 : quickly exit the game without confirmation

Please note that the display mode you chose may
be unavailable on your computer. The program will
not change the display mode if this one is
unavailable.

Additional information

The Bombermaaan project is hosted on SourceForge.net.

News

May 2008: Released version 1.3.

December 2007: We're putting the source files into sourceforge.net's subversion repository. This step isn't completed yet, so you won't find all the files there at the moment. Also we are writing a how-to guide you can use if you want to compile Bombermaaan on your own.

Check http://bombermaaan.sourceforge.net/ for the latest news.