wcg.games.hearts

Class HeartsGameMaster

java.lang.Object

wcg.games.ObservableGame

wcg.games.GameMaster

wcg.games.hearts.HeartsGameMaster

public class HeartsGameMaster
extends GameMaster

Game master for the game of HEARTS. This game with the following rules:

• game for 4 players;
• each player receives 13 cards;
• first player to join the game starts the first trick (round);
• first player in a turn plays any card, but not hearts in the first 2 tricks;
• other players follow suit;
• player with highest card of that suit collects all cards on the table;
• each heart add a negative point to the player's score;
• at the end, the player with less negative points wins.

Author:

José Paulo Leal jpleal@fc.up.pt

Field Summary

Fields

Modifier and Type	Field and Description
(package private) int	countHeartsInTurn
(package private) java.lang.String	holdTurn

Constructor Summary

Constructors

Constructor and Description
HeartsGameMaster()

Method Summary

Modifier and Type	Method and Description
protected void	beforeRoundConclusion() Check the cards played by each player.
protected void	checkCards(java.lang.String nick, java.util.List<Card> cards) In HEARTS the player must play a single card per turn.
protected GamePlayingStrategy	getCardGameStrategy() Produce a game strategy for this game instance.
protected int	getCardsPerPlayer() All players get 1/4 of the deck cards.
protected java.lang.String	getGameName() Name of this game in capitals, as in GameFactory.
protected int	getNumberOfPlayers() The number of players in HEARTS is 4.
protected int	getRoundPoints(java.lang.String nick) Report the points of given player, as computed in beforeRoundConclusion().
protected java.lang.String	getWinner() The winner is the player with most points (less negative points).
protected boolean	hasEnded() The game ends after 13 rounds.
protected java.lang.String	initialTurnInRound() The player that played the highest card from the suit to follow start the next round, as computed in beforeRoundConclusion().
protected boolean	isWithTurns() HEARTS is a played in turns.
protected void	startGame() No preparation is needed for HEARTS

Methods inherited from class wcg.games.GameMaster

acceptsPlayers, addPlayer, expired, getCardComparator, getCardOnTable, getCardsOnTable, getDeck, getExpirationtime, getGameId, getHand, getInfo, getMode, getNickWithTurn, getPlayerNicks, getRoundsCompleted, getSuitToFollow, newCardCollection, nickWithMostPoints, playCard, playCards, sendCards, setExpirationtime, setMode

Methods inherited from class wcg.games.ObservableGame

addObserver, broadcast, broadcast, broadcast, notify

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

holdTurn

java.lang.String holdTurn

countHeartsInTurn

int countHeartsInTurn

Constructor Detail

HeartsGameMaster

public HeartsGameMaster()

Method Detail

getGameName

protected java.lang.String getGameName()

Name of this game in capitals, as in GameFactory.

Specified by:

getGameName in class GameMaster

Returns:

name of game.

getNumberOfPlayers

protected int getNumberOfPlayers()

The number of players in HEARTS is 4.

Specified by:

getNumberOfPlayers in class GameMaster

Returns:

number of players.

getCardsPerPlayer

protected int getCardsPerPlayer()

All players get 1/4 of the deck cards.

Specified by:

getCardsPerPlayer in class GameMaster

Returns:

number of cards.

isWithTurns

protected boolean isWithTurns()

HEARTS is a played in turns.

Specified by:

isWithTurns in class GameMaster

Returns:

true if game is with turns; false otherwise.

startGame

protected void startGame()

No preparation is needed for HEARTS

Specified by:

startGame in class GameMaster

checkCards

protected void checkCards(java.lang.String nick,
                          java.util.List<Card> cards)
                   throws CardGameException

In HEARTS the player must play a single card per turn. In the first 2 turns the card cannot be HEARTS, unless the player has not other option to play (improbable). If the player is to the first in round then can choose cards from any suit (unless its the first 2 rounds); otherwise, the player has to follow the suit of the first player, unless she/he/it doesn't have cards from that suit.

Specified by:

checkCards in class GameMaster

Parameters:

nick - of player.

cards - to check.

Throws:

CardGameException - if a rule was violated.

beforeRoundConclusion

protected void beforeRoundConclusion()

Check the cards played by each player.

Specified by:

beforeRoundConclusion in class GameMaster

getRoundPoints

protected int getRoundPoints(java.lang.String nick)

Report the points of given player, as computed in beforeRoundConclusion(). Hearts count as negative points

Specified by:

getRoundPoints in class GameMaster

Parameters:

nick - of player.

Returns:

points in round.

initialTurnInRound

protected java.lang.String initialTurnInRound()

The player that played the highest card from the suit to follow start the next round, as computed in beforeRoundConclusion().

Specified by:

initialTurnInRound in class GameMaster

Returns:

nick of first player in round

hasEnded

protected boolean hasEnded()

The game ends after 13 rounds.

Specified by:

hasEnded in class GameMaster

Returns:

true if game ended; false otherwise.

getWinner

protected java.lang.String getWinner()

The winner is the player with most points (less negative points).

Specified by:

getWinner in class GameMaster

Returns:

nick of winner

getCardGameStrategy

protected GamePlayingStrategy getCardGameStrategy()

Produce a game strategy for this game instance. Alternates between HeartsGameSimpleStrategy and HeartsGameStrategy.

Specified by:

getCardGameStrategy in class GameMaster

Returns:

automatic player.