yahtChallenge Copyright (c) 1996,1997 Tan Kok Mun
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

This is the shareware version of yahtC 1.8 for Pilot. Please read
REGISTER.TXT for more information.

The latest version of this software can be found at :
     http://home.pacific.net.sg/~kokmun/palmpilot.htm


CONTENTS
========
 0. WHAT'S NEW
 1. GAME FEATURES
 2. THE GAME
 3. TO PLAY
 4. INSTALLATION
 5. DISCLAIMER
 6. REGISTERATION INFORMATION
 7. DISTRIBUTION
 8. SHAREWARE AGREEMENT
 9. LICENSING AGREEMENT
10. HISTORY
11. PROBLEM ?



0. WHAT'S NEW
   ==========
   Version 1.8
   - You can now play the "Classic" rules of yahtC. Please refer to
     "THE GAME" section for more information. This is user selectable.

   - Adjusted the Random Generator. Hopefully it is more random.
     Let me know if this help ?

   - You can now use the hardware up/down key to replace key pressing of
     "Next", "Roll" or "New" button. This is handy when you are holding
     the PalmPilot with your thumbs on the up/down key. You can press the
     key with your thumb after doing all the required selection.

   - You can now challenge the pilot to a set of games. The winner is
     decided after the user selectable number of games have been played.

   - Updated statistics information.

   - The pilot can roll the dice for you after it has moved. This is
     useful if you do not care about what pilot selection is. To still
     see the pilot selection and auto roll, the "See Pilot's Action" needs
     to be enabled.

   - If both "Fast Dice" and "See Pilot's Action" are not enabled, you 
     will only see your dice rolling animation. Pilot dice rolling animation
     will be disabled when "See Pilot's Action" is disabled.


1. GAME FEATURES
   =============
   - One or two players.
   - Pilot-Computer oponent.
   - Statistics of game won, and highest scores.
   - Selectable risk behavior when playing against Pilot.
   - Full game status are stored/restored automatically.
   - Animated dice.
   - Ability to see how you will score for different score 
     categories. 
   - Auto dice selection. User selectable under PREFERENCES.
   - Option to select dice to roll or dice to keep.
   - Show scoring hints. User selectable under PREFERENCES.
     Able to reshow hints after a score has been selected.
   - Resume rolling of unused roll after a score has been 
     selected.
   - Sound Effect.
   - Support "Classic" rules.
   - Auto rolling of dice, after pilot has made it's move.


2. THE GAME
   ========
   yahtC is a luck and strategy game for one or two "players. The 
   objective is to score as many points as possible.

   Each player can roll the dice 3 times. After each of the first 
   and second rolls, the player select the dice to be rolled again.
   The number of times each player can roll the dice is selectable 
   at the start of a new game.

   When the player has a satisfactory dice combination (or after the
   last roll), he/she must select one of the scoring categories to 
   put the points in. Each scoring category can only be used once, 
   except for YahtC where a different rule applies.

   A yahtC is a 5-of-a-Kind, and for the first yahtC it scores 50 points.

   STANDARD RULES
   ~~~~~~~~~~~~~~
   - Each subsequent yahtC earns 50 points each and another turn,
     provided that you did not zero the yahtC category.


   CLASSIC RULES
   ~~~~~~~~~~~~~
   - Each subsequent yahtC earns you 100 points provided you have not
     zero the yahtC Category. You can use subsequent yahtC as a Joker
     provided :

     1. You have scored on the yahtC category (including zero).
     2. You have filled the corresponding category in the left scores
        section. For example, if you have rolled:

          [5] [5] [5] [5] [5]

        the Fives category must also be filled.

        If this is the case, you can use the yahtC as a joker to fill
        in any right scores category. You score the category as normal.
        Thus for the Small Straight, Large Straight, and Full House
        categories, you would score 30, 40, and 25 points respectively.
        For the 3 of a Kind, 4 of a Kind, and Chance categories,
        you would score the total of the die face.

   - If you have scored a zero in the yahtC category, you cannot receive
     any bonuses.

   - You will not get another turn for subsequent yahtC in "Classic" Rules.


   Scoring is as follows :

       LEFT COLUMN
       -----------
       ONES        : Total of all dice showing 1 pip.
       TWOS        : Total of all dice showing 2 pips.
       THREES      : Total of all dice showing 3 pips.
       FOURS       : Total of all dice showing 4 pips.
       FIVES       : Total of all dice showing 5 pips.
       SIXES       : Total of all dice showing 6 pips.
       TOTAL       : Left column total.
       BONUS       : 35 points if left column total is 63 or more.

       RIGHT COLUMN
       ------------
       3 OF A KIND : 3 or more dice are the same; score is sum of all 
                     5 dice.
       4 OF A KIND : 4 or more dice are the same; score is sum of the 
                     5 dice.
       FULL HOUSE  : 25 points if you have 3 dices of one value and 
                     the other 2 dice of another value.
       SMALL STR   : 30 points if you have 4 or 5 dice in numerical order.
       LARGE STR   : 40 points if you have all 5 dice in numerical order.
       YAHTC       : 5 dices with the same value. See scoring detail above.
       CHANCE      : Sum of the five dices.
       TOTAL       : Right column total.


3. TO PLAY
   =======
   To play, press ROLL to roll your dice. Select the dice you want to
   re-roll and press ROLL. In total you can roll your dices three times
   in a turn (or 4 times if you set 4 rolls at the beginning of the game).

   The MENU commands are as follows :

   COMMANDS
   ~~~~~~~~
   - NEW CHALLENGE : Play a new challenge.

                 Select the New Game Settings and select OK to start a new
                 game. Select CANCEL if you do not want to start a new game.

                 New Game Settings
                 =================
                 PLAYER1 vs. : None    - Single player.
                               Player2 - Two players.
                               Pilot   - Two players and play against
                                         Palm Computer.

                 PILOT RISK FACTOR    : Select how much risk the Pilot
                                        Computer will take. Higher setting
                                        means the computer will take 
                                        higher risk.

                 ROLL DICES ... TIMES : How many times you can roll the
                                        dice for each turn.

                 ? GAMES PER CHALLENGE : Games to play before the winner
                                         is decided.

                 "Classic" Rules : Select to play by the "Classic" rules.


   - SCORE COMPARISON : Shows the current score comparison.

   - STATISTICS       : Show the game statistics. You will be shown the
                        number of challenge you have won, and the highest
                        score.

                        You can reset the score by pressing the RESET button.

   - PREFERENCES : Game settings. Changes to these settings will only be 
                   effective at the next roll.

                   AUTO DICE SELECTION
                      - Tick to auto reselect dice you have rolled.

                   ALL DICE SELECTED
                      - After each roll, all the dices are selected for
                        next roll.

                        If auto dice selection is enabled, only dices that
                        are rolled are selected.

                   SHOW HINTS
                      - Tick to shows points in unused score categories.

                   FAST DICE
                      - Tick to reduce heart attack, or risk seeing the
                        number you want passes by.

                   SEE PILOT's ACTION
                      - Tick to see pilot's dice selection.

                   SOUND EFFECTS
                      - Tick to enable sound effects.

                   ROLL DICE AFTER PILOT MOVES
                      - The pilot can roll the dice for you after it has
                        moved. This is useful if you do not care about what
                        pilot selection is.

                        To see the pilot selection and auto roll, the
                        "See Pilot's Action" needs to be enabled.


   HELP
   ~~~~
   - RULES   : Text about the game play.
   - SCORING : Summary of how the scores are calculated.
   - ABOUT   : Author information.


   BUTTON
   ~~~~~~
   The BUTTON on the screen is dynamic and chances acording to where you
   are in the game. Possible BUTTONs are :

     NEW  : Select a new game. Only appears when the current game has ended.
     ROLL : Roll the dice.
     NEXT : Next player turn and roll the dice.



4. INSTALLATION
   ============
   Install yahtc.prc using the standard pilot application installer.



5. DISCLAIMER
   ==========
   The author will not take responsibility for any form of damage or loss 
   that occurs when/by using this program. By using the program, you have 
   agreed on all the conditions stated here.



6. REGISTERATION INFORMATION
   =========================
   For registration information, please read the REGISTER.TXT file.


7. DISTRIBUTION
   ============
   This manual and all accompanying files may be distributed freely,
   provided that:
   - Neither text nor any other file is modified in any way. No file
     may be omitted nor added in the distribution.

   - No money may be charged for the program nor for any accompanying
     files, other than the usual downloading time fees charged by
     commercial BBSes and online services.

   - I want to know where my program will be distributed. Please notify me
     if it will be included in printed matter, floppy, or CD-ROM before its
     publication. No matter what the circumstance, I would strongly
     appreciate a copy of whatever collection in which it is included.



8. SHAREWARE AGREEMENT
   ===================
   yahtC is a ShareWare. After registeration, you are licence to use it. 
   All ownership and Copyright of the software belongs to Tan Kok Mun. 
   Please read LICENSING AGREEMENT below. Each registered copy can only
   be used in a single machine.


   
9. LICENSING AGREEMENT
   ===================
   The software accompanying this document (the Software) and the related  
   documentation are licensed to you by Tan Kok Mun (the author) after the
   registeration or during the trial period of the first 30 usage from the 
   date of installation.
   
   The software contains copyrighted material and other proprietary material. 



10.HISTORY
   =======
   27/07/1997 - Version 1.8

   21/06/1997 - Version 1.7.1
                - Fix the following :
                - Pilot score was not updated correctly when
                  second yahtc was scored.

                - Force to start a new game when pilot scored 
                  multiple yahtc.

                  No wonder the PILOT has been losing. . . 8-)

   11/06/1997 - Version 1.7
                - Reshow scoring hints after a score has been selected.
                - Resume rolling of unused roll after a score has been 
                  selected.

                  To use the new features, just tap on the same score 
                  that you have selected. This will reshow the score hints
                  if SHOW HINTS has been selected. If you have remainder
                  roll turns, you are allowed to resume rolling.

                - Code optimisation. Slightly smaller with more features.
                - Fix menu string truncation on PalmPilot OS 2.x.
                - Dice selection state is now saved/restored.

   30/05/1997 - Version 1.6
              - Added ALL DICE SELECTED. This feature allows those who prefer
                to select dice to keep rather than dice to roll.

   17/05/1997 - Version 1.51
              - Fix for the unpredictable Fatal Exception when the hardware 
                button is used to switch out of yahtC.

   12/05/1997 - Version 1.5 
              - I will like to thanks Randy Phillips for correcting some of
                the errors in my documentation.

              New Features
              - Ability to see how you will score for different score 
                selection. Just tap the score you want and the new score 
                will be calculated. This can be done until you press "Next".
                You can use this to correct your mistakes when selecting
                the score.

              - Auto dice selection. User selectable under PREFERENCES.
                When enabled the dice that you have selected for rolling
                will be selected after the roll.

              - Show hints. User selectable under PREFERENCES. When enabled
                unselected score will be shown after each rolling of dice.

              - Fast Dice. User selectable under PREFERENCES. When enabled
                the dice animation will be disabled.

              - See Pilot's Action. User selectable under PREFERENCES. When
                enabled, the pilot will slow down to let you see which dice
                it is selecting.

              - Sound Effect. User selectable under PREFERENCES.

              - "Roll" request will be ignored when no dice is selected.

              Others
              - Changes to dice graphics. More consistent to actual dice 
                looks.

              Bug Fixes
              - Fix some logic bug related to yahtC bonus.


   08/05/1997 - Version 1.0



11.PROBLEM ?
   =========
   If you wish to contact me, I can be reached at:

        E-Mail   : kokmun@pacific.net.sg
        Web Page : http://home.pacific.net.sg/~kokmun/
