yahtChallenge Copyright (c) 1996-2000 Tan Kok Mun ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ This is version 2.0.1 of yahtC for Pilot/PalmPilot. Please read REGISTER.TXT for more information on registeration. 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 2.0.1 - Fix scoring problem when you managed to get multiple yahtC, with Standard rule. The yahtC score will reduce when you next roll and score. This only happens when HINTING is not enabled and you are playing alone or against another human player. To bypass this problem in version 2.0, you need to enable HINTING. Version 2.0 - The minimum required PalmOS version is 2.0. PalmOS 1.0 is dropped from this release because some of the features required is not available in PalmOS 1.0. - Color, Gray-scale and Black & White supported. - Fix crashes for PalmOS 3.0 and 3.3 in some machine - Fix high score statistics display problem in PalmOS 3.5 - Revised score comparison, you can tap anywhere on screen to continue. - Revised random number generator. - Support players name. - You can now see the player score by selecting the user name. - Support hinting threshold. Score higher than the specified percentage will be shown differently from others. In B&W display mode, the score will be in bold. In gray/color mode the score will be in bold and the hinting will be in different shade/color. User can defined the shade/color for both high and low hint value. - Smart menu. You can just write the menu shortcut character without specifying the menu shortcut. eg. Just write "N" or "n" for New Challenge. - User selectable shade/color for score area, status area, dice area and dice - Revise dice selection action. You can now specify the selected dice to hold or to roll. Default is select to hold. While in the game, press any dice for more than 1 seconds to see the current select dice action. Dice selection action can be changed in the Preference. - Two game type. The standard Challenge and a new Race game. Please refer to section 2 (THE GAME) for the rules and decription of Race Game. 1. GAME FEATURES ============= - One or two players. You can name your player. - PalmPilot-Computer oponent. - Statistics of game won, and highest scores. - Selectable PalmPilot skill level. - 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. The hinting now support threshold to show low and high score. - Resume rolling of unused roll after a score has been selected. - Game sound. - Support "Classic" and "Standard" rules. - Auto rolling of dice, after pilot has made it's move. - Color, Gray-scale and Black & White supported. - You can now see the player score by selecting the user name. - Smart menu. You can just write the menu shortcut character without specifying the menu shortcut. eg. Just write "N" or "n" for New Challenge. - User selectable shade/color for score area, status area, dice area and dice - Two game type. The standard Challenge and a new Race game. 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. CHALLENGE GAME - In Challenge game, you can play alone or against another player. The number of games to play per challenge is set in NEW CHALLENGE options of GAMES PER CHALLENGE. The player with the highest score at the end of the complete games is the winner. RACE GAME - In Race game, you play against another player to be the first to score the RACE TARGET score. - Winner is decided only at the end of the second player roll. - All the standard challenge rules applied. - The LEFT/RIGHT COLUMN score will be reset when you have completed scoring the column, provided, only one or none of the score in that column is zero. If you have more than one zero in one column, that column will only reset when the other column is filled. 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/2 - Player's name. PALMPILOT MOOD - Set the PalmPilot playing behaviour. - No-risk: Save and easy way route. - Nowhere: On the fence on it's decision. - Thinker: Calculative player. - Gambler: High risk taker. - ycLover: All out for yahtC. MAXIMUM DICE ROLLING - Maximum number of times you can roll the dices for each turn. DICE BANK - Set how many unused roll to bring forward for next turn. - eg. If DICE BANK is 2 and MAXIMUM DICE ROLLING is 3 and you have 3 unused roll, in the next turn you will have 5 rolls. GAME TYPE - Challenge: Classic yahtC, where you play alone or against another player. Winner is decided after the defined GAMES PER CHALLENGE is played. - Race: You play against another player to score the RACE TARGET. GAMES PER CHALLENGE - Set the games to play before the winner is decided, for CHALLENGE game. RACE TARGET - Set the target score for RACE game. RULES - Select the rules for yahtC. Refer to YAHTC.TXT for details. - SCORE COMPARISON : Shows the current score comparison. Tap anywhere on screen to continue. - 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. Some of the settings will only be effective at the next roll. SELECTED DICE TO - Select what to do with selected dice. Use ROLL-ALL SELECTED for behaviour similar to old version. RESELECT DICE AFTER ROLLING - Auto reselect dice you have selected after each roll. SCORE HINTING - Show points in unused score categories. - Select percentage value to differentiate between low and high score. Score higher than the percentage will be in bold and different shade/color. DICE ROLLING SPEED - Control the speed of dice rolling. SHOW PALMPILOT's ACTION - Controls the display of steps taken by PalmPilot. ROLL AFTER PALMPILOT MOVES - Controls the rolling of dice at the end of PalmPilot turn. When YES is selected, you do not need to press NEXT for your turn. STOP DICE ROLLING - Controls how the dice rolling is to be stopped. When MANUAL is selected, you need to press the key or tap anywhere on screen to stop the rolling of dice. DISPLAY MODE - Auto will use the highest possible display mode. - B&W is black and white. Gray is shades of Gray. HELP ~~~~ - RULES : Text about the game play. - ABOUT : Author information. SMART MENU ~~~~~~~~~~ This game support the smart menu feature. You do not need to write the menu shortcut character to launch the menu. Just write the shortcut character of menu to launch the respective menu. MENU SHORTCUT ---------------- -------- New Challenge N Score Comparison S Statistics T Hall of Fame F Preferences P Set Shade/Color C Rules R About A 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 ======= 31/10/2000 - Version 2.0 16/03/1999 - Version 1.9.1 - Bug fix on sound setting. - Bug fix on fast dice setting. - Bug fix on Statistics display. - Dice Bank. Allows you to bring forward unused roll to next turn. - Hall of Fame. Keep track of the last 10 top scores. - Manual dice rolling. When enabled, you will need to tap the screen or press any key to stop the rolling of dice. - Updated play engine, Pilot is now slightly smarter. 06/03/1999 - Version 1.9 - Fix display problem when using menu shortcut. - The PRC is now smaller than before. 20K compare to previous version which is 32K. - Support Palm III list icons. - Resolve compatibility issues with Palm EZ processor. - The auto hints is effective immediately when changed in the Preferences. 27/07/1997 - 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. 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/