# The &kappname; Handbook

Paul Olav
Tvete
Maren
Pakura
Stephan
Kulow
Mike
McBride
Reviewer

    &Mike.McBride.mail;

Paul Olav
Tvete
Developer
Stephan
Kulow
Developer
2000
&Paul-Olav.Tvete;
2001
2004
&Maren.Pakura;
2007
&Stephan.Kulow;
&FDLNotice;
&docupdate;
&docversion;

This documentation describes the game of &kappname; version &kappversion;

KDE
kdegames
game
KPatience
card
card game
playing cards
one player
patience
solitaire

## Introduction

### Gametype:

Card

### Number of possible players:

One

To play patience you need, as the name suggests, patience. For simple games, where the way the game goes depends only upon how the cards fall, your patience might be the only thing you need.

There are also patience games where you must plan your strategy and think ahead in order to win.

A theme common to all the games is the player must put the cards in a special order — moving, turning and reordering them.

## How to Play

### Objective:

Rearrange the cards by suite within shortest time possible.

As &kappname; offers you a multiplicity of different solitaire games, there is no straightforward how-to which could fit all of them. Therefore, it is essential that you read each individual subsection of Game Rules, Strategies and Tips section before you start playing a version you are not familiar with.

Essentially there are two types of solitaire games – the ones that let you arrange the cards by same color and the ones that let you arrange the cards by alternating color. You can easily determine which game you are trying out using trial-and-error method. Once you know which one you are dealing with, rest is easy; keep arranging and rearranging the cards, collecting the matching ones.

From the beginning, however, pay attention to your card stacks. Do not rush to move individual cards around, see if it might be more useful elsewhere.

For additional help you can also take quick peeks onto the statusbar. For the most of the games there is a built in solver which informs you whether the game you are currently playing can be completed or not. If you see that solver could not complete the current game, chances are you will not be able to do so as well. At this point you can either restart the current game, or start a completely new game.

### Note:

Playing solitaire games helps you to greatly improve your attention span and enhance the ability to concentrate.

## Game Rules, Strategies and Tips

### General Rules

A card game contains one or more card decks of 52 cards each. Each deck contains the four suits:

| Clubs
| Spades
| Hearts
| Diamonds

Each of these suits contains the following card types: ace, two, three, four, five, six, seven, eight, nine, ten, jack, queen, and king.

This complete order of cards is called a family. There are real families and alternating ones. The real families are all of one suit (&eg; Hearts). In the alternating families the card color changes from one to another, between a black color (Clubs and Spades) and a red color (Hearts and Diamonds).

If the family is not complete it is called a sequence.

The game field of &kpatience;

There are a number of features found in typical patience games. These are described below.

1. Talon

  At the beginning of each game all cards are mixed in the deck. In some games not all cards are dealt out. The remaining cards are put down on the so-called talon. You can find this quite easily, since in most games it is the only pile showing the reverse.

  If no card shows the reverse side, all cards are dealt out and there is no talon. These card games are the hardest as there is no randomness involved after the start of the game, so there is nothing to blame.

2. Waste Pile

  Many games put cards from the talon on a waste pile, after you click on the reverse of the topmost card on the talon.

  From there you can take the card (which is then face up) and put it into the game.

3. Foundation

  The foundation pile is where you want to have your cards in the end. If all cards end up there in the right order, you've won. Some games use more than one foundation pile.

  In most card games these piles are empty in the beginning. &kpatience; drops cards there for you when it sees they fit.

4. Playing Piles

  These piles are those where the actual reordering happens. The rules for these piles vary a lot between games. Some show all cards on them, some do not. Some allow only one card to be removed, some allow every card to be removed, &etc;.

### Rules for Individual Games

#### Klondike

Klondike is the most famous patience — most likely because it comes with a well-known operating system. It is played with one deck.

The goal in Klondike is to put all cards, as real families, ascending on the foundation. This gets easier once all cards are lying face up in the playing piles.

The sequences on the playing piles have to be put there in descending order. The cards should alternate in colors (red and black). You can move whole sequences or parts of it, if the first card fits on another pile.

On a free pile you can put a king of any color, or a sequence starting with a king.

When you click on the talon, one card from it will be moved to the waste pile. You can move it to the playing piles or the foundation from there. If the talon is empty, you can move the complete waste pile to the talon by clicking on the empty talon.

You can look through the cards on the talon as much as you like.

#### Grandfather

This game was introduced to &Paul-Olav.Tvete;, the original developer of &kpatience;, by his grandfather; it is named after this. No other patience games are known to implement this patience game variant.

In Grandfather, one deck is dealt to seven playing piles. Some cards on each pile are face down on the initial deal.

The goal is to put all cards as real families ascending on the foundation piles.

You can move every card on every pile if it fits on another card, to build a real sequence of descending order. For example, you can move the five of spades on top of the six of spades, no matter how many cards on are on top of the five of spades. Just the six of spades has to be on top of its pile.

On a free pile you can place a king (again no matter how many cards are on top of it).

If no more cards can be moved, you can re-deal up to two times. All cards already in the foundations stay there, but the cards in the playing piles are reordered to give you a new chance to find a solution.

Even though the rules are simple and allow many moves, the game is still hard to win. Despite this, or because of it, this game remains a joy to play.

#### Aces Up

This patience has simple rules, yet is hard to win. It is played with one deck. The goal is to put all cards besides aces onto the foundation. There should be an ace left on every playing pile afterwards.

Each top card that is of the same suit (&eg; spades) and has a lower value than another top card (&eg; six of spades and four of spades) can be put on the foundation by clicking on it.

If you cannot move any more cards to the foundation, you can get a new card for each playing pile by clicking on the talon.

On a free pile you can move every other card on top of a pile. You should use these moves to free piles. That way, new cards can be moved to the foundation.

The auto drop feature is disabled in this patience game.

#### Freecell

Freecell is played with one card deck. You have four free cells in the top left corner. In addition there are four foundation piles, and eight playing piles below.

The goal of the game is to have all cards as real families ascending on the foundation. You can achieve this often if you know how to play: Freecell is solvable at a rate of 99.9% approximately — of the first 32,000 deals there is only one unsolvable (11,982 if you want to know).

In the playing piles you have to build descending sequences, where red and black cards alternate. You can put any card in a free cell.

You can only move one card that lays on top of a pile or a free cell. Sequences can only be moved if you have enough free space (either free cells or free playing piles) to place the cards.

The maximum amount of cards you can move is calculated by:

(#{free cells} + 1) * 2#{free piles}

To solve this game it is recommended to grab the cards out of the playing sequences in the same order they have to be put into the foundation (first the aces, then the twos, &etc;)

You should try to keep as many free cells and/or playing piles empty, so you can build sequences as long as possible.

#### Mod3

Mod3 is played with two card decks. The goal is to put all cards on the top three rows. In those you have to build sequences of the same color. In the first row you have to create the sequence 2-5-8-B, in the second row the sequence 3-6-9-D, and in the third row the sequence 4-7-10-K. The suit of the cards must be the same in each sequence, so you can only put a five of hearts on top of a two of hearts.

The fourth row is both your waste pile and playing pile. On an empty slot you can put any card from the first three rows, or one from the top of the fourth row.

You can put aces on the aces piles, on top of the talon. They are in the game so you have a starting point for creating free slots.

If you cannot move any more cards, you can get new cards on the fourth row by clicking on the talon.

The auto drop feature is disabled in this patience game.

#### Gypsy

Gypsy is played with two card decks. The aim is to put all cards in real families ascending on the foundation.

The playing piles have to be descending, while red and black cards have to alternate. You can only move sequences or single cards. On a free slot you can put any card or sequence.

If you cannot move any more cards, you can click on the talon to get new cards on each playing pile.

In using the Undo feature you can ease the game quite a lot, as you have to take many decisions and some of them might turn out to be wrong after you clicked the talon.

#### Forty & Eight

Forty & Eight is played with two card decks. The goal is to put all cards as real families on the foundation.

The playing piles have to be descending. Colors are important. You can only put a five of hearts on a six of hearts, for example.

You can only move one card on top of a pile. You can put any card in a free slot.

By clicking on the talon you can put a card on the waste pile; from there you can put it on a playing pile or the foundation (&kpatience; will do this for you). If the talon is empty you can put all cards on the waste pile back on the talon. This works only once: after the second time the talon empties, the game is over.

This patience is difficult to solve. With some experience you can solve many of the deals, especially if you use the Undo feature from time to time to correct your decisions, and the decisions &kpatience; makes in putting cards on the foundation.

#### Simple Simon

Simple Simon is played with one card deck. The goal is to put all cards as real families on the foundation.

In the playing piles you can build sequences. In general you don't have to care about the suits of the cards, but sequences can only be moved if they are part of a real sequence. For example, you can move the six of spades if the five of spades is on top of it, but may not move it if the five of clubs is on top of it.

The cards can only be moved to the foundation if all 13 cards of one family lay on top of each other in the playing piles.

##### Suggestion

You should try as soon as possible to move the cards to the correct piles, to create free piles to place cards on temporarily, since you can put any card on those.

With enough free room you can build families on free slots independently of the color. If you have all cards in such families you can sort them by color, so they can be moved to the foundation.

#### Yukon

Yukon is played with one card deck. The goal is to put all cards as real families ascending on the foundation.

The sequences on the playing piles have to be descending with alternating red and black cards. You can move every face up card no matter how many cards are on top of it. So you can put a five of hearts on a six of spades if that one is on top of its pile.

In a free slot you can put a king of any color (again, no matter how many cards are on top of it).

#### Grandfather's Clock

Grandfather's clock is a simple patience game. With some experience you should be able to solve most deals. It is played with one card deck. The aim is to put the cards as real ascending sequences on the foundation.

The foundation is on the right-hand side and consists of 12 piles that form the shape of a clock. The ace is at one o'clock, the jack is at 11 o'clock, and the queen is at 12 o'clock.

There are 8 playing piles beside the clock and on each are 5 cards. On the playing piles you can build descending sequences. The color of the cards is not important. You can only move one card at a time.

The auto drop feature is disabled in this patience game.

#### Golf

Golf is played with one card deck. The goal of Golf is to move all the cards on the tableau to the foundation.

The layout of golf solitaire is straightforward. At the beginning of the game you will see the tableau. On it are seven columns each containing five cards. The talon and the foundation are below.

Playing golf solitaire is simple, but requires strategy to win. The cards at the base of each column on the tableau are available for play. Available cards are built upon the top foundation card in ascending or descending sequence regardless of suit. If there are no moves available a card may be dealt from the talon to the foundation. The game is over when all the cards in the talon have been dealt and there are no more possible moves.

#### Spider

Spider is played with two card decks. The cards are dealt out into 10 playing piles, 4 of 6 cards and 6 of 5 cards each. This leaves 50 cards that can be dealt out 10 at a time, one on each playing pile.

In the playing piles, a card can be placed on another card of any suit and of one higher value. A sequence of ascending cards of the same suit may be moved from one playing pile to another.

The goal of spider is to put all cards as real families descending from Kings anywhere in the playing piles. When such a family is built in a playing pile, it is removed to the lower-left corner of the window.

The different levels determine how many suits are dealt - Easy uses 1 suit, Medium uses 2 suits, and Hard uses all 4 suits. The game is fairly easy to win at Easy level, and very difficult to win at Hard level.

## Interface Overview

### The Game Menu

&Ctrl;N Game New

  Starts a new game.

&Ctrl;O Game Load...

  Loads a saved game.

Game Load Recent List of recently accessed files.

  List all recently accessed save files.

F5 Game Restart Game

  Restart the current game.

&Ctrl;S Game Save

  Save the current game as a default save file.

Game Choose Game...

  Opens the game selection dialog.

Game Statistics

  Opens the game win/lose statistics dialog.

H Game Hint

  Show a hint.

D Game Demo

  Switch on/off the demo mode.

&Ctrl;Q Game Quit

  Quit &kappname;.

### The Move Menu

&Ctrl;Z Move Undo

  Undo your last move.

### The Settings Menu

Settings Game Type Klondike

  Switch to Klondike game mode.

Settings Game Type Grandfather

  Switch to Grandfather game mode.

Settings Game Type Aces Up

  Switch to Aces Up game mode.

Settings Game Type Freecell

  Switch to Freecell game mode.

Settings Game Type Mod3

  Switch to Mod3 game mode.

Settings Game Type Gypsy

  Switch to Gypsy game mode.

Settings Game Type Forty and Eight

  Switch to Forty and Eight game mode.

Settings Game Type Simple Simon

  Switch to Simple Simon game mode.

Settings Game Type Yukon

  Switch to Yukon game mode.

Settings Game Type Grandfather's Clock

  Switch to Grandfather's Clock game mode.

Settings Game Type Golf

  Switch to Golf game mode.

Settings Game Type Klondike (draw 3)

  Switch to Klondike (draw 3) game mode.

Settings Game Type Spider (Easy)

  Switch to Spider (Easy) game mode.

Settings Game Type Spider (Medium)

  Switch to Spider (Medium) game mode.

Settings Game Type Spider (Hard)

  Switch to Spider (Hard) game mode.

Settings Disable Autodrop

  Enable/Disable automatically moving matching cards.

F9 Settings Random Cards

  Randomly pick card faces and backs.

F10 Settings Select Deck...

  Open the card deck selection dialog.

Settings Show Toolbar

  Shows or hides the Toolbar.

### The Help Menu

&help.menu.documentation;

## Frequently asked questions

Who made this game?

The kdegames team. You can find their website here.

Where can I get cheatcodes?

You cannot get cheatcodes for &kde; games.

How do I start a new game?

To start a new game use &Ctrl;N Game New on the menubar.

How do I restart a my current game?

To restart a current game use F5 Game Restart Game on the menubar.

How do I pause the game?

&kappname; features no 'Pause' function at the moment.

I want to change the way this game looks. Can I?

You can change the faces and backs of the playing cards. To do so please use F10 Settings Select Deck... on the menubar.

I have made a mistake. Can I undo?

Yes. To undo a wrong move you can use &Ctrl;Z Move Undo on the menubar.

Can I use keyboard?

No. &kappname; features no possible keyboard play.

I cannot figure out what to do here! Are there hints?

Yes. To take advantage of the 'Hint' feature use H Game Hint on the menubar.

Even with hints I still have no clue how to play. Help!

Besides the 'Hint' feature there also is a useful 'Demo' mode, where the built in artificial intelligence will play the game for you. You can try to watch and learn. However, if you have any questions it is better to read How to Play and Game Rules, Strategies and Tips sections of this handbook.

I have to quit the game now, but I am not finished yet. Can I save my progress?

Yes. To save your progress you can use &Ctrl;S Game Save on the menubar.

Where are the high scores?

&kappname; has no high score board. However you can view your win vs lose statistics. To do so use Game Statistics on the menubar.

I want to change the game configuration. Where do I go?

&kappname; requires no configuration.

## Credits and License

&kappname;

&kpatience; Copyright © 1995-2000 &Paul-Olav.Tvete;

&kpatience; Copyright © 2001-2007 &Stephan.Kulow; &Stephan.Kulow.mail;

Freecell Solver by Shlomi Fish shlomif@vipe.technion.ac.il

Documentation Copyright © 2000 &Paul-Olav.Tvete;

Documentation updated for &kde; 2.0 by &Mike.McBride; &Mike.McBride.mail;

Documentation rewritten for &kpatience; 2.0 (&kde; 2.1) by &Maren.Pakura; &Maren.Pakura.mail;

Documentation proofread and update for &kpatience; &docversion; by &Richard.Hawthorne; &Richard.Hawthorne.mail;

&underFDL; &underGPL;

## Installation

&install.intro.documentation;

### Compilation and Installation

&install.compile.documentation;

&documentation.index;