com.fossgalaxy.games.fireworks.ai.hat

Class HatGuessing

java.lang.Object

com.fossgalaxy.games.fireworks.ai.hat.HatGuessing

All Implemented Interfaces:

Agent

public class HatGuessing
extends Object
implements Agent

Created by piers on 11/11/16.

Constructor Summary

Constructors

Constructor and Description
HatGuessing()

Method Summary

Modifier and Type	Method and Description
void	applyEffect(GameState state, GameEvent event)
Action	doMove(int agentID, GameState state) Standardised interface for game playing agents.
Recommendation	doRecommend(int agentID, GameState state) Playable: a card that can be successfully played with the current game state.
int	getEncodedValue(int whoTold, int toldWho) Helper method to understand the hint system
int	getMissingPiece(GameState state, int whoTold, int treasureChest)
int	getRecommendationForAHand(int agentToTell, GameState state) Gets the integer recommendation for the Hat Guessing algorithm for a single hand
boolean	isDead(GameState state, Card card) Is the card dead by the Hat Guessing definition
boolean	isIndispensable(GameState state, Card card) places a card can be: 1) in the deck (still in deck or our hand) 2) in the discard pile (played incorrectly or discarded cards) 3) on the table (card is no longer needed, a copy was played successfully) 4) another player's hand (our copy is not the only one)
boolean	isPlayable(GameState state, Card card) Is the card playable by the Hat Guessing definition
void	receiveID(int agentID) optional hook for when the agent gets their ID.
String	toString()

Methods inherited from class java.lang.Object

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

Constructor Detail

HatGuessing

public HatGuessing()

Method Detail

doMove

public Action doMove(int agentID,
                     GameState state)

Description copied from interface: Agent

Standardised interface for game playing agents.

The agent gets a copy of the game state and it's agent ID and should return a move.

Specified by:

doMove in interface Agent

Parameters:

agentID - the ID of this agent

state - the current state of the game

Returns:

the move this agent would like to make

isDead

public boolean isDead(GameState state,
                      Card card)

Is the card dead by the Hat Guessing definition

Parameters:

state - The current state

card - The card we are interested in

Returns:

boolean indicating the deadness of the card

isPlayable

public boolean isPlayable(GameState state,
                          Card card)

Is the card playable by the Hat Guessing definition

Parameters:

state - The current state

card - The card we are interested in

Returns:

boolean indicating the playableness of the card

isIndispensable

public boolean isIndispensable(GameState state,
                               Card card)

places a card can be: 1) in the deck (still in deck or our hand) 2) in the discard pile (played incorrectly or discarded cards) 3) on the table (card is no longer needed, a copy was played successfully) 4) another player's hand (our copy is not the only one)

Parameters:

state - The current state

card - The card we are interested in

Returns:

boolean indicating if the card is indispensable

getRecommendationForAHand

public int getRecommendationForAHand(int agentToTell,
                                     GameState state)

Gets the integer recommendation for the Hat Guessing algorithm for a single hand

Used to both calculate the encoding and decoding of a hint.

Parameters:

agentToTell - The agent to calculate the hint for

state - The current game state

Returns:

The value to tell between 0-7

doRecommend

public Recommendation doRecommend(int agentID,
                                  GameState state)

Playable: a card that can be successfully played with the current game state.

Dead: a card that has the same rank and suit of a successfully played card.

Indispensable: a card for which all other identical copies have been removed from the game, i.e. a card that if removed from the game will imply a perfect score cannot be obtained.

Parameters:

agentID -

state -

Returns:

receiveID

public void receiveID(int agentID)

Description copied from interface: Agent

optional hook for when the agent gets their ID.

This indicates that the game has started.

Specified by:

receiveID in interface Agent

Parameters:

agentID - this agent's ID.

getMissingPiece

public int getMissingPiece(GameState state,
                           int whoTold,
                           int treasureChest)

applyEffect

public void applyEffect(GameState state,
                        GameEvent event)

getEncodedValue

public int getEncodedValue(int whoTold,
                           int toldWho)

Helper method to understand the hint system

Parameters:

whoTold - Who told the hint

toldWho - Who the hint was told to

Returns:

The value

toString

public String toString()

Overrides:

toString in class Object