GinRummy

Play the classic card game ginrummy on your palm.

GinRummy Copyright (c) 1999 Tan Kok Mun

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

This is version of 1.1 of GinRummy for Pilot/PalmPilot. 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.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.

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

=======

02/10/1999 - Version 1.1

21/08/1999 - Version 1.0.1

- Fix compatibility for PalmOS 1.x and 2.x.

18/08/1999 - Version 1.0

- First public release.

11.PROBLEM ?

=========

If you wish to contact me, I can be reached at:

E-Mail : [email protected]

Web Page : http://home.pacific.net.sg/~kokmun/