     XXXX   XXX  XX  X XX    XXXX  XXXXX XXXX    XXXX   XXX   XXX  XX  X TM
     XX  X XX  X XX  X XX    XX  X XX    XX  X   XX  X XX  X XX  X XX  X
     XX  X XX  X XX  X XX    XX  X XX    XX  X   XX  X XX  X XX    XX  X
     XXXX  XX  X XX  X XX    XX  X XXX   XXXX    XX  X XX  X  XXX  XXXXX
     XX  X XX  X XX  X XX    XX  X XX    XX  X   XX  X XXXXX     X XX  X
     XX  X XX  X XX  X XX    XX  X XX    XX  X   XX  X XX  X XX  X XX  X
     XXXX   XXX   XXX  XXXXX XXXX  XXXXX XX  X   XXXX  XX  X  XXX  XX  X


				--== BETA 6 ==--


                     THE TI89 HW1/HW2 PlusShell VERSION

                        Programmed by Jimmy Mardell

		      PORTED TO HW2 BY FLAVIEN RACINE
                     PORTED TO FARGO II BY SKIP JORDAN
                    PORTED TO PlusShell BY RUSTY WAGNER
              PORTED WITH PERMISSION TO TI89 BY MIKAEL SUNDBERG


ABOUT BOULDERDASH
-----------------
BoulderDash was first made for the Atari 400/800, and ported to Commodore 64
the next year (1986). BoulderDash is a trademark of First Star Software Inc,
and was originally programmed by Peter Liepa. BoulderDash was converted
to several other systems, including MSX, Amiga, PC and lately Nintendo
and Gameboy. There are many clones available, which indicates that
BoulderDash was, and is, a fantasic game. And now you have it for your own
calculator!

FARGO?
------
A combination of a shell/OS for the TI-92 calculator made by David Ellsworth,
Dan Eble and Rob Taylor which allows assembly programs to be executed on
the calculator. You can find it at http://www.ticalc.org, but you MUST
have a link cable to send it over to the calc (it's a backup file).

To get this game to work, you MUST have FLIB (UTIL on TI89), 
and GRAY4LIB on the calculator!

ZSHELL VERSION
--------------
I've also made BoulderDash for ZShell - an assembly OS/Shell for the TI-85 -
which you'll find in the ZShell archive at http://www.ticalc.org) which works
almost exactly like this version (and the original). This game is actually
just a port of that game. And this documentation is, as you may have noticed,
a 99% copy of that one...

GAME OBJECTIVE
--------------
The objective of BoulderDash is to search throughout each CAVE and collect
as many Jewels in as short a time as possible. Once the indicated amount
of Jewels have been collected, the door to the mysterious escape tunnel is
revealed and you go to the next cave. Strategy and planning will help you
master the "physics" of BoulderDash. Boulders drop predictably enough, but
you and Rockford also have to block growing Amoebas, transform Butterflies,
outmanoeuvre Fireflies, and overcome other numerous obstacles.

CHANCES
-------
You start with 3 chances, Bouns tries are awarded after every 500 points.
A text to the right will tell you when you are awarded a bonus try. A bonus
is also earned by completing a Playable intermission.

CAVES AND LEVELS
----------------
There are 16 caves, each comprising of several scrolling screens, numbered
A to P. Each cave, has 5 Difficulty Levels. To select a different cave,
press [Up] or [Down] in the menu screen. To select a different Difficulty
Level, press [Left] or [Right] in the menu screen. The greater the difficulty
the less time you have and the more Jewels you have to collect. You may choose
cave A, E, I or M, on Difficulty Levels 1-3. On Difficulty Levels 4 and 5, you
must start with CAVE A. After making a selection, press [Enter] or [2nd] to
begin the games.

([Mode] Changes cave-set, 1 or 2)

HISCORE
-------
One hiscore position will be saved and stored inside the program. You enter
your initializes with the [Up] and [Down], change letter with [Left], [Right]
or [Enter] and return to the menu screen with [2nd] or [Exit].

** In this beta version, this feature isn't implemented yet.

CONTROL
-------
You move Rockford through the caves with the arrowkeys or the numerical keys
if you prefere that. You can also "reach out" if you hold down [2nd] or [Z] 
([2nd] or [Diamond] on TI89) when moving. This is good when you're fetching 
falling jewels for example, or untrapping an enemy. If you die, or if you 
have made a mistake so the cave isn't possible to solve, press [Esc] to 
restart on the same cave. [P] ([Alpha] on TI89) will pause the game 
and [Q] ([Clear] on TI89) quits the game (if you have a highscore then, 
you will still get a chance to enter your name).

You can also switch between greyscale mode and black&white by pressing
[Mode]. (Don't!!!) (Disabled on TI89, didn't work as it should anyway)



ALL OBJECTS IN BOULDERDASH
--------------------------
Rockford

 This is you, a fellow that search through caves a collects jewels. You should
 beware falling things, butterflies and fireflies because they will kill you!

Dirt

 Not much to say. Exists to keep things from not falling down.

Boulder

 Boulders falls down if it's possible. They may also roll of another
 rounded object (boulder, jewels or brick wall) so watch out! You can also
 push boulders if you try to move in the same direction as the boulder is.
 There must be empty space behind the boulder though, and you'll succeed
 in 1 try of 4, so keep pushing until it moves!

Jewel

 These you should collect. They fall and acts like boulders, so you will get
 killed if you get one on top of your head!

Steel wall

 Surrounds the cave and can not be blasted through.

Brick wall

 Walls that can be blasted through. Acts like a rounded object, so boulders
 and jewele will roll of a brickwall if possible.

Magic wall

 Looks like a brick wall, but when a boulder or a jewel falls on it, the magic
 wall will be activated (the wall will animated so you can see when it's
 activated) and then every boulder that falls through will turn to a jewel
 and every jewel will turn to a boulder! If there aren't space under the
 magic wall, the boulder/jewel will disappear. After a time (depends on the
 level), the magic wall will expire, and nothing falls through but always
 disappear. Note that only falling boulders and jewels will transform; boulders
 and jewels that already sit on the wall will not fall through.

Firefly

 A nasty enemy that flies around the cave. Will always try to turn left if
 possible (will fly around in circles if possible). Explodes into space when
 Rockford or Amoeba are close (one step). May be used to blast through brick
 walls (drop a boulder or a jewel on them).

Butterfly

 Acts like fireflies except that they turn to the right instead, and when
 exploding they will create nine jewels!

Amoeba

 A creature that doesn't harm you, but will expand (slowly in the beginning,
 but after a while it grows much faster) and may enclose you or block your
 way. Can be blasted when a firefly or a butterfly touches it.

CAVE DESCRIPTIONS
-----------------
Now there are two cave sets available! Here are the description (and hints)
for the first cave set (which is the same as the previous version). The
second cave set (from BoulderDash III) have no cave descriptions (in the
game it says ?) but they'll be added when I get them.

A. INTRO
Pick up jewels and exit before time is up.

B. ROOMS
Pick up jewels, but you must move boulders to get all jewels.

C. MAZE
Pick up jewels. You must get every jewel to exit.

D. BUTTERFLIES
Drop boulders on butterflies to create jewels.

E. GUARDS
The jewels are there for grapping, but they are guarded by the deadly
fireflies.

F. FIREFLY DENS
Each firefly is guarding a jewel.

G. AMOEBA
Surround the amoeba with boulders, so it can't grow anymore. Pick up
jewels that are created when it suffocates.

H. ENCHANTED WALL
Activate the enchanted wall and create as many jewels as you can.

I. GREED
You have to get a lot of jewels here, lucky there are so many.

J. TRACKS
Get the jewels, avoid the fireflies.

K. CROWD
You must move a lot of boulders around in some tight spaces.

L. WALLS
You must blast hrough walls to get at some of the jewels. Drop a boulder
on a firefly at the right time and place to do this.

M. APOCALYPSE
Bring the butterflies and amoeba together and watch the jewels fly.

N. ZIGZAG
Magically transform the butterflies into jewels, but don't waste any
boulders and watch out the fireflies.

O. TUNNEL
There is an enchanted wall at the bottom of the rock tunnel.

P. ENCHANTED BOXES
The top of each square room is an enchanted wall, but you'll have to blast
your way inside.

VERSION CHANGES
---------------
0.6b  First release version. The main part done, all details left.
0.7b  Small updates on 0.6, enemis added (?)
0.8b  Some small changes again.
1.0b1 Most details worked out, but still some things missing.
1.1b2 Changed a bug - sometimes you switched between greyscale and b&w
      when you didn't press mode (stupid key wiring on the 92...)
1.1b3 Added pause button (P) and extra life at every 500 points.
1.1b5 Fixed "the Cave M bug". Took me 3 hours to realize that a single
      instruction, clr.l d0, was required... Annoying. Also made a major
      speed increase (though delayed a bit) - it's should be much more fun
      to play now! And now there is support for many different caves, and
      included is 20 totally new caves!
1.1b5 Ported to Fargo II
1.1b5 Ported to TI89
1.1b6 Ported to TI89 HW2 by Flavien Racine 
      FlashZ@netcourrier.com
      http://flashz.multimania.com/      

FEATURES MISSING
----------------
No hiscore.
No external cave support (YES!! BD Construction Kit!!)
Email me, Skip Jordan, if you want me to continue the BD project. See bottom.

KNOWN BUGS
----------
If you press MODE to change to B/W, then try to change back, the calc crashes!
I'm working on it, if you figure it out, email me!!


CREDITS
-------
PETER LIEPA and CHRIS GRAY for the orignal version and the great game idea!

FERNANDO HERRERA for creating all the cool caves (the caves are identical
to those in the original C64 version)

PETER BROADRIBB for his great BoulderDash homepage will all information I
needed (http://www.emedia.com.au/users/peterb/boulderdash/). Keep up the good
work!

THE ZSHELL AND TICALC.ORG TEAM (guess why)

THE #CALC-TI AND #FARGO CREW for chatting :-)

ALL PEOPLE COMMENTING MY WORK for reporting bugs and comments about the game.

ALL OTHER ZSHELL/FARGO PROGRAMMERS for being a programmer :-) There are too
few of us...

Jimmy Mardell for writing the Fargo 0.1.x version.

Jonas Minnberg for Tiger

------------------------------------------------------ written 96-11-16 ----
Jimmy Mardell (aka Yarin)

Email.: mja@algonet.se
WWW...: http://www.algonet.se/~mja

Snailmail: Plommonvagen 21, 904 36, Umea

(if you want to send me money or something :-) )

------------------------------------------------Ported and edited 98-4-15----
Ported to Fargo II by Skip Jordan
Email.:LGB240@aol.com


------------------------------------------------Ported 98-8-10----
Ported to PlusShell by Rusty Wagner
Email:river@gte.net


------------------------------------------------Ported and edited 98-11-13----
Ported with permission (from Jimmy Mardell) to TI89 by Mikael Sundberg
Email:inzomniac@usa.net
my first experience with 68k assembler = use at your own risk!
