README.md

CLI BlackJack Game

Welcome to the CLI Blackjack Game, a command-line interface implementation of the classic casino game Blackjack. This project allows you to play Blackjack against the computer in your terminal.

Table of Contents

• Features
• Installation
• Usage
• Rules
• Contributing

Features

• Play classic Blackjack against the computer.
• Simple and intuitive command-line interface.

Installation

Prerequisites

• Java Development Kit (JDK) 17 or higher

Steps

1. Clone the repository:

git clone https://github.com/yourusername/BlackJack-Game.git

2. Navigate to the project directory:

cd BlackJack-Game

3. Compile the Java files:

javac -d bin src/com/yourusername/blackjack/*.java

Usage

Run the game using the following command:

java -cp bin com.yourusername.blackjack.Blackjack

Commands

• 'hit' - Draw another card.

• 'stay' - End your turn.

• 'insurance' - Take insurance if the dealer shows an Ace.

  To do

  • 'double' - Double your bet, draw one more card, and end your turn.
  • 'split' - Split your hand into two hands (if you have a pair).

Rules

The objective of Blackjack is to beat the dealer by having a hand value closer to 21 without exceeding it.
Here are some key rules:

• Card Values: Number cards are worth their face value, face cards (King, Queen, Jack) are worth 10, and Aces can be worth 1 or 11.
• Gameplay:
  • Each player is dealt two cards, face up. The dealer is dealt two cards, with one face up and one face down.
  • Players must decide to hit, stand, double, or split.
  • The dealer reveals the hidden card and must hit until their cards total 17 or higher.
• Winning:
  • If your hand is closer to 21 than the dealer’s hand, you win.
  • If your hand exceeds 21, you bust and lose the bet.
  • If the dealer busts, you win.
  • If you and the dealer have the same total, it's a push (tie).

For a complete set of rules, please refer to the BlackJack Rules.

Contributing

We welcome contributions to this project!
To contribute:

1. Fork the repository.
2. Create a new branch:

git checkout -b feature-name

3. Make your changes and commit them:

git commit -m "Description of your feature"

4. Push to the branch:

git push origin feature-name

5. Open a pull request detailing your changes.

Please ensure your code follows our Code of Conduct and adheres to the contribution guidelines.

Screenshots

Home Screen

Playing the game

Getting BlackJack (Exactly 21)

Busted (Going over 21)

Winning