100 Great Games for Palm OS 1/100PalmV1.iso/Cards/ginrummy/ginrummy.txt

Text File | 2000-05-18 | 13KB | 341 lines

GinRummy Copyright (c) 1999-2000 Tan Kok Mun
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

This is version of 1.2 of GinRummy for PalmPilot or
compatibles. Please read REGISTER.TXT for more information
on registration.

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.2
   - NEW. Display support for B&W, 4 and 6 Gray Shades, and Color.
   - NEW. Shades and color for background, card and red suit are
     user selectable.

     NOTE: Color and Gray shade requires PalmOS 3.5 and above and
     the supported hardware.

   - NEW. Tapping anywhere on screen at end game will launch the
     new game screen.
   - NEW. Auto text contrast. When enabled, the text will be white
     when the shade/color od the background is dark.

   - UPDATE. Improve remainder card counter readability.
   - UPDATE. Remove DRAW statistic, which is never used. A
     game is won when the first player reaches the predefined
     target score. A draw will never happen.

   - FIX. Some minor compatibility and stability issues.
   - FIX. End Game message problem when "PalmPilot" won.
   - FIX. Manual sequence selection problem for some condition.


1. GAME FEATURES
   =============
   - Pilot-Computer opponent with two level of skill.
   - Statistics of game won, and highest scores.
   - Customisable Play rules and bonus points.
   - Gin, Standard and Oklahoma rules.
   - Configurable computer move indicator.
   - Auto or manual cards grouping.
   - Single/Double card tap to select.
   - Help guide.
   - Auto/Prompt and Manual knocking and gin.
   - Multiple undo.
   - Sound effect (User selectable).
   - Smart menu. You can just write the menu shortcut character
     without specifying the menu shortcut. eg. Just write "U" or
     "u" to Undo.


2. THE GAME
   ========
   Gin Rummy is one of the most popular forms of Rummy. The object
   of the game is to arrange as many as possible your ten cards
   into sets of sequences and groups.

   In this version, it is a two-player game, and you play against
   the computer.


   THE DECK
   ~~~~~~~~
   One standard deck of 52 cards is used. Cards in each suit rank,
   from low to high as follows:
      Ace 2 3 4 5 6 7 8 9 10 Jack Queen King

   The card values are as follows:
      Face cards(J, Q, K) =  10 points
      Ace                 =   1 point
      Number cards        =  Their spot value


   THE DEAL
   ~~~~~~~~
   You get to start first for the start of a new game. For subsequent
   match the first player is control by the setting in FIRST PLAYER
   option in NEW GAME OPTIONS.

   Each player is dealt ten cards. The 21st card is turned face up to
   start the discard pile and the remainder is placed face down in the
   deck.


   OBJECT OF THE GAME
   ~~~~~~~~~~~~~~~~~~
   The object of the game is to arrange as many as possible your ten
   cards into sets of sequences and groups.

   A sequence consists of three or more cards of the same suit in
   consecutive order, such as 4S, 5S, 6S or 8H, 9H, 10H, JH.

   A group is three or four cards of the same rank, such as 7D, 7H, 7S.

   Note: S-Spade, C-Club, D-Diamond, H-Heart


   PLAY
   ~~~~
   A normal turn consists of two parts:
   1. The Draw. You begin your turn by picking a card from the deck or
      pile into the draw card.
   2. The Discard. To end your turn, one card must be discarded. This
      is from either the draw card or the hand card. You may not be
      able to discard the draw card if it is selected from the pile
      and DISCARD PILE CARD in the NEW GAME OPTIONS is set to NEXT TURN.

   For the first turn, the draw is done in a special way. First, the first
   player can choose to take the card from the pile or to PASS. If the
   first player choose to PASS, the other player will now have the choice
   to take the pile card or to PASS. After this, each turn is play as
   usual.


   KNOCKING
   ~~~~~~~~
   The match ends when a player KNOCKS. This can be done on any turn.

   If you set the KNOCK/GIN to PROMPT/AUTO in PREFERENCES, the computer will
   automatically initiate a Gin for you when you are able to. If you can
   KNOCK, the computer will prompt you.

   If you have set the KNOCK/GIN to manual, you will need to indicate that you
   want to knock by pressing the KNOCK/GIN button at the bottom right corner.
   This button will only be available when the MANUAL KNOCK/GIN is selected.

   To do a manual Knock/Gin, you need to do the following :
   1. Select a card from Pile or Deck.
   2. Select Knock/Gin button. The button will be highlighted to indicate you
      have selected to Knock/Gin. If you decide not to Knock/Gin, select the
      button again.
   3. Complete the Knock/Gin by selecting a card to discard.

   The computer will not allowed you to Knock/Gin if you do not have sufficient
   sets in your Hand.

   After knocking, cards are open up and arrange into sets. Any remaining cards
   not in sets are called Deadwood. You are only allowed to Knock if your
   total Deadwood cards value is less than or equal to the Knock Value. KNOCK
   VALUE is set in the NEW GAME OPTIONS. Knocking with no Deadwood is called
   GOING GIN and earns extra bonus.

   You are never forced to knock. A player who is able to knock can continue
   playing, to try to get a better score.

   The opponent of the player who knocked must open up its card and arrange
   them into sets where possible. Provided the Knocker did not go gin, the
   opponent is allowed to Lay-off any deadwood cards by using them to extend
   the sets of the knocker.

   If the player goes gin, the opponent is not allowed to lay-off any cards.

   The knocker is not allowed to lay-off any cards onto the opponent's sets.

   The winner is the person going gin, or the person with the least Deadwood
   cards value. If the Deadwood value is the same, the opponent's wins. If
   the opponent's wins, this is called UNDERCUT and score extra bonus.


   SCORING
   ~~~~~~~
   For Gin, the player score the value of the opponent's Deadwood cards, plus
   the Gin Bonus. A player who goes Gin can never be undercut, even if the
   opponent has no deadwood.

   For Knocking, the winner score the difference of the two player Deadwood
   cards. If the opponent's won by Undercut, a special bonus is given.

   The game continues with further match until one of the player's score
   reaches the target score. At the end of a game, the score are total and
   additional bonus is awarded. The person who reaches the target score first
   receive a GAME BONUS. For each player, they will receive a BOX BONUS for
   each matches won in the game. SHUT-OUT bonus is given if the looser does
   not win any match in the game.

   After all the bonuses have been added, the winner of the game is the one
   with the highest score and the NET SCORE is calculated which is the
   difference of the two player scores. The NET SCORE is used to enter into
   the HIGH SCORE TALLY.


   OKLAHOMA GIN
   ~~~~~~~~~~~~
   To play Oklahoma Gin, select OKLAHOMA in the KNOCK VALUE of the NEW GAME
   OPTIONS.

   In Oklahoma variation, the first pile card determines the knock value.

   If the first pile card is a spade, the final score for the match (including
   any undercut or gin bonus) is doubled. This is indicated by the x2 symbol
   below the deck.

   If an ace is turned up, you may only knock by going gin.


3. TO PLAY
   =======
   To start a NEW GAME, select MENU-GAME-NEW GAME. Set all options the way
   you want it. Press the i at top left hand corner to find additional
   information for each of the options.

   Select MENU-GAME-PREFERENCES to customised your own preferences. Press
   i at top left hand corner to find additional information for each of the
   preferences.

   In the SORT BY option, you can select the following:
   - Manual      : Cards are not sorted. Select a card and drag it to the
                   new location.
                   Note: During undo, the card may not appear as you have
                         arrange.

   - SUITE       : Your cards are display in Suite order.
   - NUMBER      : Your cards are display in Number order.
   - AUTO SUITE  : Similar to SUITE order, except the computer will form
                   sets for you and place it to the left. There is an
                   indicator on the top of the cards to inform you how
                   the sets are formed. Deadwood cards are sorted in
                   Suite order.
   - AUTO NUMBER : Similar to AUTO SUITE, except Deadwood cards are sorted
                   in Number order.

   The current player turn is highlighted and the total score so far is at
   the right of the player name. There is a bar under each player, it gives
   a visual indicator how far the player had scored to reach the target score.

   A normal turn consists of two parts:
   1. The Draw. You begin your turn by picking a card from the deck or
      pile into the draw card.
   2. The Discard. To end your turn, one card must be discarded. This
      is from either the draw card or the hand card. You may not be
      able to discard the draw card if it is selected from the pile
      and DISCARD PILE CARD in the NEW GAME OPTIONS is set to NEXT TURN.

   For the first turn, the draw is done in a special way. First, the first
   player can choose to take the card from the pile or to PASS. If the
   first player choose to PASS, the other player will now have the choice
   to take the pile card or to PASS. After this, each turn is play as
   usual.


4. INSTALLATION
   ============
   Install ginrummy.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
   ===================
   GinRummy is a ShareWare. After registration, 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
   registration 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
   =======
   18th. May, 2000 - Version 1.2

   02nd. Oct, 1999 - Version 1.1
      - Fix stability problem when running in PalmOS 2.x and below.

      - Manual sort option. When it is your turn. Just select the card and
        drag it to the new location.
        Note: During undo, the card may not appear as you have arrange.

   21st. Aug, 1999 - Version 1.0.1
      - Fix compatibility for PalmOS 1.x and 2.x.

   18th. Aug, 1999 - Version 1.0
      - First public release.


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

        E-Mail   : [e-mail]
        Web Page : http://home.pacific.net.sg/~kokmun/