 _______________________________________________________________________
  
Monster - The ultimate (?) grayscale breakout-like game for TI-89/92/92+!

                   Version 1.3 - released April 25, 2019
  
         eeulplek@hotmail.com     http://www.ocf.berkeley.edu/~pad/
 ________________________________________________________________________


 _____________________________________ TABLE OF CONTENTS

 1. Introduction ..................................................... 25  
 2a. System requirements (TI-92/TI-92 II) ............................ 41
 2b. System requirements (TI-89/89 Titanium/92+/Voyage 200) .......... 55
 4. Instructions .................................................... 115
 5. Bonus Items ..................................................... 160
 6. Contacting the Programmer ....................................... 180
 7. Acknowledgements ................................................ 207
 8. Version History ................................................. 242
 9. The Future ...................................................... 282

 _____________________________________ INTRODUCTION

Monster is a breakout-like game for the TI-89, TI-92, TI-92 II, TI-89
Titanium, TI-92 Plus, and Voyage 200 calculators.  This program is written
completely in 68000 assembly language to fully take advantage of the
calculator's capabilities.
      
If you want to obtain other calculator programs or learn more about TI
calculators, I would suggest visiting the web sites listed below.  They all
have large archives as well as help sections.  If you don't know how to
transfer programs to your calculator, or how to run them once you've
transferred them, you should read the help sections on these sites, or the
FAQ on my web page.

    http://www.ticalc.org/       
    http://www.cemetech.net/  

 _____________________________________ SYSTEM REQUIREMENTS (TI-92 / TI-92 II)

There is a TI-92 version of Monster.  It supports both the regular TI-92
and the TI-92 II.  This version should work on all ROM versions provided
that Fargo II is installed before running the game.

You must have enough memory to store the game file, and it also needs 15K of
free RAM when run.  Saving the high scores does not require additional
memory since the scores are stored in the game file itself.  Saved games
also require no free RAM, but they are store in a hidden place in memory
and may be overwritten by other programs if you do certain other things
with your calculator after saving the game, so saved games should be seen
as very temporary.

 _____________________________________ SYSTEM REQUIREMENTS (OTHER THAN TI-92)

SYSTEMS SUPPORTED:  There is a TI-89 version which supports the TI-89 and
TI-89 Titanium, and a TI-92 Plus version which supports the TI-92 Plus and
Voyage 200.   No patches are needed for any of these calculators.

HARDWARE VERSIONS SUPPORTED:  This game will work on hardware versions 1, 2,
and 3 (all of the versions currently known).  It is not necessary to install
HW2Patch or HW3Patch for this game.

SOFTWARE VERSIONS SUPPORTED:  Except as noted below, this game should work
on all AMS versions.  It has been tested on versions up to 3.10 with no
problems found.  It does not work on a TI-92 Plus with the very old AMS
version 1.00 so you need version 1.01 or higher if you have a TI-92 Plus.
Also, if you have AMS versions from 2.01 to 2.03, the default size limit
of 8K will prevent the program from running.  Later AMS versions have a
higher size limit that allows this program to run.  You can get the newest
version of the AMS from TI's web site.

MEMORY REQUIREMENTS:  The game file itself must, of course, fit into memory
in order to install it on the calculator.  If stored in archive memory, it
must be temporarily copied to RAM in order to run.  The program must allocate
4K (under HW1) or 8K (under HW2) of additional RAM when run, and 2K more of
free RAM is needed to save the game.

SHELLS/KERNELS REQUIRED:  No shell or kernel is required to run this game,
Unless there are problems in the shell or kernel used, the game should run
with a kernel installed and should be startable from a shell.

 _____________________________________ INSTRUCTIONS

To install the game on your calculator, you only need to send the program
file.  For the TI-89 and TI-89 Titanium, this file should be called
'monster.89z' on the computer; for the TI-92 Plus and Voyage 200 it is
'monster.9xz'.  For the TI-92 and TI-92 II, it is 'monster.92p' (note that
Fargo II must be installed first).  Once it is installed, type monster() on
the home screen to run the program.

Additionally, the game creates a variable called 'mnstdata' when you exit
which stores saved games, high scores, and options.  You can safely delete
'mnstdata' but then its data may be lost.  All of the files can be archived,
but 'mnstdata' will be saved into RAM on exit (even if it was archived
before).  This does not apply to the TI-92 version which keeps the high
scores internally.

You also must have at least one level file on the calculator to play the
game.  These are either .89z, .9xz, or .92s files, depending on which
calculator is used.  The TI-92 version only accepts level files from the
main folder, while the other version will search all folders.

Running it normally will show you the title screen, which lists the keys to
press to start playing or view more information.  Since you can read it
(I hope) I won't describe it again here.  Note that you will get higher
scores for choosing higher speeds (you get a speed bonus which increases
somewhat for higher speeds; in addition, the victory bonus which is given
only if you when depends on the speed as well).

If you have more than one level file, the level selector will appear after
you select the speed.  Use the up and down arrows to select a level, and
press enter to begin.

The gameplay is like breakout.  I hope you know the basic idea.  The controls
for the gameplay are:

Left and right arrow keys       Move paddle
2nd (or LOCK/hand on 92+)       Release ball
                                (and slow down while moving)
                                (and fire lasers, if you have them)
. (dot)                         Quit game
+ and -                         Adjust contrast
APPS                            Save game and exit
P                               Pause game (press F1 to resume)                              

If you save the game, gameplay will resume immediately at the point you left
off the next time you run the program.  The level file you selected before
must still be on your calculator.

 _____________________________________ BONUS ITEMS

Each brick destroyed will deploy a bonus approximately 10% of the time.
Bonuses will not be dropped from where they cannot be collected, and only
one can be on screen at a time.  The bonuses appear as follows:

Expand paddle           Line with arrows pointing outward at ends

Extra life              Heart followed by plus sign

Slow balls              Ball with parentheses around it

Multi-ball              Three balls in a row

Brickthru               Ball with an arrow through it

Increase score          Number 500

Two blasts              Laser weapon (20 shots per collection of this)

 _____________________________________ CONTACTING THE PROGRAMMER

If you find any bugs in this game or have suggestions or comments about it,
please tell me in E-Mail!  If you are writing to report a bug, please be
sure to tell me exactly what the problem is and describe exactly what you
did before the problem occured.  If you don't do so, it will be very hard
for me to tell what is going wrong!  You should also tell me which version
of Monster you have and which calulator you use in any mail you send me.
My main E-Mail address is:

        eeulplek@hotmail.com

I will usually answer my E-Mail within a week.  If you don't get any answer
in two weeks, you can try sending to the following backup addresses:

        patrickandrewdavidson@gmail.com

If your E-Mail is set up to block all messages except those from certain
addresses, always be sure that you have un-blocked my address before
sending anything to me (best to un-block all of them, since I might answer
from a different one than you sent to).

You can always get the latest version of this game, as well as other
programs of mine, from my web page.  The address is:

        http://www.ocf.berkeley.edu/~pad/

 _____________________________________ ACKNOWLEDGEMENTS

This game is my own work.  However, there are a few others whose assistance
was invaluable in producing this game, and there efforts will be acknowledged
here, in no particular order:

David Ellsworth            Fargo II and the Fargo II development tools,
                           also a small bit of FLIB code I used

Brian Anderson and         The A68K assembler, used to assemble almost all
Charlie Gibbs              calculator assembly programs

Tleilax                    DB92, an amazing on-calculator debugger

Rusty Wagner of ACZ        The VTI calculator emulator, which provides the
                           ultimate testing environment on a computer

MarkuSoft                  They GrayImag image converter

Corey Taylor of the ACZ    the CalcGS map editing software

Zeljko Juric               The TI-GCC library, whose documentation helped
                           to explain some ROM functions and also showed
                           me how to do OS key-reading and HW detection

Thomas Nussbaumer          The ExePack utilities which compress the program
                           quite a great deal

Adrian Posor               The ever-important beta testers, who have made
Aaron Povolish             sure that this program is bug-free
Jacob P.
Paul Griffin

Bhunavesh Bhatt            Testing on the TI-89 Titanium

 _____________________________________ VERSION HISTORY

Sizes listed here are for the uncompressed TI-89 version of the program.

 Version  Date       Bytes  Lines  Description

    0.10  31-Oct-01   8859   3200  First version 

    0.26   6-Dec-01  11579   3893  Added scoring and high score table
                                   Improved ball trail
                                   Implemented speed selection
                                   Implemented slow paddle movement
                                   Added 4 more levels
                                   Implemented flashing when round lost
                                   Added score and brickthru bonuses

    0.66   2-Feb-02  11463   4431  Fixed title screen contrast change
                                   Implemented external level support
                                   Improved random bounce adjustments
                                   Implemented lasers
                                   Improved scoring
                                   Added pause feature

    0.82  30-Mar-02  11379   4465  Redesigned bouncing control
                                   Increase block/screen size on TI-92 Plus

    0.83   4-Jul-02  11379   4465  Updated PPG launcher for AMS 2.07

    0.99  30-Apr-04  11341   4563  No longer stops clock on AMS 2.08
                                   Optimized grayscale routines
                                   Added to default levels
                                   Compatible with TI-89 Titanium

    1.0   16-Sep-04  11287   4582  Optimized for size

    1.2   19-Apr-09  11261   4623  Added some validation of level data
                                   Optimized ROM calls
                                   Added an easy level set

    1.3   25-Apr-19  11129   4870  Added TI-92 version
                                   
 ______________________________________ THE FUTURE

I don't plan to make any further changes to this game.

