
         _______   ________   _____     __    _______
        |____   |  \__  __/  |   _  \  |  |  |   ____|
             |  |    |  |    |  |_|  | |  |  |  |____
         __  |  |    |  |    |      /  |  |  |____   |
        |  |_|  |    |  |    |  |\  \  |  |   ____|  |
        |______/     |__|    |__| \__\ |__|  |_______|
                                               ver 1.01



== IMPORTANT - Disclaimer ====================================================

I do not accept responsibility for any effects, adverse or otherwise, 
that this program may have on you, your computer, your sanity, your dog, 
and anything else that you can think of. Use it at your own risk.


You can obtain the latest JTris from my homepage :-
    http://free.prohosting.com/~jgfw   or
    http://surf.to/jgmod


== Minimum requirement =======================================================

Processor     : 486Dx2-66Mhz
Graphics Card : VESA compatible with 1 Mb
Memory        : 8MB for DOS, 12MB for Win9x

== Recommended requirement ===================================================

Processor     : Pentium or better processor
Graphics Card : VESA compatible, 2 Mb with 15,16,24 or 32 bits grahpic mode
                support.
Sound Card    : Sound Blaster 16 compatible
Memory        : 16MB


== How to play the game ======================================================

It is quite simple. You have to stack those falling bricks to form a
horizontal line or lines (4 lines at most). If formed, the line(s) will be
cleared and you will be given possibly another type of bricks to stack
again. This process repeats until you stack till the top.


== Options Menu ==============================================================

Define keys
        To change all the control keys for the ingame.


Adjust keyboard sensitivity
        To adjust the sensitivy of the keyboards for the ingame.


Change Background (On or Off)
        To instruct JTris to change background after player completed a level.
        The process can be very slow on slow computers like 486. To increase
        the speed, switch it off.


Music Order (Sequential or Random)
        Sequential plays musics sequantially according to the list in
        music.lst. Random plays musics randomly.


Alpha Level (0 - 15)
        Select the transparency level of the menu, and ingame. The
        more the darker.


No. of Voices (8, 16, 32, 64)
        Selects the total number of sound effects and musical instruments to
        be played simultaneously. 64 voices will softer than 32 voices. 8
        would be the loudest.

        I would recommend setting 32 or 64 as JTris will be able to play mod
        musics properly. At 8 or 16, most MODs will sound odd especially
        JTris startup music. But if have you modified music.lst to include
        all MP3 but no MOD and don't care about tht statup music, then 8 would
        be recommended.



Sfx Volume (0 - 15)
        Adjust the sound effects volume.


Music Volume (0 - 15)
        Adjust the MOD music volume. Doesn't affect the MP3 volume.


== Default Keys ==============================================================

F1              Decrease the SFX volume
F2              Increase the SFX volume
F3              Decrease the music volume
F4              Increase the music volume

F5              Fast reverse the music
F6              Fast forward the music
F7              Play the previous music in the music.lst
F8              Play the next music in the music.lst

F9              Pause the game
F10             Change wallpaper
F11             Play a random music
F12             Save the screen to scrshot.pcx


 -----------------
| One Player Mode |
 -----------------
  Player One
  ----------
Left arrow      Move the block to the left
Right arrow     Move the block to the right
Down arrow      Move the block downwards
S               Rotate the block clockwise
A               Rotate the block counter clockwise



 ------------------
| Two Players Mode |
 ------------------
    
  Player One
  ----------
F               Move the block to the left
H               Move the block to the right
G               Move the block downwards
S               Rotate the block clockwise
A               Rotate the block counter clockwise

  Player Two
  ----------
Left arrow      Move the block to the left
Right arrow     Move the block to the right
Down arrow      Move the block downwards
L               Rotate the block clockwise
K               Rotate the block counter clockwise


== Scores ====================================================================

Every time a line is completed, you will gain scores. The more lines you
complete, the more score you will gain. Every ten lines you completed, you
will gain a level where the block will fall faster.

1 line      10 scores
2 lines     30 scores
3 lines     60 scores
4 lines     200 scores

== Add your music to the playlist ================================================

You can customize the playlist by adding it to the playlist in the file
music.lst. 

For example :-
gslinger.mod


If the file is in a different directory or drive, include the path too..

For example :-
c:\mod\gslinger.mod


Any word begin with the semicolon will be ignored.

For example :-
;c:\mod\gslinger.mod


Do not put empty lines or JTris will think it is a file.



You can get more musics at
    http://www.napster.com
    http://www.modarchive.com,
    http://www.traxinspace.com
    http://www.zaba.simplenet.com
    http://free.prohosting.com/~jgfw/mod_top/mod_top.html

Supported mod types are MOD, S3M, XM, JGM and Unreal UMX(type S3M and XM)
and MP3.


== Question and Answer =======================================================

Q. Jtris doesn't run on Windows NT 4.0. Can you help me on this problem ?
A. Windows NT does not have a good support for DOS programs. Windows NT
   doesn't allow direct access to the sound card and graphics card which
   Jtris needs. Please use Windows 9x or MSDOS instead.

Q. Does JTris runs on Windows 2000 or Windows ME (Millenium Edition) ?
   JTris runs on all version of Windows 95/98/Me fine. I have tested
   JTris on Windows 2000 and it runs fine on my computer too but I cannot
   gurantee that it will run on your Win2k.

Q. Why there is no output from the speaker when playing the game ??
A. Make sure that the sound environment for your sound card is set.
   (eg. for sound blaster and compatibles - BLASTER=Axxx Ix Dx Hx Tx)
   If your sound card needs a driver, make sure it is loaded.

Q. JTris always configure my sound card at 22727Hz, while mine is a SB16
   which is capable of 44100Hz. How do I change this ??
A. Create a file called allegro.cfg where jtris.exe resides and add this 3
   lines into it

   [sound]
   sound_freq = 45454
   quality = 2


Q. The MP3 music volume cannot be change. How can I do that ?
   I am trying to find a way to do that too.

Q. The game threatens me when I want to quit the game. Please help !!! I
   don't want viruses infect my computer or have my hard disk formatted.
A. The game gets upset when people quit him. Don't ever try to make him
   upset. Otherwise, you will pay for the consequences. No antivirus can
   help you on this. Hehe :-)

Q. There are some error loading chart.cfg or config.cfg. How to fix this 
   problem ?
A  Just delete chart.cfg or config.cfg. Deleting one of then will cause
   JTris to generate a default chart.cfg or config.cfg. You can delete
   chart.cfg to erase all the old scores and start a default one.



== Thanks list ===============================================================

Shawn Hargreaves
    for his free ALLEGRO game programming library.

Eric Vannier
    for this LIBJPEG library

Tomislav Uzelac
    for developing the Amp library

Ove Kaaven
    for porting the LibAmp library to DJGPP Allegro.


DJ Delorie
    for making DJGPP, best compiler in this world. Just imagine, a compiler
    which produces 32 bit, protected mode programs for FREE !! Nothing else
    is better than that.

Andr‚ LaMothe
    for writing 3 books on game programming (Tricks of the Game Programming
    Gurus, Teach Yourself Game programming in 21 Days and Black Art of 3D
    Game Programming). These 3 books make me a hell lot easier to understand
    the functions in Allegro.
