Blackjack Game with Decision Assistant

A terminal-based Blackjack game with a built-in decision assistant that recommends the statistically best move to the user during every turn.

Run the Application Using Docker

Execute the following command in your terminal:

• docker run -it georgedinicola/blackjack-game:v0.0.0

How to play Blackjack:

The objective of the game is to beat the dealer. To beat the dealer, the sum of the cards in your hand will need to be greater than the sum of the cards in the dealer's hand, without being over 21. If you reach a sum over 21, you lose. If the dealer reaches a sum over 21 (and you have not), then you win.

For more information about how to play Blackjack: https://bicyclecards.com/how-to-play/blackjack/
Note: This game does NOT allow the player to purchase insurance.

How to play in the terminal

• The game initializes with the player having $100 to spend betting on the game.
• The game will begin by asking for a wager. You may choose to wager $1, $5, $10, or $20 (when you type these, do NOT type the dollar sign).
• If the first two cards you receive have an equal rank (ex: "Q" and "Q"), then you will be asked if you would like to split. Inputting the letter "Y" will allow you to split and from then on you will play using two hands. In addition your wager will double since the newly dealt hand will need to match the wager you initially made. If you choose "N" to indicate no, then the game will go on as normal (using one hand). You may only split once during the game.
• If the first two cards you receive are not equal in rank, then you will be asked if you would like to Hit (H), Stand (S), or Double Down (D). Above the prompt, the game's decision assistant will suggest the best choice to make based on probablitiy of winning (i.e. "The recommended strategy is to: ").
• If you choose to Double Down (D), your wager will double and you will receive only one more card to your hand.
• Your turn will continue until you choose to Stand (S) or you bust (your card sum reaches over 21 and you lose).
• If your turn ends without going over 21, the dealer will then play. As per casino rules, the dealer must hit whenever he or she has under 17 and may not hit on any hand valued at 17 or more.
• After the dealer's turn, you will either be paid out your winnings (which will be added to "Funds"), or your wager will be forfeited to the dealer.
• Note: If you receive Blackjack (an Ace card and a card with a value of 10), you will automatically win and your wager will be paid out 3:1.