home *** CD-ROM | disk | FTP | other *** search
/ Chip 2001 Mobile / Chip_Mobile_2001.iso / palm / spiele / yahtchal / yahtchal.exe / yahtc.txt < prev    next >
Text File  |  2000-11-03  |  20KB  |  535 lines
  1. yahtChallenge Copyright (c) 1996-2000 Tan Kok Mun
  2. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  3.  
  4. This is version 2.0.1 of yahtC for Pilot/PalmPilot. Please read
  5. REGISTER.TXT for more information on registeration.
  6.  
  7. The latest version of this software can be found at :
  8.      http://home.pacific.net.sg/~kokmun/palmpilot.htm
  9.  
  10.  
  11. CONTENTS
  12. ========
  13.  0. WHAT'S NEW
  14.  1. GAME FEATURES
  15.  2. THE GAME
  16.  3. TO PLAY
  17.  4. INSTALLATION
  18.  5. DISCLAIMER
  19.  6. REGISTERATION INFORMATION
  20.  7. DISTRIBUTION
  21.  8. SHAREWARE AGREEMENT
  22.  9. LICENSING AGREEMENT
  23. 10. HISTORY
  24. 11. PROBLEM ?
  25.  
  26.  
  27.  
  28. 0. WHAT'S NEW
  29.    ==========
  30.    Version 2.0.1
  31.    - Fix scoring problem when you managed to get multiple yahtC, with
  32.      Standard rule.
  33.  
  34.      The yahtC score will reduce when you next roll and score.
  35.      This only happens when HINTING is not enabled and you are playing
  36.      alone or against another human player.
  37.  
  38.      To bypass this problem in version 2.0, you need to enable HINTING.
  39.  
  40.  
  41.    Version 2.0
  42.    - The minimum required PalmOS version is 2.0. PalmOS 1.0 is dropped from this
  43.      release because some of the features required is not available in PalmOS 1.0.
  44.  
  45.    - Color, Gray-scale and Black & White supported.
  46.  
  47.    - Fix crashes for PalmOS 3.0 and 3.3 in some machine
  48.    - Fix high score statistics display problem in PalmOS 3.5
  49.  
  50.    - Revised score comparison, you can tap anywhere on screen to continue.
  51.    - Revised random number generator.
  52.    - Support players name.
  53.    - You can now see the player score by selecting the user name.
  54.    - Support hinting threshold. Score higher than the specified percentage will 
  55.      be shown differently from others. In B&W display mode, the score will be 
  56.      in bold. In gray/color mode the score will be in bold and the hinting will
  57.      be in different shade/color. User can defined the shade/color for both high
  58.      and low hint value.
  59.  
  60.    - Smart menu. You can just write the menu shortcut character without 
  61.      specifying the menu shortcut. eg. Just write "N" or "n" for New Challenge.
  62.  
  63.    - User selectable shade/color for score area, status area, dice area and dice
  64.  
  65.    - Revise dice selection action. You can now specify the selected dice to hold 
  66.      or to roll. Default is select to hold. While in the game, press any dice for
  67.      more than 1 seconds to see the current select dice action. Dice selection
  68.      action can be changed in the Preference.
  69.  
  70.    - Two game type. The standard Challenge and a new Race game. Please refer to
  71.      section 2 (THE GAME) for the rules and decription of Race Game.
  72.  
  73.  
  74. 1. GAME FEATURES
  75.    =============
  76.    - One or two players. You can name your player.
  77.    - PalmPilot-Computer oponent.
  78.    - Statistics of game won, and highest scores.
  79.    - Selectable PalmPilot skill level.
  80.    - Full game status are stored/restored automatically.
  81.    - Animated dice.
  82.    - Ability to see how you will score for different score 
  83.      categories. 
  84.    - Auto dice selection. User selectable under PREFERENCES.
  85.    - Option to select dice to roll or dice to keep.
  86.    - Show scoring hints. User selectable under PREFERENCES.
  87.      Able to reshow hints after a score has been selected.
  88.      The hinting now support threshold to show low and high score.
  89.    - Resume rolling of unused roll after a score has been 
  90.      selected.
  91.    - Game sound.
  92.    - Support "Classic" and "Standard" rules.
  93.    - Auto rolling of dice, after pilot has made it's move.
  94.    - Color, Gray-scale and Black & White supported.
  95.    - You can now see the player score by selecting the user name.
  96.    - Smart menu. You can just write the menu shortcut character without 
  97.      specifying the menu shortcut. eg. Just write "N" or "n" for New Challenge.
  98.    - User selectable shade/color for score area, status area, dice area and dice
  99.    - Two game type. The standard Challenge and a new Race game.
  100.  
  101.  
  102. 2. THE GAME
  103.    ========
  104.    yahtC is a luck and strategy game for one or two "players. The 
  105.    objective is to score as many points as possible.
  106.  
  107.    Each player can roll the dice 3 times. After each of the first 
  108.    and second rolls, the player select the dice to be rolled again.
  109.    The number of times each player can roll the dice is selectable 
  110.    at the start of a new game.
  111.  
  112.    When the player has a satisfactory dice combination (or after the
  113.    last roll), he/she must select one of the scoring categories to 
  114.    put the points in. Each scoring category can only be used once, 
  115.    except for YahtC where a different rule applies.
  116.  
  117.    A yahtC is a 5-of-a-Kind, and for the first yahtC it scores 50 points.
  118.  
  119.    STANDARD RULES
  120.    ~~~~~~~~~~~~~~
  121.    - Each subsequent yahtC earns 50 points each and another turn,
  122.      provided that you did not zero the yahtC category.
  123.  
  124.  
  125.    CLASSIC RULES
  126.    ~~~~~~~~~~~~~
  127.    - Each subsequent yahtC earns you 100 points provided you have not
  128.      zero the yahtC Category. You can use subsequent yahtC as a Joker
  129.      provided :
  130.  
  131.      1. You have scored on the yahtC category (including zero).
  132.      2. You have filled the corresponding category in the left scores
  133.         section. For example, if you have rolled:
  134.  
  135.           [5] [5] [5] [5] [5]
  136.  
  137.         the Fives category must also be filled.
  138.  
  139.         If this is the case, you can use the yahtC as a joker to fill
  140.         in any right scores category. You score the category as normal.
  141.         Thus for the Small Straight, Large Straight, and Full House
  142.         categories, you would score 30, 40, and 25 points respectively.
  143.         For the 3 of a Kind, 4 of a Kind, and Chance categories,
  144.         you would score the total of the die face.
  145.  
  146.    - If you have scored a zero in the yahtC category, you cannot receive
  147.      any bonuses.
  148.  
  149.    - You will not get another turn for subsequent yahtC in "Classic" Rules.
  150.  
  151.  
  152.    Scoring is as follows :
  153.  
  154.        LEFT COLUMN
  155.        -----------
  156.        ONES        : Total of all dice showing 1 pip.
  157.        TWOS        : Total of all dice showing 2 pips.
  158.        THREES      : Total of all dice showing 3 pips.
  159.        FOURS       : Total of all dice showing 4 pips.
  160.        FIVES       : Total of all dice showing 5 pips.
  161.        SIXES       : Total of all dice showing 6 pips.
  162.        TOTAL       : Left column total.
  163.        BONUS       : 35 points if left column total is 63 or more.
  164.  
  165.        RIGHT COLUMN
  166.        ------------
  167.        3 OF A KIND : 3 or more dice are the same; score is sum of all 
  168.                      5 dice.
  169.        4 OF A KIND : 4 or more dice are the same; score is sum of the 
  170.                      5 dice.
  171.        FULL HOUSE  : 25 points if you have 3 dices of one value and 
  172.                      the other 2 dice of another value.
  173.        SMALL STR   : 30 points if you have 4 or 5 dice in numerical order.
  174.        LARGE STR   : 40 points if you have all 5 dice in numerical order.
  175.        YAHTC       : 5 dices with the same value. See scoring detail above.
  176.        CHANCE      : Sum of the five dices.
  177.        TOTAL       : Right column total.
  178.  
  179.  
  180.    CHALLENGE GAME
  181.    - In Challenge game, you can play alone or against another player. The
  182.      number of games to play per challenge is set in NEW CHALLENGE options
  183.      of GAMES PER CHALLENGE.
  184.  
  185.      The player with the highest score at the end of the complete
  186.      games is the winner.
  187.  
  188.  
  189.    RACE GAME
  190.    - In Race game, you play against another player to be the first to score
  191.      the RACE TARGET score.
  192.  
  193.    - Winner is decided only at the end of the second player roll.
  194.  
  195.    - All the standard challenge rules applied.
  196.  
  197.    - The LEFT/RIGHT COLUMN score will be reset when you have completed
  198.      scoring the column, provided, only one or none of the score in that
  199.      column is zero.
  200.  
  201.      If you have more than one zero in one column, that column will only
  202.      reset when the other column is filled.
  203.  
  204.  
  205. 3. TO PLAY
  206.    =======
  207.    To play, press ROLL to roll your dice. Select the dice you want to
  208.    re-roll and press ROLL. In total you can roll your dices three times
  209.    in a turn (or 4 times if you set 4 rolls at the beginning of the game).
  210.  
  211.    The MENU commands are as follows :
  212.  
  213.    COMMANDS
  214.    ~~~~~~~~
  215.    - NEW CHALLENGE : Play a new challenge.
  216.  
  217.                  Select the New Game Settings and select OK to start a new
  218.                  game. Select CANCEL if you do not want to start a new game.
  219.  
  220.                  New Game Settings
  221.                  =================
  222.                  PLAYER1/2 
  223.                  - Player's name.
  224.  
  225.                  PALMPILOT MOOD
  226.                  - Set the PalmPilot playing behaviour.
  227.                  - No-risk: Save and easy way route.
  228.                  - Nowhere: On the fence on it's decision.
  229.                  - Thinker: Calculative player.
  230.                  - Gambler: High risk taker.
  231.                  - ycLover: All out for yahtC.
  232.  
  233.                  MAXIMUM DICE ROLLING 
  234.                  - Maximum number of times you can roll the dices for each turn.
  235.  
  236.                  DICE BANK 
  237.                  - Set how many unused roll to bring forward for next turn.
  238.                  - eg. If DICE BANK is 2 and MAXIMUM DICE ROLLING is 3 and 
  239.                        you have 3 unused roll, in the next turn you will 
  240.                        have 5 rolls.
  241.  
  242.                  GAME TYPE
  243.                  - Challenge: Classic yahtC, where you play alone or against
  244.                    another player. Winner is decided after the defined GAMES PER
  245.                    CHALLENGE is played.
  246.                  - Race: You play against another player to score the RACE 
  247.                    TARGET.
  248.  
  249.                  GAMES PER CHALLENGE
  250.                  - Set the games to play before the winner is decided, for 
  251.                    CHALLENGE game.
  252.  
  253.                  RACE TARGET
  254.                  - Set the target score for RACE game.
  255.  
  256.                  RULES 
  257.                  - Select the rules for yahtC. Refer to YAHTC.TXT for details.
  258.  
  259.    - SCORE COMPARISON : Shows the current score comparison. Tap anywhere on
  260.         screen to continue.
  261.  
  262.    - STATISTICS       : Show the game statistics. You will be shown the
  263.                         number of challenge you have won, and the highest
  264.                         score.
  265.  
  266.                         You can reset the score by pressing the RESET button.
  267.  
  268.    - PREFERENCES : Game settings. Some of the settings will only be effective
  269.         at the next roll.
  270.  
  271.         SELECTED DICE TO
  272.         - Select what to do with selected dice. Use ROLL-ALL SELECTED for 
  273.           behaviour similar to old version.
  274.  
  275.         RESELECT DICE AFTER ROLLING 
  276.         - Auto reselect dice you have selected after each roll.
  277.  
  278.         SCORE HINTING 
  279.         - Show points in unused score categories.
  280.         - Select percentage value to differentiate between low and high 
  281.           score. Score higher than the percentage will be in bold and 
  282.           different shade/color.
  283.  
  284.         DICE ROLLING SPEED 
  285.         - Control the speed of dice rolling.
  286.  
  287.         SHOW PALMPILOT's ACTION 
  288.         - Controls the display of steps taken by PalmPilot.
  289.  
  290.         ROLL AFTER PALMPILOT MOVES 
  291.         - Controls the rolling of dice at the end of PalmPilot turn. 
  292.           When YES is selected, you do not need to press NEXT for your turn.
  293.  
  294.         STOP DICE ROLLING 
  295.         - Controls how the dice rolling is to be stopped. When MANUAL is 
  296.           selected, you need to press the key or tap anywhere on screen to 
  297.           stop the rolling of dice.
  298.  
  299.         DISPLAY MODE 
  300.         - Auto will use the highest possible display mode. 
  301.         - B&W is black and white. Gray is shades of Gray.
  302.  
  303.    HELP
  304.    ~~~~
  305.    - RULES   : Text about the game play.
  306.    - ABOUT   : Author information.
  307.  
  308.  
  309.    SMART MENU
  310.    ~~~~~~~~~~
  311.    This game support the smart menu feature. You do not need to write the menu
  312.    shortcut character to launch the menu. Just write the shortcut character of
  313.    menu to launch the respective menu.
  314.  
  315.         MENU              SHORTCUT
  316.         ----------------  --------
  317.         New Challenge     N
  318.         Score Comparison  S
  319.         Statistics        T
  320.         Hall of Fame      F
  321.         Preferences       P
  322.         Set Shade/Color   C
  323.         Rules             R
  324.         About             A
  325.       
  326.  
  327.    BUTTON
  328.    ~~~~~~
  329.    The BUTTON on the screen is dynamic and chances acording to where you
  330.    are in the game. Possible BUTTONs are :
  331.  
  332.      NEW  : Select a new game. Only appears when the current game has ended.
  333.      ROLL : Roll the dice.
  334.      NEXT : Next player turn and roll the dice.
  335.  
  336.  
  337.  
  338. 4. INSTALLATION
  339.    ============
  340.    Install yahtc.prc using the standard pilot application installer.
  341.  
  342.  
  343.  
  344. 5. DISCLAIMER
  345.    ==========
  346.    The author will not take responsibility for any form of damage or loss 
  347.    that occurs when/by using this program. By using the program, you have 
  348.    agreed on all the conditions stated here.
  349.  
  350.  
  351.  
  352. 6. REGISTERATION INFORMATION
  353.    =========================
  354.    For registration information, please read the REGISTER.TXT file.
  355.  
  356.  
  357. 7. DISTRIBUTION
  358.    ============
  359.    This manual and all accompanying files may be distributed freely,
  360.    provided that:
  361.    - Neither text nor any other file is modified in any way. No file
  362.      may be omitted nor added in the distribution.
  363.  
  364.    - No money may be charged for the program nor for any accompanying
  365.      files, other than the usual downloading time fees charged by
  366.      commercial BBSes and online services.
  367.  
  368.    - I want to know where my program will be distributed. Please notify me
  369.      if it will be included in printed matter, floppy, or CD-ROM before its
  370.      publication. No matter what the circumstance, I would strongly
  371.      appreciate a copy of whatever collection in which it is included.
  372.  
  373.  
  374.  
  375. 8. SHAREWARE AGREEMENT
  376.    ===================
  377.    yahtC is a ShareWare. After registeration, you are licence to use it. 
  378.    All ownership and Copyright of the software belongs to Tan Kok Mun. 
  379.    Please read LICENSING AGREEMENT below. Each registered copy can only
  380.    be used in a single machine.
  381.  
  382.  
  383.    
  384. 9. LICENSING AGREEMENT
  385.    ===================
  386.    The software accompanying this document (the Software) and the related  
  387.    documentation are licensed to you by Tan Kok Mun (the author) after the
  388.    registeration or during the trial period of the first 30 usage from the 
  389.    date of installation.
  390.    
  391.    The software contains copyrighted material and other proprietary material. 
  392.  
  393.  
  394.  
  395. 10.HISTORY
  396.    =======
  397.    31/10/2000 - Version 2.0
  398.  
  399.    16/03/1999 - Version 1.9.1
  400.               - Bug fix on sound setting.
  401.               - Bug fix on fast dice setting.
  402.               - Bug fix on Statistics display.
  403.               - Dice Bank. Allows you to bring forward unused roll to
  404.                 next turn.
  405.               - Hall of Fame. Keep track of the last 10 top scores.
  406.               - Manual dice rolling. When enabled, you will need to
  407.                 tap the screen or press any key to stop the rolling
  408.                 of dice.
  409.               - Updated play engine, Pilot is now slightly smarter.
  410.  
  411.    06/03/1999 - Version 1.9
  412.               - Fix display problem when using menu shortcut.
  413.  
  414.               - The PRC is now smaller than before. 20K compare to previous
  415.                 version which is 32K.
  416.  
  417.               - Support Palm III list icons.
  418.  
  419.               - Resolve compatibility issues with Palm EZ processor.
  420.  
  421.               - The auto hints is effective immediately when changed in the
  422.                 Preferences.
  423.  
  424.    27/07/1997 - Version 1.8
  425.               - You can now play the "Classic" rules of yahtC. 
  426.                 Please refer to "THE GAME" section for more 
  427.                 information. This is user selectable.
  428.  
  429.               - Adjusted the Random Generator. Hopefully it is 
  430.                 more random. Let me know if this help ?
  431.  
  432.               - You can now use the hardware up/down key to 
  433.                 replace key pressing of "Next", "Roll" or "New" 
  434.                 button. This is handy when you are holding the 
  435.                 PalmPilot with your thumbs on the up/down key. 
  436.                 You can press the key with your thumb after 
  437.                 doing all the required selection.
  438.  
  439.               - You can now challenge the pilot to a set of games. 
  440.                 The winner is decided after the user selectable 
  441.                 number of games have been played.
  442.  
  443.               - Updated statistics information.
  444.  
  445.               - The pilot can roll the dice for you after it has 
  446.                 moved. This is useful if you do not care about what 
  447.                 pilot selection is. To still see the pilot selection
  448.                 and auto roll, the "See Pilot's Action" needs to be 
  449.                 enabled.
  450.  
  451.               - If both "Fast Dice" and "See Pilot's Action" are not 
  452.                 enabled, you will only see your dice rolling animation. 
  453.                 Pilot dice rolling animation will be disabled when "See 
  454.                 Pilot's Action" is disabled.
  455.  
  456.    21/06/1997 - Version 1.7.1
  457.                 - Fix the following :
  458.                 - Pilot score was not updated correctly when
  459.                   second yahtc was scored.
  460.  
  461.                 - Force to start a new game when pilot scored 
  462.                   multiple yahtc.
  463.  
  464.                   No wonder the PILOT has been losing. . . 8-)
  465.  
  466.    11/06/1997 - Version 1.7
  467.                 - Reshow scoring hints after a score has been selected.
  468.                 - Resume rolling of unused roll after a score has been 
  469.                   selected.
  470.  
  471.                   To use the new features, just tap on the same score 
  472.                   that you have selected. This will reshow the score hints
  473.                   if SHOW HINTS has been selected. If you have remainder
  474.                   roll turns, you are allowed to resume rolling.
  475.  
  476.                 - Code optimisation. Slightly smaller with more features.
  477.                 - Fix menu string truncation on PalmPilot OS 2.x.
  478.                 - Dice selection state is now saved/restored.
  479.  
  480.    30/05/1997 - Version 1.6
  481.               - Added ALL DICE SELECTED. This feature allows those who prefer
  482.                 to select dice to keep rather than dice to roll.
  483.  
  484.    17/05/1997 - Version 1.51
  485.               - Fix for the unpredictable Fatal Exception when the hardware 
  486.                 button is used to switch out of yahtC.
  487.  
  488.    12/05/1997 - Version 1.5 
  489.               - I will like to thanks Randy Phillips for correcting some of
  490.                 the errors in my documentation.
  491.  
  492.               New Features
  493.               - Ability to see how you will score for different score 
  494.                 selection. Just tap the score you want and the new score 
  495.                 will be calculated. This can be done until you press "Next".
  496.                 You can use this to correct your mistakes when selecting
  497.                 the score.
  498.  
  499.               - Auto dice selection. User selectable under PREFERENCES.
  500.                 When enabled the dice that you have selected for rolling
  501.                 will be selected after the roll.
  502.  
  503.               - Show hints. User selectable under PREFERENCES. When enabled
  504.                 unselected score will be shown after each rolling of dice.
  505.  
  506.               - Fast Dice. User selectable under PREFERENCES. When enabled
  507.                 the dice animation will be disabled.
  508.  
  509.               - See Pilot's Action. User selectable under PREFERENCES. When
  510.                 enabled, the pilot will slow down to let you see which dice
  511.                 it is selecting.
  512.  
  513.               - Sound Effect. User selectable under PREFERENCES.
  514.  
  515.               - "Roll" request will be ignored when no dice is selected.
  516.  
  517.               Others
  518.               - Changes to dice graphics. More consistent to actual dice 
  519.                 looks.
  520.  
  521.               Bug Fixes
  522.               - Fix some logic bug related to yahtC bonus.
  523.  
  524.  
  525.    08/05/1997 - Version 1.0
  526.  
  527.  
  528.  
  529. 11.PROBLEM ?
  530.    =========
  531.    If you wish to contact me, I can be reached at:
  532.  
  533.         E-Mail   : kokmun@pacific.net.sg
  534.         Web Page : http://home.pacific.net.sg/~kokmun/
  535.