This User Documentation gives an overview of how to install, run and play the Hearts game and how you can customize it to your personal preferences. It is still in the process of being written and some of the features described in here may not be implemented yet. If you feel like contributing you'll probabely want to read the Developer Guidelines.
We do not create binray releases ourselves. However, various Linux distributions have created binary packages for gnome-hearts, such as Debian, Ubuntu, Foresight Linux (rPath) and others. In addition to that, we have built some unofficial binary packages for Ubuntu Dapper Drake. You can find those packages on the download page.
If you want to compile gnome-hearts from source, you will need to have the following packages installed on your system:
Download the tar.gz package for the latest release from the download page and extract it somewhere convenient.
Then you must configure, make and install the package. If you have all the requirements installed then on most systems you can simply do:
If you want Gnome Hearts to use the card styles you have installed for the gnome-games package then you need to set the same --prefix on configure as gnome-games is installed with. On most systems this is:
Gnome Hearts is a trick-taking game played with four players. The object of the game is to gain as few point cards as possible, with the point cards usually being all the hearts and the Queen of spades (see Chapter 4.1: Rules for detailed information). As soon as one player reaches a set number of points (usually 100) the game is over and the player with the lowest score is declared the winner.
The game is played with four players with you being the south player. Each round starts with selecting three cards that you wish to pass to another player. In the first round the cards are passed to the left, in the second round across the table, in the third round to the right, in the fourth round no cards are passed, after which the sequence repeats. You can (de)select cards in your hand by clicking on them. When you have selected three cards, click on the player you should pass them to.
After the passing stage one player (usually the one that has been dealt the two of clubs) opens the trick. Each player must play a card that matches the suit of the first card played on the trick. If they have no more cards of that suit then they are free to play any card. After all four players have played a card, the trick goes to the player with the highest card who's suit matches the opening suit. The trick-taker then opens the next trick. When all cards have been player, each player is given a score depending on the cards that they have taken in their tricks. When one player reaches 100 points the game is over and the player with the lowest score is declared the winner.
There are two ways to lower your score. You can try to “shoot the moon”. That is, to take all the hearts cards and the Queen of spades. A risky strategy because if you manage to get all but one, you will get a high number of points. The second way is called “shooting the sun“ and involves not only taking all the hearts, but all the cards in the game.
This section allows you to set and tweak various game rules. The ruleset is a basic package of rules for the hearts game. On top of that you can set some “gentleman's rules”. Hearts currently has four rulesets, but more rulesets are planned.
Here you can select which opponents you wish to play agaist. If you want the computer to pick for you, choose <random> from the list. It is very easy to add new opponents or share modified opponents with other Hearts players. All opponents are implemented in separate Python scripts. Python is a powerfull scripting laguage used in all kinds on applications. You can simply copy new Python scripts into the /scripts/players directory and the new players become available in this menu. For more information about creating and editing Hearts opponents with Python, see the Developer Guidelines Chapter 4.2: The player scripts. Note: The <random> function has not been implemented yet.
On this tab you can set a background image and choose a card set. Note that some of the card styles that come with the gnome-games package are Scalable Vector Graphics files (SVG) and can be slow to load.