TwentyOne

A simple command-line implementation of 21, better known as blackjack.

Installation

Just install the gem:

$ gem install twenty_one

Usage

To start a new game. Simply execute:

$ 21

Tests

Testing was done with rspec. If the you cloned the project run tests with:

$ rspec

Game Rules

Terms

• "blackjack" is a hand worth 21
• "bust" is a loss
• "push" is a tie between the player's hand and the dealer's hand
• "shoe" is a stack of decks mixed together
• "hit" drawing a single card from the shoe
• "stand" ending a turn
• "hole" the card that the dealer keeps hidden
• "hand" the cards a player poses
• "showdown" when the player's hand is pitted against the player's hand

Goal

The goal of the game is to draw a hand with a value greater than the dealer's as long as it is not greater than 21.

Phases

1. Bet
   • The player will state the amount (in dollars) they want to bet
2. Deal cards
   • The player and the dealer are each hit with two cards
   • The dealer's second card will be the hole
3. Player turn
   • Player can choose to hit
   • Player ends with a stand
   • A hand exceeding 21 is an automatic bust
4. Dealer turn
   • The dealer reveals the hole card
   • The dealer will hit if their hand is worth less than 21
   • If the dealer busts and the player did not bust, the player wins
     • Otherwise, it is a push
5. Showdown
   • If the player has a hand worth more than the dealer, the player wins.
     • Otherwise, the dealer wins

Cards

• 52 cards are represented
• Regular cards are valued at whatever number they hold
• Face cards are worth 10
• Ace cards are worth 1 or 11
  • Players can choose whichever they like
  • Dealers must choose whichever is appropriate to surpass 17
• A player can choose to hit when it is their turn
  • If a hit causes a hand higher than 21, the player automatically busts
• A player can choose to stand when it is their turn

Chips

• White chips are worth $1
• Red chips are worth $5
• Green chips are worth $25
• Black chips are worth $100

Player

• A player will start with 100 total chips
  • 50 white chips
  • 25 red chips
  • 15 green chips
  • 10 black chips
• Bets will be filled sequentially from highest value chips to lowest
• A regular win will give the player double what theu bet in chips
• A blackjack will win the player 2.5 times what they bet in chips
• A bust means the player will not get back their chips

Dealer

• A dealer's hand must be no less than 17
  • If the hand is worth less than 17, the dealer must hit until it is 17 or greater
• If a dealer busts and the player has not, then player wins the round

Planned Features

• Side rules
• Multiple players
• An option to play as the dealer
• Saving player stats to a local SQLite database
• Socket-based multiplayer

Contributing

1. Fork it ( https://github.com/pori/twenty_one/fork )
2. Create your feature branch (git checkout -b my-new-feature)
3. Commit your changes (git commit -am 'Add some feature')
4. Push to the branch (git push origin my-new-feature)
5. Create a new Pull Request