====
==== Tumble v1.2 ====
====

By Lunatic Software 
(c) Martin Hall 2001
email: LunaticSoftware@yahoo.co.uk               


Tumble is an original puzzle for Palm OS devices. You must match
shapes together to solve you way through 25 increasingly taxing
levels.

==== History ====

v1.0 - 30/4/01 - First public version 
v1.1 -  2/5/01 - Fix crash on some BW devices
                 Fix Menu Popup bug
                 Fixed several editor bugs
v1.2 -  9/5/01 - Added unlimited Undo/Redo
                 Added Game Replays
                 Various minor bug fixes


==== Requirements ====

Tumble should run on any device with Palm OS 3.0 or above.
(Palm OS 3.5 for the color version).

However this is my first Palm OS project and I've only been
able to test it on a limited number of machines so if you find
a problem please let me know and I'll do my best to fix it.


==== Installation ====

--- Installing for the first time ---

For the color version you need to install:
	Tumble_color.prc and TumbleL000.pdb

For the black and white version install:
	Tumble_bw.prc and TumbleL000.pdb


--- Upgrading from V1.0 or V1.1 ---

If you are upgrading from V1.0 or V1.1 and don't want to lose any
progress you've made in the levels then just install:

	Tumble_color.prc  for the color version
Or	Tumble_bw.prc for the black & white version

It won't do any harm if you install TumbleL000.pdb as well
but all your scores will be reset.


==== Getting Started ====

After tapping 'Start' on the title screen you will see a list
of levels you can play. If this is the the first time you've
played then you can only select the first level "An easy start".
So tap on that then tap "Ok" and you'll be in the game.

==== Object of the Game ====

Each level of Tumble consists of a several balls, triangles or
bombs all of which must be destroyed in as few moves as possible.

By tapping near any side of the play area you cause the board
to be tilted in that direction and all the objects to tumble
towards that edge.

If two or more balls with the same pattern come to rest
against each other then they dissappear.

Triangles are similar to balls except you must get three
the same together before they disappear.

Bombs explode when two come to rest against each other. When they
explode they destroy any adjacent objects (horizontally or
vertically but not diagonally).
 
If you get stuck or mess up a level then you can tap the triangle
icon in the bottom right corner to restart the level.

When everything is destroyed you will be awarded points. The
bottom line of the screen shows a count of your moves followed
by the target for the level. If you solve the level in the
target number of moves you score 100 points. If it takes you
more moves then you score less points.

After playing a level can either Tap 'OK' to return to the level
selection screen, Tap 'Try Again' to have another go on this level
or Tap 'Watch' to watch a replay of this game.

On the level selection screen your best score on each level is added
up to get your Total score shown at the bottom of the screen.
As your total score improves more levels will be unlocked. Locked
levels show how many more points you need to unlock them.

There's no limit to how many times you can try a level and you
can play the unlocked levels in any order. So if you get stuck
try a different one or try to improve your score on one you've
already played.

==== Menus ====

-- Preferences --
Allows you to change a few minor bits and one major thing
 + change the control type
   - Tap is the default mode where you tap on an edge
     to tilt the screen
   - Drag is an alternative which allows you to make a
     pen stroke in the play area and the board tilts
     in the direction of the stroke.
 + Alter the movement speed of the balls
 + Turn the zaping animation on/off
 + Turn the sound on/off
"Reset" will reset all your best scores. Only do this if you've
finished the game and want to let someone else play it, or you
want to play through from the start again.

-- Change Level Set --
Use this to choose a different set of levels to play. 
If you've not registered yet then you can only play the first
set which contains 25 shareware levels.

-- Select Level --
Return to the level selection screen to choose a different level
to play.

-- Register --
Register the game. It only costs $10 from www.palmgear.com which
gives you loads of extra features & levels 

-- About --
Display some details about the game

-- How to Play --
Some brief instructions

-- Undo --
This takes back the last move. You can use it as often as you like.
It also works during a playback to go back a move.

-- Redo --
You can use this after an "Undo" to Redo the move. It also works
during a playback to move forward a move.

-- Watch Best Game --
Use this to watch a replay of your best game on a level. It's useful
when you fluked a game and then can't remember how you did it. It
only works once you've successfully completed the level with
Version 1.2 of the game.

-- Start Editing --
This option is only available once the game is registered.


=== Replays ===

A replay is started either by:
Tapping "Watch" at the end of a level - Which replays the last game
or
Selecting "Watch Best Game" on the menu - Which replays your best game.

In both cases the bottom status bar changes to "REPLAY ??/??" and
you'll be shown a replay of the game. Between each move there is a short
pause. If you tap the status bar during this pause then the replay will
stop and the status bar will change back to "Moves ??/??". You can now
continue playing from this point in the game. Or use the Undo/Redo menu
commands to step forward or back through the game. 


==== Tips ====

Experiment with different tactics. Sometimes the most obvious move
may not be the best.

If no new levels are unlocked then you'll need to get a better score
on some of the earlier one before you can proceed. To unlock the last
levels you'll need to average about 90 points per level.

If you start with an odd ball or triangle then you'll have to use a
bomb to blow it up.

If there are 4 balls the same then be careful not to get rid of three
at once as you'll be left with an odd one.

Watch the replays to try and spot where you went wrong and find any
moves that are redundant.


==== Registration =====

Tumble is a shareware game, which means you can play the first 25 
levels for as long as you like but to get the rest of the game 
you need to pay a $10 registration fee.

You can register from www.palmgear.com its quick and simple and you
even register by phone or fax if you want.

Once you register you'll get a code which will unlock all the extra
features:

- You can load in different sets of levels. At the moment there are
two additional levels sets containing an addition 55 levels for you
to solve. More levels sets are on the way.

- The built in level editor will be unlocked. This means you can 
easily create your own levels to challenge your friends or get
your revenge on me. You'll also get full documentation explaining
how to create new levels.

- I'll keep you up to date with future versions of the game. Hopefully
this version is just the start. I've got a lot of extra features
planned but the amount of time I spend on this will depend on how 
popular it is.

If you've got any requests for extra features then e-mail me. I can't
promise that everything I get asked for makes it into the game (I have 
a day job as well), but I'm much more likely to listen to registered
users.

Register it from: www.palmgear.com
or phone:         817.640.6558
or fax:           817.640.6614

==== Contact ====

If you have any bug reports or comments then please contact me at

LunaticSoftware@yahoo.co.uk


==== Credits ====

Tumble by Lunatic Software

Design, Program, Graphics & Levels:
Martin Hall

Additional Ideas, Support & Tools:
Pam Burgess
Andrew Brechin
Matt Geeson
Bob Smith

==== Disclaimer ====

IN NO EVENT SHALL THE AUTHOR BE LIABLE TO ANY PARTY FOR DIRECT, INDIRECT, SPECIAL, INCIDENTAL, 
OR CONSEQUENTIAL DAMAGES, INCLUDING LOST PROFITS, ARISING OUT OF THE USE OF THIS SOFTWARE AND 
ITS DOCUMENTATION, EVEN IF THE AUTHOR HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 

THE AUTHOR SPECIFICALLY DISCLAIMS ANY WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED 
WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE SOFTWARE PROVIDED 
HEREUNDER IS ON AN "AS IS" BASIS, AND THE AUTHOR HAS NO OBLIGATIONS TO PROVIDE MAINTENANCE, 
SUPPORT, UPDATES, ENHANCEMENTS, OR MODIFICATIONS. 




