Cribbage overview

Cribbage Overview:

  Basic familiarity with the rules and gameplay of cribbage is assumed.

  Muggins rules are not implemented.

  For detailed rule and scoring information please see
  http://www.cribbage.org/rules/

  Gameplay:
    Once both players have used the 'cribbage start' command the game
    will begin.  There are two optional arguments to 'cribbage start',
    'auto' and 'short'.  The 'short' option will cause the game to be
    played to 61 points rather than the default 121, and only has an
    effect when it is specified by the first player to start the game.
    If 'short' is specified by the second player, it will be ignored.
    The 'auto' option, which may be specified in addition to the
    'short' option will cause the specifying player's hand to be
    automatically scored.  Either player may select automatic scoring
    without affecting the other player's scoring method.

    After a dealer has been selected and the cards are dealt, each
    player must discard two cards to the crib hand.  Cards are
    discarded one at a time using the command 'cribbage discard' with
    the name of the card as it appears in your hand.  Once a card has
    been discarded, it cannot be brought back into the hand.  A starter
    will be automatically chosen after both players have completed
    their discards.

    Cards are played by using the 'cribbage play' command followed by
    the name of the card as it appears in the hand.  Any points gained
    during play will be automatically scored by the game.

    Once play has been finished each hand will be displayed in turn.
    If manual scoring has been selected, the game will wait for the
    player to score their hand using the 'cribbage peg' command.  The
    game will notify the player if the claimed score is over or under
    the actual value of the hand.  If the claimed value is less than
    the actual worth of the hand, only the claimed value will be scored.
    Claiming a score for the hand that is greater than the real score
    for the hand will result in two points awarded to the opposing
    player's score, and only the actual value of the hand will be
    scored.  (Note: the game will interpret '19' as zero points.)
    If a player has chosen automatic scoring, their hand will
    be automatically scored at this point.

    After all hands have been scored, the cards will automatically be
    dealt for the next round.  The first player to 121 points, or 61
    points for a short game wins, regardless of the status of the game
    at the time.

    At any point in the game, either player may use the 'cribbage hand'
    command to see the contents of their hand or, during scoring, the
    contents of the hand that is currently being scored.  Looking at
    the board will give a visual representation of the score, as well
    as which cards have been played and the starter.

    Either player may forfeit the game with the 'cribbage stop' command
    at any point, and a user who is not part of the current game may
    also use this command to end the current game if both players are
    either absent or overly idle.