***********************************************************************************
				BOMBER Version 1.0 ALPHA
 				 Designed for Fargo II
	
				 By Christophe FONDACCI

			      & gfx by Noah S Zoschke
************************************************************************************


I strongly recommend you to have good batteries. Indeed, I came to the conclusion
that the grayscales were better (no flickering), the screen wasn't disturb by
constrast changes due to the grid levels create, and the game is also a lot faster !

1- Requirements
---------------
	* You need a TI-92 to play bomber (rom 1.x or 2.1 or +)
	  or TIGER v0.7 or later
	  TI92 Plus is also supported !!!

	* You need fargo installed on your calc (v0.2.7 is strongly recommended)
	or PlusShell if you are using a + module.
	* You need FLIB.92P, GRAPHLIB.92P, GRAY4LIB.
	 (all included in the ZIP-file)
	or UTIL.9XZ, GRAPHLIB.9XZ, GRAY4LIB.9XZ for the +

	* You need BOMBER.92p (Main prog) and BMBLVLS.92P (levels & sprites)
	(respectively : BOMBER.9XZ and BMBLVLS.9XZ)
	* You need at least about 24Kb free to store bomber and its lib, but no more
	  to play. Since most options have already been added, the size of the
	  prog may not change very much...

NOTE : For the + you will need about 28 ko to install Bomber and its lib.


	I am not responsible of any dammage that this game can cause to your
	Calc (remember that when your calc crash, put the batteries off, press
	(-) and ), and insert the batteries). You use this software at your own 
	risks.

This game has been successfully tested with a rom 2.1 calc and with a 1.12 rom
on Tiger. Please report me about the Bomber+ version cause I was not able to test
it yet !
If you can report me if the speed is good on a 1.x calc, it would be great (Tiger
is slower than the calc, so...)

This game has been optimized (in speed) for Rom 2.1 !

2- The Game
-----------
	Bomber is a version of  the famous PC (and nintendo) game who everybody
knows (I think): Dyna Blaster or BOMBERMAN (similar games). In Battle mode, you
can only play with 2 players and you must kill the other one with your bombs.
In 1P game, you are alone and you must find a hidden exit behind the bricks,
be careful : there are many monsters !!

Battle Game :
=============
  Enter the battle mode game, it is a 2-player game where you need to kill the 
other player.

1P game : 
=========
  It stands for 1-player level : here, you can't choose your level, you must find
a hidden exit door to complete the level, but monsters are here to kill you, and
the time is against you !!

Resume Game :
=============
  Use it to restore the previous exited game (you can exit a game by pressing ESC,
it will automatically save the current game). If no game is in memory, then it will
do nothing. If you start a new game after exiting one, it will erase the previous
saved game.

Select Level : 
==============
  Here you can choose the level in which you will play in Battle mode. You can choose
between a random level (1st one), and built-in levels or custom ones (made for 1P game).
You can also select your sprite set using the up & down arrows.
When you select a level, you will also be able to select a 1P game level, but it might
be not very interesting to play to that kind of levels. The battle levels are just after
all the 1P level, I'm sure you will recognize them (they are often symetric, there are
not many monsters, and generally a big area to play !)

Redefine Keys :
===============
  You can choose your own keys to play Bomber, just enter this menu and strike the
requested keys. The key definition is now very SPEEDY !
  You must redefine all keys when you enter this menu (Warning, no Cancel is allowed)

On-Line Help
============
	It explains what the different bonuses are doing and the kinds of monsters, for
those of you who don't know what to do in 1P game, it is also written !

Reset victories :
=================
  In battle mode, each time a player dies, it increases the victory counter of the
other player so you can choose the number of victories you want. At any time, you
can reset those counter by selecting this option !


Main Differences between this game and the PC game :
-----------------------------------------------------
	* You can put all the bombs you have by not releasing Fire key when
	you drop a bomb : all the bombs you have will be dropped as soon as
	a place is available !
	* Once flames appear, you can walk on them : the death detection is
	only made when the bomb is triggered, but the flames stay a little
	more time, and during this time you can walk safely on them !
	(it could be considered as a bug, yes !)

3- Keys
-------
Player 1 : The pad to move and enter to put a bomb.
Player 2 : 	W	UP		(TEMPORARY)
		X	DOWN
		A	LEFT
		D	RIGHT
		Space	BOMB

You can redefine the keys inside the game so don't worry if you don't like 
these commands...

You can't see the keys you have selected so be very careful, but if you don't
see a message like "Key not found !", then it is ok !
Note that the first player is the one at the left and the 2nd is the one at the
right of the screen.

4- Known Bugs
-------------

Well, at the moment, Beta-testers are working on finding bugs, I have fixed
all the bugs I had seen.

Recently fixed bugs :
	- A row was missing in the keyboard matrix scanning, so the arrows
	were not available, this is now OK !

=============================================================================
Since I was short in time, some features are not included in this package :
	* You will never be blocked by the bombs, you can walk over them !
	* Some options has not been added, and some bugs remains...
=============================================================================

5- Next features
----------------
	* I am currently making my own Sprite Functions (with the help of Thomas
	Fernique). It will then remove the need of Graphlib, the sprites will no
	more flicker, it will alow bonuses like "Walk on walls" and monsters
	going through walls, and last but not least, it will reduce the size of
	bomber very much !
	Since the routines are not working properly right now, the next release
	will not be ready soon ! (the school also restart !)
	* I will optimize my code a lot : it is very big for what it did and I must
	first reduce the size of the prog and even with the sprite functions, it will
	not be enough. But note that the game doesn't require any extra memory while
	playing !
	* Some of you asked me to create more intelligent monsters, but it's quite
	hard ! If someone has got an idea, or knows how to make them quite intelligent
	(but not too much !), please tell me !
	* A high score for the 1P game !
	* A link-game to play with 2 ti-92 (this would be great, but very hard)
	* Always more kind of bonuses !!

The next features will only be implemented once all bugs are fixed.
I will try to make this game as close as possible to the PC version (perhap's better).

6- Special Thanks
-----------------
	- TO DAVID ELLSWORTH for fargo and all his work for the 92...
	- TO JIMMY MARDELL for his great 68kguide and all his sources/routines...
	- TO THE DOORS TEAM for the excellent graphlib and because I speak to them 
	everyday on ICQ and they encouraged me very much ! (Merci  toi Xav)
	- To NIKLAS BRUNLID for answering my stupid questions about interrupts !
	- TO THOMAS FERNIQUE for his very good french sources, and for his help
	on the sprite routine (even if I will make different ones, I have understood
	a lot of things !)
	- TO HUGO BERNABE who send me reports for each Beta-version, and for
	his pertinent suggestions & for his support.
	- TO BENOIT SCHERRER for Fargo Program Editor (Which is a little buggy but 
	that's great !)
	- TO Lyce la martinire MONPLAISIR and mostly the MPSI1 97/98 for 
	their support (bonne chance  vous pour la MP* !)
	- TO every player of Bomber : Thank you !

6 Bis - Beta testers
--------------------
To all of you who have helped me making this game by testing it, thanks !
Here are their names :
	- Hugo Bernab
	- Jimmy Monin (also for his great site & PUD on Bomber)
	- Florent Vernhes
	- Ludovic Mouhat (for a PUD on Bomber)
	- Bryan Rabeler (and also for his great TI-CALC site)
	- Thomas Fernique
	- Jared Nielsen
	- kty
	- MKWings
	- Michael Kristiansen
	- Others...
	

7- Contact the author
---------------------

Well if you want to speak to me, to send me comments, bugs, or suggestions,
I will answer to all questions...
Of course, I'm a student on holidays (until 15th september)

E-MAIL  : tchi_98@yahoo.com (this will change on september)
ICQ	: 12252327 (TCHI)

The ICQ may also change. I will communicate the new adresses as soon as I
know them on a92.

Concerning graphic suggestions, I think you could mail directly the graphist :
		Noah S Zoschke
		nzoschke@juno.com

8- Sources
-----------

	I know many of fargo programmers (beginners) love sources and want nice
quoted sources in every new game, but first I am a beginner as well and this
game is not very well-programmed. I will try to optimize my code, to debug this
game, and the sources won't be released until I have finished. So please wait...
this is just a pre-release ! 

I will perhaps never release the sources since it becomes quite complex now !
Moreover the sources take more than 100ko so it is quite big !
If you really want the sources you can still mail me !

9- History
-----------
I will only include in this section the releases on the net (Beta releases)
(I have made about 60 versions of this game which correspond to each stage
of developpement so...)

Thanks to your suggestions/bug reports, I have been able to add many options
and to fix many bugs !
	*v1.01 Beta - FIRST PUBLIC RELEASE !
		- No changes since the v1.01, I go back to school and I don't know
		when I will be able to continue to work on Bomber, since this release
		is already playable...
		- Even if it is not an update, I realized that Bomber requires no extra
		memory during the game (hopefully, because the game is quite huge right
		now ) !
		- Update Bomber.txt


	* v1.01 Bug fixing & options added (according to your suggestions) :
		- Fixed the score bug when a score was higher than 9 (battle mode)
		- Fixed the gameplay bug, that made the 2nd player die unfairly
		- Fixed the bug that allowed the 2nd player to drop bombs and to
		move, even if he was invisible, in 1P game ! (this gave me an idea...)
		- Added "Chain Explosions" : If a bomb exploses and if there is 
		another bomb in the flame's range, the first bomb will trigger
		the second 1 and so both will explose ! The game become more
		funny !
		- Enabled the ESC key on the main menu !
		- Added Mega-Bomb bonus : Nothing can stop it!!!! 
		- Added a mad monster : VERY FAST !
		- Added the famous Surprise Bonus : It can give you mini-flames,
		can make you dropping all your bombs, or give you any of the 3
		other bonuses (flames, bomb, mega-flame). Only Battle levels have
		the surprise bonus !
		- Improved the monsters : they are now more clever and they go where
		they want to ! The mad monster has not been included in this 
		improvement, he hardly ever change of direction !
		- Improved the Key Detection : it is now very fast ! (an error was
		found in the script, I apologize !)
		- Added a random exit door : several exit doors are allowed, the game
		will randomly choose one of them (the 1P game becomes more difficult ?)
		So you can't "remember" the place of the exit door !
		- Improved the game : It is now safer for your calc (less crashes), but
		it is not perfect :=(
		- Added new levels for both 1P & Battle, also upgraded old levels to the
		multiple exit function (DO NOT USE THE OLD BMBLVLS !!! else crash)
		- Updated Levels.txt with new functions !

	* V1.0 which will be very near from the soon-to-come public release !
Current	- v1.0 Well, it is quite good now, many options added :
		- Added built-in custom levels (External levels supported)
		- Added new set of sprites
		- Added grayscale graphics
		- Added Monsters
		- Added new graphics by Noah S Zoschke
		- Added a 1 player game (still under construction)
		- Added HTM system to guide you through the walls
		- Added a teacher key
		- Added flames on explosions
		- Added timer and limited time for 1P game !
		- Added a Resume Game option with a saved game (only 1 that's enough !)
		- Added a level-selector !
		- Fixed the "time is up" flag.
		- Improved the flames : also managed by auto-int5, so the game is
		smooth and you can see real flames !
		- Changed the way bomb-timers are made. They are now managed by the
		auto-int 5, so that the bomb delay is always the same !
		- Improved the Redefine keys option (there were some conflict between
		  keys), but it is still very slow (It is not my fault, the keyboard
		  matrix is huge !!!)
		- Fixed the Redefine Keys option : a row was not scanned in the keyboard
		matrix.
		- Separate levels in another file so you can make your
		own levels (an editor will be released soon for Win95)
		- Fixed bugs on bombs

	- v0.9 Delta
		* Fixed an "Illegal Instruction Bug" on victory.
		* Add a "Redefine Keys" option in the main menu
			-> Key definition
			-> Changing the way keys are stored
		* Both player should no more leave pixels behind them
		* Fixed some bugs

	- v0.9 Beta
		Corrected a bug on the bombs : you can now walk over the bombs you 
		have just put ! (So it is very more playable) 

	- v0.9 alpha	FIRST PUBLIC RELEASE (Alpha release)
		Only for beta-testing purposes...
	Already contain :
		* 2 Player game (on the same calc)
		* Realistic explosions (like the PC game)
		* Speedy game
		* Bonuses (only bombs and flames)
=======================================================================================
CREDITS
-------
Bomber team expands !!!
	Christophe Fondacci : program, original graphics (which are not in this version),
			      title graphic & 4th set of sprites.
	Noah S Zoschke      : Additionnal graphics, grayscale graphics, sprites,
				    Monsters, to resume : all the gfx




Enjoy playing BOMBER !!!	
Bye !