GamePlayer

GamePlayer declares some common functions:

• public void NewGame ();

  This function is called to inform the player that a new game is about to start.

• public String EndGame (int nResult);

  This function is called when a game has ended. The parameter nResult tells the outcome of the game:

  • GamePlayer.RESULT_WON Recieving player won game. Congratulations!
  • GamePlayer.RESULT_LOST Recieving player lost game.
  • GamePlayer.RESULT_ABORTED Game was aborted by user.
  • GamePlayer.RESULT_OTHER_PLAYER_MISBEHAVED Another player disobeyed the rules or threw an exception, the game was cancelled and the culprit was removed from tournament if tournament in progress.
  • GamePlayer.RESULT_YOU_MISBEHAVED Recieving player has disobeyed the rules or thrown an exception, the game has been cancelled and the recieving player has been removed from tournament if tournament in progress.

  Note: There is a possibility that NewGame is called twice, without any game played or EndGame called in between, if for example a player causes an exception during NewGame.

• Noughts & Crosses - GamePlayerNoughtsNCrosses
• Chinese Checkers - GamePlayerChineseCheckers
• Fox & Sheep - GamePlayerFoxNSheep

• public [game_name]Move GetMove ([game_name]State state);

  This function is called whenever a player is to make a move. The state parameter contain all necessary information about the game, and the caller expects an legal move to be returned. The return type is a subclass of CommentMove.

Note: All implementations should take into account that multiple instances of a player are created when it's playing against itself.