****   ***  ***** ***** *     *****      *****  ***  *   * *   *  ****
*   * *   *   *     *   *     *            *   *   * *   * *  *  *
*   * *   *   *     *   *     *            *   *   * **  * * *   *
****  *****   *     *   *     ****         *   ***** * * * **     ***
*   * *   *   *     *   *     *            *   *   * *  ** * *       *
*   * *   *   *     *   *     *            *   *   * *   * *  *      *
****  *   *   *     *   ***** *****        *   *   * *   * *   * ****

                               <By Evan Hoke>

Description:
Battle Tanks is a battle game similar to the classic Scorched Earth 
game for DOS. The object of the game is to destroy your opponents 
tank before he or she can destroy yours.  There are 6 weapons: cannon, 
bomb, laser, nuke, guided and digger as well as 2-player mode, target 
practice mode and computer player mode.  There are also 3 save slots 
for saving a game.

Requirements:
A Ti 83 or Ti 83-Plus Calculator
The Ion shell.  You can download this at http://www.ticalc.org
A graph link or equivalent, for sending the program to your calculator.

Installation:
1. Using the software that can with the Graph Link, send Ion to your 
calculator and install it.  For more detailed instructions on 
installing Ion, refer to Ion.txt with is part of the Ion zip file.
2. Send either the "Battank.83p" file if you are using a Ti 83 or the 
"Battank.8xp" file if you are using a Ti 83-Plus to your calculator.
3. Run prgmA.
4. Select "Battle Tanks 2.0" from the list of programs using the up 
and down arrows.  If  "Battle Tanks 2.0" does not appear on the 
list, use the left or right arrows to go to the next page and select 
"Battle Tanks 2.0".
5. Hit Enter or Y= to run the program

Getting Started:
After run installing and running the program, a startup screen will 
appear.  After the startup screen disappears you will be prompted if you 
want to have a one or two player game.  Press the 1 button for a one 
player game.  Press the 2 button for a two player game.  If you pressed 
1 you will be asked if you want to play against a target or the computer.  
In target practice mode, you fire at another tank but it does not fire 
back.  When you play against the computer, you and the calculator take 
turns firing at each other.  Press T (4) to play against a target or C 
(PRGM) to play against the calculator.  After this a menu will appear.  
This is where you will be able to buy weapons.  Since you start out 
with no money, hit clear to exit the menu.  Next you will be asked for 
the terrain level.  This is how rough you want the ground to be.  Press 
0-9 to set the terrain level, with 0 being flat and 9 being extremely 
rugged.  You can also press ? (-) to have the calculator pick a random 
terrain level.  Next you will be prompted for the wind speed.  Press 0-9 
to set the speed with 0 being no wind and 9 being strong wind, or you 
can press ? (-) for a random wind speed.  After following these steps, 
the ground will be drawn and can start to play the game.

Playing the Game:
Once the terrain has been generated, you are ready to play the game.  
First you should determine what tank you are.  The tanks are small, 
semi-rectangles sitting on the ground.  The player 1 tank is a little 
lighter than the Player 2 tank.  Note:  If you are in 1 player mode, you 
are automatically player 1. Next select the weapon you want to use.  
The current weapon is displayed in the upper right corner of the screen.  
To switch between weapons use the top row of buttons on the 
calculator, "Y=" for bombs, "Window" for lasers, "Zoom" for nukes, 
"Trace" for guided missiles and "Graph" for diggers.  To switch back 
to cannon press the same button again.  Note: in order to use a weapon 
use must have some of them.  You start out with unlimited cannons, 1 
bomb three lasers and two diggers.  You can buy weapons after a game 
if you have sufficient money.  For more information about the different 
weapons, read the weapon descriptions below.  After choosing your 
weapon, adjust the angle and power.  0 degrees is pointing completely 
to the left and 180 degrees is completely to the right.  Note: you start 
out aiming in the general direction of you opponent.   Use the left key 
to lower the angle and the right key to raise the angle.  Be sure that you 
are aiming high enough for the shot to make it over the terrain but low 
enough so the wind wont blow it backwards.  The current wind speed 
and direction is displayed in the lower left corner of the screen.  The 
current angle is displayed at the top of the screen.   To adjust the power, 
use the up key to raise the power and the down key to lower the power.  
Make sure you have significant power for the shot to make it over the 
high parts of the ground and also make sure you account for the wind.  
The current power is located at the top of the screen.  Next hit 2nd or Y= 
to fire.  The path of the shot will be drawn on the screen.  If you hit the 
other player, or yourself a message will come up saying, "Player 1 
Wins" or "Player 2 Wins", and you will be asked if you want to play 
again.  Press Y (1) to play another game or N (LOG) to Quit.

Weapon Descriptions:
Cannon is the default weapon and you have an unlimited number of 
them.  However in order to kill your opponent with a cannon you must 
directly hit them. To aim the cannon change the power and angle.

Bombs travel in the same path as cannon ball except they explode on 
impact.  The explosions of bomb permanently wipes out terrain and can 
kill the opponent.  Also if you blow ground out from under you 
opponent, he dies.

Lasers are similar to cannons, they stop when they hit the ground and 
you have to have a direct hit to kill your opponent, except gravity or 
wind doesnt effect them.  You need to adjust the angle but the power 
has no effect.

Nukes are similar to bombs except with bigger explosions.

Guided Missiles travel out in a straight line from the angle you shoot 
them.  You can turn them by using the right key to turn them clockwise 
or the left key to turn them counterclockwise.  They will stop if them 
hit go out of the screen, hit the opponent, yourself or the ground

Diggers are the same as cannon balls except that they travel through 
ground until they go out the sides or bottom of the screen.  Diggers do 
not however permanently effect the terrain since the holes fill in behind 
them.  Like cannon balls, you need to have a direct hit to kill you 
opponent.

Buying Weapons:
At the end of every game a menu will come up allowing you to buy 
weapons.  Use the up and down keys to move the arrow on the right 
side of the screen to the weapon you want to buy and hit enter to buy it.  
You will receive the number of that weapon that is written with a colon 
next to the price, which is on the right side of the screen.  If you do not 
have enough money to buy the weapon, you will not be allowed to buy 
it.  The amount of money you have is displayed in the bottom left 
section of the screen.  You receive money every time you win a game.  
The amount of each weapon you have is displayed to the right of the 
weapon name.

Quitting and Saving:
To quit the game, hit the quit (mode) button at anytime during the 
game.  You will be asked if you want to save the game.  Hit Y (1) to 
save the game or N (LOG) to just quit.  If you hit Y (1), you will be 
asked which slot to save the game on.  There are three slots.  To select 
slot 1 press 1, for 2 press 2 and for 3 press 3.  If you already have a 
game stored on the slot you are saving to, it will be overwritten.  To 
load a game, run the program.  After the startup screen you will be 
prompted if you want to load a game.  Press Y (1), for yes or N (LOG) 
for no if you pressed Y (1), you must select a slot, the same way you 
did when saving the game.  The game will then be loaded.

Bug Reports, Questions or Comments?
If you would like to report a bug or have a question or comment about 
Battle Tanks, please email me at ehgid@hotmail.com.  Please be very 
descriptive in a bug report so that I can identify the problem and fix it.

History:
Version 1.0 2/25/00 Finished the basic version of Battle Tanks.
Version 2.0 7/12/00 Finished the assembly version of Battle Tanks.  
Now it is 15 times faster and half the size, with slightly improved AI.

Acknowledgments:
I would like to thank the following people for their contribution to 
Battle Tanks:
-Mike Edelson for making the basic version of Battle Tanks with me.
-Bill Hoke for figuring out the wind equation.
-James Matthews for his great assembly tutorials.
-Texas Instruments for their documentation on floating point math 
ROM calls.
-Joe Wingbermuehle for making the Ion shell.
-You for downloading Battle Tanks and taking the time to read this 
boring file.
-All the people who encouraged me and gave me suggestions on 
making Battle Tanks.